Examples of com.sun.jersey.test.framework.JerseyTest

• com.sun.jersey.test.framework.JerseyTest
  An abstract JUnit 4.x-based unit test class for testing JAX-RS and Jersey-based applications.

  At construction this class will obtain a test container factory, of type {@link TestContainerFactory}, and use that to obtain a configured test container, of type {@link TestContainer}.

  Before a test method, in an extending class, is run the {@link TestContainer#start() } method is invoked. After the test method hasrun the {@link TestContainer#stop() } method is invoked.The test method can invoke the {@link #resource() } to obtain a{@link WebResource} from which requests may be sent to and responses receivedfrom the Web application under test.

  If a test container factory is not explicitly declared using the appropriate constructor (see {@link #JerseyTest(TestContainerFactory) }) then a default test container factory will be obtained as follows. If the system property {@literal jersey.test.containerFactory} is set and thevalue is a fully qualified class name of a class that extends from {@link TestContainerFactory} then the default test container factory willbe an instance of that class. The exception {@link TestContainerException}will be thrown if the class cannot be loaded or instantiated. If the system property {@literal jersey.test.containerFactory} is not set thenthe default test container factory will be an instance of {@link com.sun.jersey.test.framework.spi.container.grizzly.web.GrizzlyWebTestContainerFactory}. The exception {@link TestContainerException} will be thrown if this class cannot be loaded or instantiated.

  The test container is configured from an application descriptor, of type {@link AppDescriptor}. The exception {@link TestContainerException}will be thrown if the test container cannot support the application descriptor. An application descriptor is built from an application descriptor builder. Two application descriptor builders are provided:

  1. A low-level builder, of type {@link LowLevelAppDescriptor.Builder}, compatible with low-level test containers that do not support Servlets.
  2. A web-based builder, of type {@link WebAppDescriptor.Builder}, compatible with web-based test containers that support Servlets.

  An application descriptor of type {@link WebAppDescriptor} may betransformed to an application descriptor of type {@link LowLevelAppDescriptor}if the state of the former is compatible with a low-level description.

  The following low-level test container factories are provided:

  • {@link GrizzlyTestContainerFactory} for testing with the low-level Grizzly HTTP container.
  • {@link HTTPContainerFactory} for testing with the Light Weight HTTPserver distributed with Java SE 6.
  • {@link InMemoryTestContainerFactory} for testing in memory withoutusing underlying HTTP client and server side functionality to send requests and receive responses.

  The following Web-based test container factories are provided:

  • {@link GrizzlyWebTestContainerFactory} for testing with the GrizzlyWeb container and Servlet support.
  • {@link EmbeddedGlassFishTestContainerFactory} for testing withembedded GlassFish.
  • {@link ExternalTestContainerFactory} for testing when the Webapplication is independently deployed in a separate JVM to that of the tests. For example, the application may be deployed to the Glassfish v2 or v3 application server.

  @author Paul.Sandoz@Sun.COM, Srinivas.Bhimisetty@Sun.COM

Related Classes of com.sun.jersey.test.framework.JerseyTest