org.apache.http.localserver

Class ServerTestBase

java.lang.Object

org.apache.http.localserver.BasicServerTestBase

org.apache.http.localserver.ServerTestBase

public abstract class ServerTestBase
extends BasicServerTestBase

Base class for tests using LocalTestServer. Note that the test server will be set up before each individual tests and teared down afterwards. Use this base class exclusively for tests that require the server. If you have some tests that require the server and others that don't, split them in two different classes.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.http.params.HttpParams	defaultParams The default parameters for the client side.
protected org.apache.http.protocol.BasicHttpContext	httpContext The default context for the client side.
protected org.apache.http.protocol.HttpRequestExecutor	httpExecutor The request executor for the client side.
protected org.apache.http.protocol.BasicHttpProcessor	httpProcessor The HTTP processor for the client side.
protected org.apache.http.conn.scheme.SchemeRegistry	supportedSchemes The available schemes.

Fields inherited from class org.apache.http.localserver.BasicServerTestBase

localServer

Constructor Summary

Constructors

Constructor and Description
ServerTestBase()

Method Summary

Modifier and Type	Method and Description
protected org.apache.http.impl.DefaultHttpClientConnection	connectTo(org.apache.http.HttpHost target) Opens a connection to the given target using default parameters.
protected org.apache.http.impl.DefaultHttpClientConnection	connectTo(org.apache.http.HttpHost target, org.apache.http.params.HttpParams params) Opens a connection to the given target using the given parameters.
void	setUp() Prepares the local server for testing.

Methods inherited from class org.apache.http.localserver.BasicServerTestBase

getServerHttp, tearDown

Methods inherited from class java.lang.Object

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

Field Detail

supportedSchemes

protected org.apache.http.conn.scheme.SchemeRegistry supportedSchemes

The available schemes.

defaultParams

protected org.apache.http.params.HttpParams defaultParams

The default parameters for the client side.

httpProcessor

protected org.apache.http.protocol.BasicHttpProcessor httpProcessor

The HTTP processor for the client side.

httpContext

protected org.apache.http.protocol.BasicHttpContext httpContext

The default context for the client side.

httpExecutor

protected org.apache.http.protocol.HttpRequestExecutor httpExecutor

The request executor for the client side.

Constructor Detail

ServerTestBase

public ServerTestBase()

Method Detail

setUp

public void setUp()
           throws Exception

Prepares the local server for testing. Derived classes that override this method MUST call the implementation here. That SHOULD be done at the beginning of the overriding method.
Derived methods can modify for example the default parameters being set up, or the interceptors.

This method will re-use the helper objects from a previous run if they are still available. For example, the local test server will be re-started rather than re-created. httpContext will always be re-created. Tests that modify the other helper objects should afterwards set the respective attributes to null in a finally{} block to force re-creation for subsequent tests. Of course that shouldn't be done with the test server, or only after shutting that down.

Throws:

Exception - in case of a problem

connectTo

protected org.apache.http.impl.DefaultHttpClientConnection connectTo(org.apache.http.HttpHost target)
                                                              throws Exception

Opens a connection to the given target using default parameters. Maps to connectTo(target,defaultParams).

Parameters:

target - the target to connect to

Returns:

a new connection opened to the target

Throws:

Exception - in case of a problem

connectTo

protected org.apache.http.impl.DefaultHttpClientConnection connectTo(org.apache.http.HttpHost target,
                                                                     org.apache.http.params.HttpParams params)
                                                              throws Exception

Opens a connection to the given target using the given parameters.

Parameters:

target - the target to connect to

Returns:

a new connection opened to the target

Throws:

Exception - in case of a problem