play.test

Class Helpers

java.lang.Object

play.test.Helpers

All Implemented Interfaces:

Http.HeaderNames, Http.Status

public class Helpers
extends java.lang.Object
implements Http.Status, Http.HeaderNames

Helper functions to run tests.

Field Summary

Fields

Modifier and Type	Field and Description
static long	DEFAULT_TIMEOUT Default Timeout (milliseconds) for fake requests issued by these Helpers.
static java.lang.String	DELETE
static java.lang.Class<? extends org.openqa.selenium.WebDriver>	FIREFOX
static java.lang.String	GET
static java.lang.String	HEAD
static java.lang.Class<? extends org.openqa.selenium.WebDriver>	HTMLUNIT
static java.lang.String	POST
static java.lang.String	PUT

Fields inherited from interface play.mvc.Http.Status

ACCEPTED, BAD_GATEWAY, BAD_REQUEST, CONFLICT, CONTINUE, CREATED, EXPECTATION_FAILED, FORBIDDEN, FOUND, GATEWAY_TIMEOUT, GONE, HTTP_VERSION_NOT_SUPPORTED, INTERNAL_SERVER_ERROR, LENGTH_REQUIRED, METHOD_NOT_ALLOWED, MOVED_PERMANENTLY, MULTIPLE_CHOICES, NO_CONTENT, NON_AUTHORITATIVE_INFORMATION, NOT_ACCEPTABLE, NOT_FOUND, NOT_IMPLEMENTED, NOT_MODIFIED, OK, PARTIAL_CONTENT, PAYMENT_REQUIRED, PRECONDITION_FAILED, PROXY_AUTHENTICATION_REQUIRED, REQUEST_ENTITY_TOO_LARGE, REQUEST_TIMEOUT, REQUEST_URI_TOO_LONG, REQUESTED_RANGE_NOT_SATISFIABLE, RESET_CONTENT, SEE_OTHER, SERVICE_UNAVAILABLE, SWITCHING_PROTOCOLS, TEMPORARY_REDIRECT, UNAUTHORIZED, UNSUPPORTED_MEDIA_TYPE, USE_PROXY

Fields inherited from interface play.mvc.Http.HeaderNames

ACCEPT, ACCEPT_CHARSET, ACCEPT_ENCODING, ACCEPT_LANGUAGE, ACCEPT_RANGES, ACCESS_CONTROL_ALLOW_CREDENTIALS, ACCESS_CONTROL_ALLOW_HEADERS, ACCESS_CONTROL_ALLOW_METHODS, ACCESS_CONTROL_ALLOW_ORIGIN, ACCESS_CONTROL_EXPOSE_HEADERS, ACCESS_CONTROL_MAX_AGE, ACCESS_CONTROL_REQUEST_HEADERS, ACCESS_CONTROL_REQUEST_METHOD, AGE, ALLOW, AUTHORIZATION, CACHE_CONTROL, CONNECTION, CONTENT_DISPOSITION, CONTENT_ENCODING, CONTENT_LANGUAGE, CONTENT_LENGTH, CONTENT_LOCATION, CONTENT_MD5, CONTENT_RANGE, CONTENT_TRANSFER_ENCODING, CONTENT_TYPE, COOKIE, DATE, ETAG, EXPECT, EXPIRES, FORWARDED, FROM, HOST, IF_MATCH, IF_MODIFIED_SINCE, IF_NONE_MATCH, IF_RANGE, IF_UNMODIFIED_SINCE, LAST_MODIFIED, LOCATION, MAX_FORWARDS, ORIGIN, PRAGMA, PROXY_AUTHENTICATE, PROXY_AUTHORIZATION, RANGE, REFERER, RETRY_AFTER, SERVER, SET_COOKIE, SET_COOKIE2, TE, TRAILER, TRANSFER_ENCODING, UPGRADE, USER_AGENT, VARY, VIA, WARNING, WWW_AUTHENTICATE, X_FORWARDED_FOR, X_FORWARDED_HOST, X_FORWARDED_PORT, X_FORWARDED_PROTO, X_REQUESTED_WITH

Constructor Summary

Constructors

Constructor and Description
Helpers()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	charset(Result result) Deprecated. use Result.charset() instead.
static byte[]	contentAsBytes(play.twirl.api.Content content) Extracts the content as bytes.
static byte[]	contentAsBytes(Result result) Extracts the content as bytes.
static byte[]	contentAsBytes(Result result, long timeout)
static java.lang.String	contentAsString(play.twirl.api.Content content) Extracts the content as String.
static java.lang.String	contentAsString(Result result) Extracts the content as String.
static java.lang.String	contentAsString(Result result, long timeout)
static java.lang.String	contentType(play.twirl.api.Content content) Deprecated. use Result.contentType() instead.
static java.lang.String	contentType(Result result) Deprecated. use Result.contentType() instead.
static Http.Cookie	cookie(java.lang.String name, Result result) Deprecated. use Result.cookie(String) instead.
static Http.Cookies	cookies(Result result) Deprecated. use Result.cookies() instead.
static FakeApplication	fakeApplication() Build a new fake application.
static FakeApplication	fakeApplication(GlobalSettings global) Build a new fake application.
static FakeApplication	fakeApplication(java.util.Map<java.lang.String,? extends java.lang.Object> additionalConfiguration) Build a new fake application.
static FakeApplication	fakeApplication(java.util.Map<java.lang.String,? extends java.lang.Object> additionalConfiguration, GlobalSettings global) Build a new fake application.
static FakeApplication	fakeApplication(java.util.Map<java.lang.String,? extends java.lang.Object> additionalConfiguration, java.util.List<java.lang.String> additionalPlugin) Build a new fake application.
static FakeApplication	fakeApplication(java.util.Map<java.lang.String,? extends java.lang.Object> additionalConfiguration, java.util.List<java.lang.String> additionalPlugin, GlobalSettings global) Build a new fake application.
static FakeApplication	fakeApplication(java.util.Map<java.lang.String,? extends java.lang.Object> additionalConfiguration, java.util.List<java.lang.String> additionalPlugins, java.util.List<java.lang.String> withoutPlugins) Build a new fake application.
static FakeApplication	fakeApplication(java.util.Map<java.lang.String,? extends java.lang.Object> additionalConfiguration, java.util.List<java.lang.String> additionalPlugins, java.util.List<java.lang.String> withoutPlugins, GlobalSettings global) Build a new fake application.
static GlobalSettings	fakeGlobal() A fake Global
static Http.RequestBuilder	fakeRequest() Build a new GET / fake request.
static Http.RequestBuilder	fakeRequest(Call call) Build a new fake request corresponding to a given route call
static Http.RequestBuilder	fakeRequest(java.lang.String method, java.lang.String uri) Build a new fake request.
static Http.Flash	flash(Result result) Deprecated. use Result.flash() instead.
static java.lang.String	header(java.lang.String header, Result result) Deprecated. use Result.header(String) instead.
static java.util.Map<java.lang.String,java.lang.String>	headers(Result result) Deprecated. use Result.headers() instead.
static java.util.Map<java.lang.String,java.lang.String>	inMemoryDatabase() Constructs a in-memory (h2) database configuration to add to a FakeApplication.
static java.util.Map<java.lang.String,java.lang.String>	inMemoryDatabase(java.lang.String name) Constructs a in-memory (h2) database configuration to add to a FakeApplication.
static java.util.Map<java.lang.String,java.lang.String>	inMemoryDatabase(java.lang.String name, java.util.Map<java.lang.String,java.lang.String> options) Constructs a in-memory (h2) database configuration to add to a FakeApplication.
<V> V	invokeWithContext(Http.RequestBuilder requestBuilder, java.util.concurrent.Callable<V> callable) Calls a Callable which invokes a Controller or some other method with a Context
static java.lang.String	redirectLocation(Result result) Deprecated. use Result.redirectLocation() instead.
static Result	route(Application app, Call call)
static Result	route(Application app, Call call, long timeout)
static Result	route(Application app, Http.RequestBuilder requestBuilder)
static Result	route(Application app, Http.RequestBuilder requestBuilder, byte[] body) Deprecated.
static Result	route(Application app, Http.RequestBuilder requestBuilder, byte[] body, long timeout) Deprecated.
static Result	route(Application app, Http.RequestBuilder requestBuilder, long timeout)
static Result	route(Call call)
static Result	route(Call call, long timeout)
static Result	route(Http.RequestBuilder requestBuilder)
static Result	route(Http.RequestBuilder requestBuilder, byte[] body) Deprecated.
static Result	route(Http.RequestBuilder requestBuilder, byte[] body, long timeout) Deprecated.
static Result	route(Http.RequestBuilder requestBuilder, long timeout)
static Result	routeAndCall(java.lang.Class<? extends play.api.routing.Router> router, Http.RequestBuilder requestBuilder, long timeout)
static Result	routeAndCall(Http.RequestBuilder requestBuilder, long timeout)
static Result	routeAndCall(play.api.routing.Router router, Http.RequestBuilder requestBuilder)
static Result	routeAndCall(play.api.routing.Router router, Http.RequestBuilder requestBuilder, long timeout)
static void	running(Application application, java.lang.Runnable block) Executes a block of code in a running application.
static void	running(TestServer server, java.lang.Class<? extends org.openqa.selenium.WebDriver> webDriver, F.Callback<TestBrowser> block) Executes a block of code in a running server, with a test browser.
static void	running(TestServer server, java.lang.Runnable block) Executes a block of code in a running server.
static void	running(TestServer server, org.openqa.selenium.WebDriver webDriver, F.Callback<TestBrowser> block) Executes a block of code in a running server, with a test browser.
static Http.Session	session(Result result) Deprecated. use Result.session() instead.
static void	start(Application application) Starts a new application.
static void	start(TestServer server) Starts a Test server.
static int	status(Result result) Deprecated. use Result.status() instead.
static void	stop(Application application) Stops an application.
static void	stop(TestServer server) Stops a Test server.
static TestBrowser	testBrowser() Creates a Test Browser.
static TestBrowser	testBrowser(java.lang.Class<? extends org.openqa.selenium.WebDriver> webDriver) Creates a Test Browser.
static TestBrowser	testBrowser(java.lang.Class<? extends org.openqa.selenium.WebDriver> webDriver, int port) Creates a Test Browser.
static TestBrowser	testBrowser(int port) Creates a Test Browser.
static TestBrowser	testBrowser(org.openqa.selenium.WebDriver of) Creates a Test Browser.
static TestBrowser	testBrowser(org.openqa.selenium.WebDriver of, int port) Creates a Test Browser.
static TestServer	testServer() Creates a new Test server listening on port defined by configuration setting "testserver.port" (defaults to 19001).
static TestServer	testServer(Application app) Creates a new Test server listening on port defined by configuration setting "testserver.port" (defaults to 19001) and using the given FakeApplication.
static TestServer	testServer(int port) Creates a new Test server.
static TestServer	testServer(int port, Application app) Creates a new Test server.

Methods inherited from class java.lang.Object

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

Field Detail

GET

public static java.lang.String GET

POST

public static java.lang.String POST

PUT

public static java.lang.String PUT

DELETE

public static java.lang.String DELETE

HEAD

public static java.lang.String HEAD

HTMLUNIT

public static java.lang.Class<? extends org.openqa.selenium.WebDriver> HTMLUNIT

FIREFOX

public static java.lang.Class<? extends org.openqa.selenium.WebDriver> FIREFOX

DEFAULT_TIMEOUT

public static final long DEFAULT_TIMEOUT

Default Timeout (milliseconds) for fake requests issued by these Helpers. This value is determined from System property test.timeout. The default value is 30000 (30 seconds).

Constructor Detail

Helpers

public Helpers()

Method Detail

invokeWithContext

public <V> V invokeWithContext(Http.RequestBuilder requestBuilder,
                               java.util.concurrent.Callable<V> callable)

Calls a Callable which invokes a Controller or some other method with a Context

fakeRequest

public static Http.RequestBuilder fakeRequest()

Build a new GET / fake request.

fakeRequest

public static Http.RequestBuilder fakeRequest(java.lang.String method,
                                              java.lang.String uri)

Build a new fake request.

fakeRequest

public static Http.RequestBuilder fakeRequest(Call call)

Build a new fake request corresponding to a given route call

fakeApplication

public static FakeApplication fakeApplication()

Build a new fake application.

fakeApplication

public static FakeApplication fakeApplication(GlobalSettings global)

Build a new fake application.

fakeGlobal

public static GlobalSettings fakeGlobal()

A fake Global

inMemoryDatabase

public static java.util.Map<java.lang.String,java.lang.String> inMemoryDatabase()

Constructs a in-memory (h2) database configuration to add to a FakeApplication.

inMemoryDatabase

public static java.util.Map<java.lang.String,java.lang.String> inMemoryDatabase(java.lang.String name)

Constructs a in-memory (h2) database configuration to add to a FakeApplication.

inMemoryDatabase

public static java.util.Map<java.lang.String,java.lang.String> inMemoryDatabase(java.lang.String name,
                                                                                java.util.Map<java.lang.String,java.lang.String> options)

Constructs a in-memory (h2) database configuration to add to a FakeApplication.

fakeApplication

public static FakeApplication fakeApplication(java.util.Map<java.lang.String,? extends java.lang.Object> additionalConfiguration)

Build a new fake application.

fakeApplication

public static FakeApplication fakeApplication(java.util.Map<java.lang.String,? extends java.lang.Object> additionalConfiguration,
                                              GlobalSettings global)

Build a new fake application.

fakeApplication

public static FakeApplication fakeApplication(java.util.Map<java.lang.String,? extends java.lang.Object> additionalConfiguration,
                                              java.util.List<java.lang.String> additionalPlugin)

Build a new fake application.

fakeApplication

public static FakeApplication fakeApplication(java.util.Map<java.lang.String,? extends java.lang.Object> additionalConfiguration,
                                              java.util.List<java.lang.String> additionalPlugin,
                                              GlobalSettings global)

Build a new fake application.

fakeApplication

public static FakeApplication fakeApplication(java.util.Map<java.lang.String,? extends java.lang.Object> additionalConfiguration,
                                              java.util.List<java.lang.String> additionalPlugins,
                                              java.util.List<java.lang.String> withoutPlugins)

Build a new fake application.

fakeApplication

public static FakeApplication fakeApplication(java.util.Map<java.lang.String,? extends java.lang.Object> additionalConfiguration,
                                              java.util.List<java.lang.String> additionalPlugins,
                                              java.util.List<java.lang.String> withoutPlugins,
                                              GlobalSettings global)

Build a new fake application.

status

@Deprecated
public static int status(Result result)

Deprecated. use Result.status() instead.

redirectLocation

@Deprecated
public static java.lang.String redirectLocation(Result result)

Deprecated. use Result.redirectLocation() instead.

flash

@Deprecated
public static Http.Flash flash(Result result)

Deprecated. use Result.flash() instead.

session

@Deprecated
public static Http.Session session(Result result)

Deprecated. use Result.session() instead.

cookie

@Deprecated
public static Http.Cookie cookie(java.lang.String name,
                                             Result result)

Deprecated. use Result.cookie(String) instead.

cookies

@Deprecated
public static Http.Cookies cookies(Result result)

Deprecated. use Result.cookies() instead.

header

@Deprecated
public static java.lang.String header(java.lang.String header,
                                                  Result result)

Deprecated. use Result.header(String) instead.

headers

@Deprecated
public static java.util.Map<java.lang.String,java.lang.String> headers(Result result)

Deprecated. use Result.headers() instead.

contentType

@Deprecated
public static java.lang.String contentType(play.twirl.api.Content content)

Deprecated. use Result.contentType() instead.

contentType

@Deprecated
public static java.lang.String contentType(Result result)

Deprecated. use Result.contentType() instead.

charset

@Deprecated
public static java.lang.String charset(Result result)

Deprecated. use Result.charset() instead.

contentAsBytes

public static byte[] contentAsBytes(Result result)

Extracts the content as bytes.

contentAsBytes

public static byte[] contentAsBytes(Result result,
                                    long timeout)

contentAsBytes

public static byte[] contentAsBytes(play.twirl.api.Content content)

Extracts the content as bytes.

contentAsString

public static java.lang.String contentAsString(play.twirl.api.Content content)

Extracts the content as String.

contentAsString

public static java.lang.String contentAsString(Result result)

Extracts the content as String.

contentAsString

public static java.lang.String contentAsString(Result result,
                                               long timeout)

routeAndCall

public static Result routeAndCall(Http.RequestBuilder requestBuilder,
                                  long timeout)

routeAndCall

public static Result routeAndCall(java.lang.Class<? extends play.api.routing.Router> router,
                                  Http.RequestBuilder requestBuilder,
                                  long timeout)

routeAndCall

public static Result routeAndCall(play.api.routing.Router router,
                                  Http.RequestBuilder requestBuilder)

routeAndCall

public static Result routeAndCall(play.api.routing.Router router,
                                  Http.RequestBuilder requestBuilder,
                                  long timeout)

route

public static Result route(Call call)

route

public static Result route(Call call,
                           long timeout)

route

public static Result route(Application app,
                           Call call)

route

public static Result route(Application app,
                           Call call,
                           long timeout)

route

public static Result route(Http.RequestBuilder requestBuilder)

route

public static Result route(Http.RequestBuilder requestBuilder,
                           long timeout)

route

public static Result route(Application app,
                           Http.RequestBuilder requestBuilder)

route

public static Result route(Application app,
                           Http.RequestBuilder requestBuilder,
                           long timeout)

route

@Deprecated
public static Result route(Application app,
                                       Http.RequestBuilder requestBuilder,
                                       byte[] body)

Deprecated.

route

@Deprecated
public static Result route(Application app,
                                       Http.RequestBuilder requestBuilder,
                                       byte[] body,
                                       long timeout)

Deprecated.

route

@Deprecated
public static Result route(Http.RequestBuilder requestBuilder,
                                       byte[] body)

Deprecated.

route

@Deprecated
public static Result route(Http.RequestBuilder requestBuilder,
                                       byte[] body,
                                       long timeout)

Deprecated.

start

public static void start(Application application)

Starts a new application.

stop

public static void stop(Application application)

Stops an application.

running

public static void running(Application application,
                           java.lang.Runnable block)

Executes a block of code in a running application.

testServer

public static TestServer testServer()

Creates a new Test server listening on port defined by configuration setting "testserver.port" (defaults to 19001).

testServer

public static TestServer testServer(Application app)

Creates a new Test server listening on port defined by configuration setting "testserver.port" (defaults to 19001) and using the given FakeApplication.

testServer

public static TestServer testServer(int port)

Creates a new Test server.

testServer

public static TestServer testServer(int port,
                                    Application app)

Creates a new Test server.

start

public static void start(TestServer server)

Starts a Test server.

stop

public static void stop(TestServer server)

Stops a Test server.

running

public static void running(TestServer server,
                           java.lang.Runnable block)

Executes a block of code in a running server.

running

public static void running(TestServer server,
                           java.lang.Class<? extends org.openqa.selenium.WebDriver> webDriver,
                           F.Callback<TestBrowser> block)

Executes a block of code in a running server, with a test browser.

running

public static void running(TestServer server,
                           org.openqa.selenium.WebDriver webDriver,
                           F.Callback<TestBrowser> block)

Executes a block of code in a running server, with a test browser.

testBrowser

public static TestBrowser testBrowser()

Creates a Test Browser.

testBrowser

public static TestBrowser testBrowser(int port)

Creates a Test Browser.

testBrowser

public static TestBrowser testBrowser(java.lang.Class<? extends org.openqa.selenium.WebDriver> webDriver)

Creates a Test Browser.

testBrowser

public static TestBrowser testBrowser(java.lang.Class<? extends org.openqa.selenium.WebDriver> webDriver,
                                      int port)

Creates a Test Browser.

testBrowser

public static TestBrowser testBrowser(org.openqa.selenium.WebDriver of,
                                      int port)

Creates a Test Browser.

testBrowser

public static TestBrowser testBrowser(org.openqa.selenium.WebDriver of)

Creates a Test Browser.