com.gargoylesoftware.htmlunit.util
Class WebConnectionWrapper

java.lang.Object
  com.gargoylesoftware.htmlunit.util.WebConnectionWrapper

All Implemented Interfaces:

WebConnection

Direct Known Subclasses:

DebuggingWebConnection, FalsifyingWebConnection

public class WebConnectionWrapper
extends Object
implements WebConnection

Provides a convenient implementation of the WebConnection interface that can be subclassed by developers wishing to adapt a particular WebConnection.

This class implements the Wrapper or Decorator pattern. Methods default to calling through to the wrapped web connection object.

Version:

$Revision: 5660 $

Author:

Marc Guillemot

Constructor Summary

WebConnectionWrapper(WebClient webClient)
Constructs a WebConnection object wrapping the connection of the WebClient and places itself as connection of the WebClient.

WebConnectionWrapper(WebConnection webConnection)
Constructs a WebConnection object wrapping provided WebConnection.

Method Summary

WebResponse

getResponse(WebRequest request) Submits a request and retrieves a response.

Methods inherited from class java.lang.Object

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

Constructor Detail

WebConnectionWrapper

public WebConnectionWrapper(WebConnection webConnection)
                     throws IllegalArgumentException

Constructs a WebConnection object wrapping provided WebConnection.

Parameters:

webConnection - the webConnection that does the real work

Throws:

IllegalArgumentException - if the connection is null

WebConnectionWrapper

public WebConnectionWrapper(WebClient webClient)
                     throws IllegalArgumentException

Constructs a WebConnection object wrapping the connection of the WebClient and places itself as connection of the WebClient.

Parameters:

webClient - the WebClient which WebConnection should be wrapped

Throws:

IllegalArgumentException - if the WebClient is null

Method Detail

getResponse

public WebResponse getResponse(WebRequest request)
                        throws IOException

Submits a request and retrieves a response. The default behavior of this method is to return getResponse() on the wrapped connection object.

Specified by:

getResponse in interface WebConnection

Parameters:

request - the request

Returns:

the response to the request defined by the specified request

Throws:

IOException - if an IO error occurs