com.gargoylesoftware.htmlunit

Class HttpWebConnection

java.lang.Object

com.gargoylesoftware.htmlunit.HttpWebConnection

All Implemented Interfaces:

WebConnection, AutoCloseable

public class HttpWebConnection
extends Object
implements WebConnection

Default implementation of WebConnection, using the HttpClient library to perform HTTP requests.

Author:

Mike Bowler, Noboru Sinohara, David D. Kilzer, Marc Guillemot, Brad Clarke, Ahmed Ashour, Nicolas Belisle, Ronald Brill, John J Murdoch, Carsten Steul, Hartmut Arlt

Constructor Summary

Constructors

Constructor and Description
HttpWebConnection(WebClient webClient) Creates a new HTTP web connection instance.

Method Summary

Modifier and Type	Method and Description
void	close()
protected HttpClientBuilder	createHttpClientBuilder() Creates the HttpClientBuilder that will be used by this WebClient.
static DownloadedContent	downloadContent(InputStream is, int maxInMemory) Reads the content of the stream and saves it in memory or on the file system.
protected DownloadedContent	downloadResponseBody(org.apache.http.HttpResponse httpResponse) Downloads the response body.
protected HttpClientBuilder	getHttpClientBuilder() Lazily initializes the internal HTTP client.
WebResponse	getResponse(WebRequest webRequest) Submits a request and retrieves a response.
protected int	getTimeout(WebRequest webRequest) Returns the timeout to use for socket and connection timeouts for HttpConnectionManager.
String	getVirtualHost() Gets the virtual host.
protected WebResponse	newWebResponseInstance(WebResponseData responseData, long loadTime, WebRequest webRequest) Constructs an appropriate WebResponse.
protected void	onResponseGenerated(HttpUriRequest httpMethod) Called when the response has been generated.
void	setVirtualHost(String virtualHost) Sets the virtual host.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HttpWebConnection

public HttpWebConnection(WebClient webClient)

Creates a new HTTP web connection instance.

Parameters:

webClient - the WebClient that is using this connection

Method Detail

getResponse

public WebResponse getResponse(WebRequest webRequest)
                        throws IOException

Submits a request and retrieves a response.

Specified by:

getResponse in interface WebConnection

Parameters:

webRequest - the request

Returns:

the response to the request defined by the specified request

Throws:

IOException - if an IO error occurs

onResponseGenerated

protected void onResponseGenerated(HttpUriRequest httpMethod)

Called when the response has been generated. Default action is to release the HttpMethod's connection. Subclasses may override.

Parameters:

httpMethod - the httpMethod used (can be null)

getHttpClientBuilder

protected HttpClientBuilder getHttpClientBuilder()

Lazily initializes the internal HTTP client.

Returns:

the initialized HTTP client

getTimeout

protected int getTimeout(WebRequest webRequest)

Returns the timeout to use for socket and connection timeouts for HttpConnectionManager. Is overridden to 0 by StreamingWebConnection which keeps reading after a timeout and must have long running connections explicitly terminated.

Parameters:

webRequest - the request might have his own timeout

Returns:

the WebClient's timeout

createHttpClientBuilder

protected HttpClientBuilder createHttpClientBuilder()

Creates the HttpClientBuilder that will be used by this WebClient. Extensions may override this method in order to create a customized HttpClientBuilder instance (e.g. with a custom ClientConnectionManager to perform some tracking; see feature request 1438216).

Returns:

the HttpClientBuilder that will be used by this WebConnection

setVirtualHost

public void setVirtualHost(String virtualHost)

Sets the virtual host.

Parameters:

virtualHost - the virtualHost to set

getVirtualHost

public String getVirtualHost()

Gets the virtual host.

Returns:

virtualHost The current virtualHost

downloadResponseBody

protected DownloadedContent downloadResponseBody(org.apache.http.HttpResponse httpResponse)
                                          throws IOException

Downloads the response body.

Parameters:

httpResponse - the web server's response

Returns:

a wrapper for the downloaded body.

Throws:

IOException - in case of problem reading/saving the body

downloadContent

public static DownloadedContent downloadContent(InputStream is,
                                                int maxInMemory)
                                         throws IOException

Reads the content of the stream and saves it in memory or on the file system.

Parameters:

is - the stream to read

maxInMemory - the maximumBytes to store in memory, after which save to a local file

Returns:

a wrapper around the downloaded content

Throws:

IOException - in case of read issues

newWebResponseInstance

protected WebResponse newWebResponseInstance(WebResponseData responseData,
                                             long loadTime,
                                             WebRequest webRequest)

Constructs an appropriate WebResponse. May be overridden by subclasses to return a specialized WebResponse.

Parameters:

responseData - Data that was send back

webRequest - the request used to get this response

loadTime - How long the response took to be sent

Returns:

the new WebResponse

close

public void close()

Specified by:

close in interface WebConnection

Specified by:

close in interface AutoCloseable