org.glassfish.jersey.test.memleak.common

Class AbstractMemoryLeakWebAppTest

java.lang.Object

org.glassfish.jersey.test.JerseyTest

org.glassfish.jersey.test.memleak.common.AbstractMemoryLeakWebAppTest

public class AbstractMemoryLeakWebAppTest
extends JerseyTest

Adds support for web application testing and memory leak detection in target JVM.

Author:

Stepan Vavra (stepan.vavra at oracle.com)

Constructor Summary

Constructors

Constructor and Description
AbstractMemoryLeakWebAppTest()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	configureClient(ClientConfig config) Configure the test client.
protected DeploymentContext	configureDeployment() Create and configure deployment context for the tested application.
void	verifyNoOutOfMemoryOccurred() Verifies no OutOfMemoryError is present in associated log file. The motivation is to have the OutOfMemory error included in the JUnit test result if possible. The problem is that even of OutOfMemoryError occurred, it may not be logged yet.

Methods inherited from class org.glassfish.jersey.test.JerseyTest

client, close, closeIfNotNull, configure, disable, enable, forceDisable, forceEnable, forceSet, getAsyncTimeoutMultiplier, getBaseUri, getClient, getLastLoggedRecord, getLoggedRecords, getPort, getTestContainerFactory, isEnabled, set, set, setClient, setUp, target, target, tearDown

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractMemoryLeakWebAppTest

public AbstractMemoryLeakWebAppTest()

Method Detail

verifyNoOutOfMemoryOccurred

public void verifyNoOutOfMemoryOccurred()
                                 throws IOException

Verifies no OutOfMemoryError is present in associated log file.
The motivation is to have the OutOfMemory error included in the JUnit test result if possible.
The problem is that even of OutOfMemoryError occurred, it may not be logged yet. Therefore the log file needs to be inspected when the JVM is shut down and all its resources are flushed and closed.

Throws:

IOException

configureDeployment

protected DeploymentContext configureDeployment()

Description copied from class: JerseyTest

Create and configure deployment context for the tested application. This method may be overridden by subclasses to provide custom test container deployment context for the tested application. The method may be also used to configure JerseyTest instance properties.

The method is invoked from JerseyTest constructors to provide deployment context for the tested application. Default implementation of this method creates new deployment context using JAX-RS application instance obtained by calling the JerseyTest.configure() method.

Note that since the method is invoked from JerseyTest constructor, the overriding implementation of the method must not depend on any subclass fields as those will not be initialized yet when the method is invoked.

Also note that in case the JerseyTest.JerseyTest(javax.ws.rs.core.Application) constructor is used, the method is never invoked.

Overrides:

configureDeployment in class JerseyTest

Returns:

configured deployment context for the tested application.

configureClient

protected void configureClient(ClientConfig config)

Description copied from class: JerseyTest

Configure the test client. The method can be overridden by JerseyTest subclasses to conveniently configure the test client instance used by Jersey test framework (either returned from JerseyTest.client() method or used to create WebTarget instances returned from one of the target methods (JerseyTest.target() or JerseyTest.target(String)).

Prior to every test method run, a new client instance is configured and created using the client configuration provided by the TestContainer as well as any internal JerseyTest client configuration settings.

Before the actual client instance creation, Jersey test framework invokes this method in order to allow the subclasses to further customize created client instance.

After each test method is run, the existing client instance is closed and discarded.

Default implementation of the method is "no-op".

Overrides:

configureClient in class JerseyTest

Parameters:

config - Jersey test client configuration that can be modified before the client is created.