gecko/mobile/android/base/sync/net/ResourceDelegate.java
2012-05-21 12:12:37 +01:00

49 lines
1.6 KiB
Java

/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
package org.mozilla.gecko.sync.net;
import java.io.IOException;
import java.security.GeneralSecurityException;
import ch.boye.httpclientandroidlib.HttpResponse;
import ch.boye.httpclientandroidlib.client.ClientProtocolException;
import ch.boye.httpclientandroidlib.client.methods.HttpRequestBase;
import ch.boye.httpclientandroidlib.impl.client.DefaultHttpClient;
/**
* ResourceDelegate implementers must ensure that HTTP responses
* are fully consumed to ensure that connections are returned to
* the pool:
*
* EntityUtils.consume(entity);
* @author rnewman
*
*/
public interface ResourceDelegate {
// Request augmentation.
String getCredentials();
void addHeaders(HttpRequestBase request, DefaultHttpClient client);
// Response handling.
/**
* Override this to handle an HttpResponse.
*
* ResourceDelegate implementers <b>must</b> ensure that HTTP responses are
* fully consumed to ensure that connections are returned to the pool, for
* example by calling <code>EntityUtils.consume(response.getEntity())</code>.
*/
void handleHttpResponse(HttpResponse response);
void handleHttpProtocolException(ClientProtocolException e);
void handleHttpIOException(IOException e);
// During preparation.
void handleTransportException(GeneralSecurityException e);
// Connection parameters.
int connectionTimeout();
int socketTimeout();
}