blob: 0dea9432b31fa0382fe4d31042f4c1102474a9c6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
/* 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.
AuthHeaderProvider getAuthHeaderProvider();
void addHeaders(HttpRequestBase request, DefaultHttpClient client);
/**
* The value of the User-Agent header to include with the request.
*
* @return User-Agent header value; null means do not set User-Agent header.
*/
public String getUserAgent();
// 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();
}
|