public class HttpClientHelper extends HttpClientHelper
HttpUrlConnectionCall
. Here is the
list of parameters that are supported. They should be set in the Client's
context before it is started:
Parameter name | Value type | Default value | Description |
---|---|---|---|
allowUserInteraction | boolean | false | If true, this URL is being examined in a context in which it makes sense to allow user interactions such as popping up an authentication dialog. |
chunkLength | int | 0 (uses HttpURLConnection's default) | The chunk-length when using chunked encoding streaming mode for response entities. A value of -1 means chunked encoding is disabled for response entities. |
followRedirects | boolean | false | If true, the protocol will automatically follow redirects. If false, the protocol will not automatically follow redirects. |
readTimeout | int | 60000 | Sets the read timeout to a specified timeout, in milliseconds. A timeout of zero is interpreted as an infinite timeout. |
socketConnectTimeoutMs | int | 15000 | The socket connection timeout or 0 for unlimited wait. |
sslContextFactory | String | org.restlet.engine.ssl.DefaultSslContextFactory | Let you specify a SslContextFactory
qualified class name as a parameter, or an instance as an attribute for a
more complete and flexible SSL context setting. |
useCaches | boolean | false | If true, the protocol is allowed to use caching whenever it can. |
DefaultSslContextFactory
class.
It is also possible to specify a hostname verifier for HTTPS connections. See
the getHostnameVerifier()
method for details.
Note that by default, the HttpURLConnection
class as implemented by
Sun will retry a request if an IO exception is caught, for example due to a
connection reset by the server. This can be annoying, especially because the
HTTP semantics of non idempotent methods like POST can be broken, but also
because the new request won't include an entity. There is one way to disable
this behavior for POST requests only by setting the system property
"sun.net.http.retryPost" to "false".
Constructor and Description |
---|
HttpClientHelper(Client client)
Constructor.
|
Modifier and Type | Method and Description |
---|---|
ClientCall |
create(Request request)
Creates a low-level HTTP client call from a high-level uniform call.
|
int |
getChunkLength()
Returns the chunk-length when using chunked encoding streaming mode for
response entities.
|
javax.net.ssl.HostnameVerifier |
getHostnameVerifier()
Returns the hostname verifier by looking up the "hostnameVerifier"
attribute of the client's context.
|
int |
getReadTimeout()
Returns the read timeout value.
|
boolean |
isAllowUserInteraction()
Indicates if this URL is being examined in a context in which it makes
sense to allow user interactions such as popping up an authentication
dialog.
|
boolean |
isFollowRedirects()
Indicates if the protocol will automatically follow redirects.
|
boolean |
isUseCaches()
Indicates if the protocol is allowed to use caching whenever it can.
|
void |
start()
Start callback.
|
void |
stop()
Stop callback.
|
getAdapter, getSocketConnectTimeoutMs, handle, setAdapter
getConnectorService, getContext, getProtocols, update
getAttributes, getHelped, getHelpedParameters, getLogger, getMetadataService, setHelped
public HttpClientHelper(Client client)
client
- The client to help.public ClientCall create(Request request)
create
in class HttpClientHelper
request
- The high-level request.public int getChunkLength()
public javax.net.ssl.HostnameVerifier getHostnameVerifier()
public int getReadTimeout()
public boolean isAllowUserInteraction()
public boolean isFollowRedirects()
public boolean isUseCaches()
public void start() throws java.lang.Exception
RestletHelper
start
in class ConnectorHelper<Client>
java.lang.Exception
public void stop() throws java.lang.Exception
RestletHelper
stop
in class ConnectorHelper<Client>
java.lang.Exception
Copyright © 2005-2020 Restlet.