org.spincast.testing.core

Class IntegrationTestBase<R extends RequestContext<?>,W extends WebsocketContext<?>>

java.lang.Object

org.spincast.testing.core.SpincastTestBase

org.spincast.testing.core.IntegrationTestBase<R,W>

All Implemented Interfaces:

BeforeAfterClassMethodsProvider, RepeatedClassAfterMethodProvider, TestFailureListener

Direct Known Subclasses:

IntegrationTestAppBase, IntegrationTestNoAppBase

public abstract class IntegrationTestBase<R extends RequestContext<?>,W extends WebsocketContext<?>>
extends SpincastTestBase

Base class for integration test classes that need the HTTP/WebSocket server to be started.

This requires a "Server" to be bound in the Guice context : it will automatically be stopped after the test class is ran.

Note that this class doesn't start the server by itself because this lets the opportunity to test an application by using its true bootstraping process, which usually starts a server itself!

All client data (such as cookies) are cleared before each test.

Constructor Summary

Constructors

Constructor and Description
IntegrationTestBase()

Method Summary

Modifier and Type	Method and Description
void	afterClass() Called after the tests of the class are ran.
protected ConnectRequestBuilder	CONNECT(String path) Starts an Http Client builder for a CONNECT method.
protected ConnectRequestBuilder	CONNECT(String pathOrUrl, boolean isFullUrl) Starts an Http Client builder for a CONNECT method.
protected ConnectRequestBuilder	CONNECT(String pathOrUrl, boolean isFullUrl, boolean isHttps) Starts an Http Client builder for a CONNECT method.
protected String	createTestUrl(String path) Creates an URL to the started HTTP server.
protected String	createTestUrl(String path, boolean https) Creates an URL to the started HTTP server.
protected String	createTestUrl(String pathOrUrl, boolean isFullUrl, boolean isHttps) Creates an URL to the started HTTP server.
protected DeleteRequestBuilder	DELETE(String path) Starts an Http Client builder for a DELETE method.
protected DeleteRequestBuilder	DELETE(String pathOrUrl, boolean isFullUrl) Starts an Http Client builder for a DELETE method.
protected DeleteRequestBuilder	DELETE(String pathOrUrl, boolean isFullUrl, boolean isHttps) Starts an Http Client builder for a DELETE method.
protected String	formatDate(Date date) Format a date so it can be used in a HTTP header.
protected GetRequestBuilder	GET(String path) Starts an Http Client builder for a GET method.
protected GetRequestBuilder	GET(String pathOrUrl, boolean isFullUrl) Starts an Http Client builder for a GET method.
protected GetRequestBuilder	GET(String pathOrUrl, boolean isFullUrl, boolean isHttps) Starts an Http Client builder for a GET method.
protected CookieFactory	getCookieFactory()
protected List<SpincastPlugin>	getGuiceTweakerExtraPlugins() The extra plugins added by the Guice Tweaker.
protected HttpClient	getHttpClient()
protected Router<R,W>	getRouter()
protected Server	getServer()
protected HeadRequestBuilder	HEAD(String path) Starts an Http Client builder for a HEAD method.
protected HeadRequestBuilder	HEAD(String pathOrUrl, boolean isFullUrl) Starts an Http Client builder for a HEAD method.
protected HeadRequestBuilder	HEAD(String pathOrUrl, boolean isFullUrl, boolean isHttps) Starts an Http Client builder for a HEAD method.
protected boolean	isDisableSllCetificateErrors() By default, for the tests, by disable the SSL certificate errors.
protected OptionsRequestBuilder	OPTIONS(String path) Starts an Http Client builder for a OPTIONS method.
protected OptionsRequestBuilder	OPTIONS(String pathOrUrl, boolean isFullUrl) Starts an Http Client builder for a OPTIONS method.
protected OptionsRequestBuilder	OPTIONS(String pathOrUrl, boolean isFullUrl, boolean isHttps) Starts an Http Client builder for a OPTIONS method.
protected Date	parseDate(String dateHeaderValue) Parse a date from a HTTP header to a Date object.
protected PatchRequestBuilder	PATCH(String path) Starts an Http Client builder for a PATCH method.
protected PatchRequestBuilder	PATCH(String pathOrUrl, boolean isFullUrl) Starts an Http Client builder for a PATCH method.
protected PatchRequestBuilder	PATCH(String pathOrUrl, boolean isFullUrl, boolean isHttps) Starts an Http Client builder for a PATCH method.
protected PostRequestBuilder	POST(String path) Starts an Http Client builder for a POST method.
protected PostRequestBuilder	POST(String pathOrUrl, boolean isFullUrl) Starts an Http Client builder for a POST method.
protected PostRequestBuilder	POST(String pathOrUrl, boolean isFullUrl, boolean isHttps) Starts an Http Client builder for a POST method.
protected PutRequestBuilder	PUT(String path) Starts an Http Client builder for a PUT method.
protected PutRequestBuilder	PUT(String pathOrUrl, boolean isFullUrl) Starts an Http Client builder for a PUT method.
protected PutRequestBuilder	PUT(String pathOrUrl, boolean isFullUrl, boolean isHttps) Starts an Http Client builder for a PUT method.
protected void	stopServer()
protected TraceRequestBuilder	TRACE(String path) Starts an Http Client builder for a TRACE method.
protected TraceRequestBuilder	TRACE(String pathOrUrl, boolean isFullUrl) Starts an Http Client builder for a TRACE method.
protected TraceRequestBuilder	TRACE(String pathOrUrl, boolean isFullUrl, boolean isHttps) Starts an Http Client builder for a TRACE method.
protected WebsocketRequestBuilder	websocket(String path)
protected WebsocketRequestBuilder	websocket(String pathOrUrl, boolean isFullUrl)
protected WebsocketRequestBuilder	websocket(String pathOrUrl, boolean isFullUrl, boolean isHttps)

Methods inherited from class org.spincast.testing.core.SpincastTestBase

afterClassLoops, afterTest, beforeClass, beforeTest, createGuiceTweaker, createInjector, createTestingFilePath, createTestingFilePath, deleteTempDir, getInjector, getSpincastConfig, getSpincastConfigTestingImplementation, getSpincastPluginFromThreadLocal, getTestingWritableDir, isEnableGuiceTweaker, isEnableGuiceTweakerExtraPlugins, isEnableGuiceTweakerTestingConfigMecanism, setSpincastConfig, setupSpincastConfigTesting, testFailure

Methods inherited from class java.lang.Object

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

Constructor Detail

IntegrationTestBase

public IntegrationTestBase()

Method Detail

afterClass

public void afterClass()

Description copied from interface: BeforeAfterClassMethodsProvider

Called after the tests of the class are ran.

This will only be called if the beforeClass() method completed successfully, so you can be sure that the instanciation of the class is complete here.

Specified by:

afterClass in interface BeforeAfterClassMethodsProvider

Overrides:

afterClass in class SpincastTestBase

stopServer

protected void stopServer()

getGuiceTweakerExtraPlugins

protected List<SpincastPlugin> getGuiceTweakerExtraPlugins()

The extra plugins added by the Guice Tweaker. For integration testing, we need the Spincast HTTP Client plugin!

Overrides:

getGuiceTweakerExtraPlugins in class SpincastTestBase

getHttpClient

protected HttpClient getHttpClient()

getRouter

protected Router<R,W> getRouter()

getCookieFactory

protected CookieFactory getCookieFactory()

getServer

protected Server getServer()

createTestUrl

protected String createTestUrl(String path)

Creates an URL to the started HTTP server.

Parameters:

path - the relative path to be appended to the base test URL.

createTestUrl

protected String createTestUrl(String path,
                               boolean https)

Creates an URL to the started HTTP server.

Parameters:

path - the relative path to be appended to the base test URL.

https - if true, "https:" will be used instead of "http:".

createTestUrl

protected String createTestUrl(String pathOrUrl,
                               boolean isFullUrl,
                               boolean isHttps)

Creates an URL to the started HTTP server.

Parameters:

pathOrUrl - a relative path OR a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

isHttps - if true, "https:" will be used instead of "http:".

websocket

protected WebsocketRequestBuilder websocket(String path)

websocket

protected WebsocketRequestBuilder websocket(String pathOrUrl,
                                            boolean isFullUrl)

websocket

protected WebsocketRequestBuilder websocket(String pathOrUrl,
                                            boolean isFullUrl,
                                            boolean isHttps)

GET

protected GetRequestBuilder GET(String path)

Starts an Http Client builder for a GET method. A cookie store is automatically added.

Parameters:

path - the relative path to be appended to the base test URL.

GET

protected GetRequestBuilder GET(String pathOrUrl,
                                boolean isFullUrl)

Starts an Http Client builder for a GET method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

GET

protected GetRequestBuilder GET(String pathOrUrl,
                                boolean isFullUrl,
                                boolean isHttps)

Starts an Http Client builder for a GET method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

isHttps - if true, "https:" will be used instead of "http:".

isDisableSllCetificateErrors

protected boolean isDisableSllCetificateErrors()

By default, for the tests, by disable the SSL certificate errors.

POST

protected PostRequestBuilder POST(String path)

Starts an Http Client builder for a POST method. A cookie store is automatically added.

Parameters:

path - the relative path to be appended to the base test URL.

POST

protected PostRequestBuilder POST(String pathOrUrl,
                                  boolean isFullUrl)

Starts an Http Client builder for a POST method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

POST

protected PostRequestBuilder POST(String pathOrUrl,
                                  boolean isFullUrl,
                                  boolean isHttps)

Starts an Http Client builder for a POST method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

isHttps - if true, "https:" will be used instead of "http:".

PUT

protected PutRequestBuilder PUT(String path)

Starts an Http Client builder for a PUT method. A cookie store is automatically added.

Parameters:

path - the relative path to be appended to the base test URL.

PUT

protected PutRequestBuilder PUT(String pathOrUrl,
                                boolean isFullUrl)

Starts an Http Client builder for a PUT method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

PUT

protected PutRequestBuilder PUT(String pathOrUrl,
                                boolean isFullUrl,
                                boolean isHttps)

Starts an Http Client builder for a PUT method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

isHttps - if true, "https:" will be used instead of "http:".

DELETE

protected DeleteRequestBuilder DELETE(String path)

Starts an Http Client builder for a DELETE method. A cookie store is automatically added.

Parameters:

path - the relative path to be appended to the base test URL.

DELETE

protected DeleteRequestBuilder DELETE(String pathOrUrl,
                                      boolean isFullUrl)

Starts an Http Client builder for a DELETE method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

DELETE

protected DeleteRequestBuilder DELETE(String pathOrUrl,
                                      boolean isFullUrl,
                                      boolean isHttps)

Starts an Http Client builder for a DELETE method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

isHttps - if true, "https:" will be used instead of "http:".

OPTIONS

protected OptionsRequestBuilder OPTIONS(String path)

Starts an Http Client builder for a OPTIONS method. A cookie store is automatically added.

Parameters:

path - the relative path to be appended to the base test URL.

OPTIONS

protected OptionsRequestBuilder OPTIONS(String pathOrUrl,
                                        boolean isFullUrl)

Starts an Http Client builder for a OPTIONS method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

OPTIONS

protected OptionsRequestBuilder OPTIONS(String pathOrUrl,
                                        boolean isFullUrl,
                                        boolean isHttps)

Starts an Http Client builder for a OPTIONS method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

isHttps - if true, "https:" will be used instead of "http:".

TRACE

protected TraceRequestBuilder TRACE(String path)

Starts an Http Client builder for a TRACE method. A cookie store is automatically added.

Parameters:

path - the relative path to be appended to the base test URL.

TRACE

protected TraceRequestBuilder TRACE(String pathOrUrl,
                                    boolean isFullUrl)

Starts an Http Client builder for a TRACE method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

TRACE

protected TraceRequestBuilder TRACE(String pathOrUrl,
                                    boolean isFullUrl,
                                    boolean isHttps)

Starts an Http Client builder for a TRACE method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

isHttps - if true, "https:" will be used instead of "http:".

CONNECT

protected ConnectRequestBuilder CONNECT(String path)

Starts an Http Client builder for a CONNECT method. A cookie store is automatically added.

Parameters:

path - the relative path to be appended to the base test URL.

CONNECT

protected ConnectRequestBuilder CONNECT(String pathOrUrl,
                                        boolean isFullUrl)

Starts an Http Client builder for a CONNECT method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

CONNECT

protected ConnectRequestBuilder CONNECT(String pathOrUrl,
                                        boolean isFullUrl,
                                        boolean isHttps)

Starts an Http Client builder for a CONNECT method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

isHttps - if true, "https:" will be used instead of "http:".

PATCH

protected PatchRequestBuilder PATCH(String path)

Starts an Http Client builder for a PATCH method. A cookie store is automatically added.

Parameters:

path - the relative path to be appended to the base test URL.

PATCH

protected PatchRequestBuilder PATCH(String pathOrUrl,
                                    boolean isFullUrl)

Starts an Http Client builder for a PATCH method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

PATCH

protected PatchRequestBuilder PATCH(String pathOrUrl,
                                    boolean isFullUrl,
                                    boolean isHttps)

Starts an Http Client builder for a PATCH method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

isHttps - if true, "https:" will be used instead of "http:".

HEAD

protected HeadRequestBuilder HEAD(String path)

Starts an Http Client builder for a HEAD method. A cookie store is automatically added.

Parameters:

path - the relative path to be appended to the base test URL.

HEAD

protected HeadRequestBuilder HEAD(String pathOrUrl,
                                  boolean isFullUrl)

Starts an Http Client builder for a HEAD method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

HEAD

protected HeadRequestBuilder HEAD(String pathOrUrl,
                                  boolean isFullUrl,
                                  boolean isHttps)

Starts an Http Client builder for a HEAD method. A cookie store is automatically added.

Parameters:

pathOrUrl - a relative path or a full URL.

isFullUrl - if the 'pathOrUrl' parameter a full URL? If so, it will be used as is. Otherwise it will be appended to the base test URL.

isHttps - if true, "https:" will be used instead of "http:".

formatDate

protected String formatDate(Date date)

Format a date so it can be used in a HTTP header.

parseDate

protected Date parseDate(String dateHeaderValue)

Parse a date from a HTTP header to a Date object.