public abstract class HttpClientBase extends Object implements Closeable
Modifier and Type | Field and Description |
---|---|
static int |
DEFAULT_CONNECTION_TIMEOUT
Default connection timeout for this client, in milliseconds.
|
static int |
DEFAULT_SO_TIMEOUT
Default socket timeout for this client, in milliseconds.
|
protected String |
url
The URL stting to execute requests against.
|
Modifier | Constructor and Description |
---|---|
protected |
HttpClientBase(String host,
int port,
String path,
org.apache.http.conn.HttpClientConnectionManager conMgr,
org.apache.http.client.config.RequestConfig defaultConfig) |
Modifier and Type | Method and Description |
---|---|
void |
close() |
protected <T> T |
doAction(org.apache.http.HttpResponse response,
boolean consume,
Callable<T> call)
Do a specific action and validate after the action that the status is still OK,
and if not, attempt to extract the actual server side exception.
|
protected <T> T |
doAction(org.apache.http.HttpResponse response,
Callable<T> call)
Same as
doAction(HttpResponse, boolean, Callable) but always do consume at the end. |
protected void |
ensureOpen()
Throws
AlreadyClosedException if this client is already closed. |
protected org.apache.http.HttpResponse |
executeGET(String request,
String... params)
internal: execute a request and return its result
The
params argument is treated as: name1,value1,name2,value2,... |
protected org.apache.http.HttpResponse |
executePOST(String request,
org.apache.http.HttpEntity entity,
String... params)
internal: execute a request and return its result
The
params argument is treated as: name1,value1,name2,value2,... |
protected boolean |
isClosed()
Returns true iff this instance was
closed , otherwise
returns false. |
InputStream |
responseInputStream(org.apache.http.HttpResponse response)
Internal utility: input stream of the provided response
|
InputStream |
responseInputStream(org.apache.http.HttpResponse response,
boolean consume)
Internal utility: input stream of the provided response, which optionally
consumes the response's resources when the input stream is exhausted.
|
protected void |
throwKnownError(org.apache.http.HttpResponse response,
org.apache.http.StatusLine statusLine) |
protected void |
verifyStatus(org.apache.http.HttpResponse response)
Internal: response status after invocation, and in case or error attempt to read the
exception sent by the server.
|
public static final int DEFAULT_CONNECTION_TIMEOUT
public static final int DEFAULT_SO_TIMEOUT
protected final String url
protected HttpClientBase(String host, int port, String path, org.apache.http.conn.HttpClientConnectionManager conMgr, org.apache.http.client.config.RequestConfig defaultConfig)
conMgr
- connection manager to use for this http client. NOTE:The
provided HttpClientConnectionManager
will not be
HttpClientConnectionManager.shutdown()
by this class.defaultConfig
- the default RequestConfig
to set on the client. If
null
a default config is created w/ the default connection
and socket timeouts.protected final void ensureOpen() throws AlreadyClosedException
AlreadyClosedException
if this client is already closed.AlreadyClosedException
protected void verifyStatus(org.apache.http.HttpResponse response) throws IOException
IOException
protected void throwKnownError(org.apache.http.HttpResponse response, org.apache.http.StatusLine statusLine) throws IOException
IOException
protected org.apache.http.HttpResponse executePOST(String request, org.apache.http.HttpEntity entity, String... params) throws IOException
params
argument is treated as: name1,value1,name2,value2,...IOException
protected org.apache.http.HttpResponse executeGET(String request, String... params) throws IOException
params
argument is treated as: name1,value1,name2,value2,...IOException
public InputStream responseInputStream(org.apache.http.HttpResponse response) throws IOException
IOException
public InputStream responseInputStream(org.apache.http.HttpResponse response, boolean consume) throws IOException
IOException
protected final boolean isClosed()
protected <T> T doAction(org.apache.http.HttpResponse response, Callable<T> call) throws IOException
doAction(HttpResponse, boolean, Callable)
but always do consume at the end.IOException
protected <T> T doAction(org.apache.http.HttpResponse response, boolean consume, Callable<T> call) throws IOException
consume
parameter.IOException
public void close() throws IOException
close
in interface Closeable
close
in interface AutoCloseable
IOException
Copyright © 2000-2018 Apache Software Foundation. All Rights Reserved.