JAXRS Testing. JAX-RS Testing. Embedded Jetty

Transcription

1 JAXRS Testing JAX-RS Testing Embedded Jetty Local Transport Mocking HTTP contexts JAX-RS endpoints can be easily tested using the embedded Jetty or CXF Local Transport. Embedded Jetty Maven Dependency <dependency> <groupid>org.apache.cxf</groupid> <artifactid>cxf-rt-transports-http-jetty</artifactid> <version>3.0.0</version> </dependency> import javax.ws.rs.core.response; Example import org.apache.cxf.endpoint.server; import org.apache.cxf.jaxrs.jaxrsserverfactorybean; import org.apache.cxf.jaxrs.client.webclient; import org.apache.cxf.jaxrs.lifecycle.singletonresourceprovider; import org.junit.test; import org.junit.assert; import org.junit.beforeclass; import org.junit.afterclass; import custom.myjaxrsresource; import custom.book; public class JAXRSTest extends Assert { private final static String ENDPOINT_ADDRESS = " /rest"; private final static String WADL_ADDRESS = ENDPOINT_ADDRESS + "?_wadl"; private static Server public static void initialize() throws Exception { startserver();

2 waitforwadl(); private static void startserver() throws Exception { JAXRSServerFactoryBean sf = new JAXRSServerFactoryBean(); sf.setresourceclasses(myjaxrsresource.class); List<Object> providers = new ArrayList<Object>(); // add custom providers if any sf.setproviders(providers); sf.setresourceprovider(myjaxrsresource.class.class, new SingletonResourceProvider(new MyJaxrsResource(), true)); sf.setaddress(endpoint_address); server = sf.create(); // Optional step - may be needed to ensure that by the time individual // tests start running the endpoint has been fully initialized private static void waitforwadl() throws Exception { WebClient client = WebClient.create(WADL_ADDRESS); // wait for 20 secs or so for (int i = 0; i < 20; i++) { Thread.currentThread().sleep(1000); Response response = client.get(); if (response.getstatus() == 200) { break; // no WADL is available yet - throw an exception or give tests a chance to run public static void destroy() throws Exception { server.stop(); server.destroy(); public void testgetbookwithwebclient() { WebClient client = WebClient.create(ENDPOINT_ADDRESS); client.accept("text/xml"); client.path("somepath"); Book book = client.get(book.class); public void testgetbookwithproxy() {

3 MyJaxrsResource client = JAXRSClientFactory.create(ENDPOINT_ADDRESS, MyJaxrsResource.class); Book book = client.getbook(); It is quite easy to setup a server and start testing it. The advantage of using the embedded Jetty is that a complete end-to-end round-trip can be exercised, thus stressing all the CXF runtime which comes at the cost of some added complexity to do with setting up the server. Local Transport Starting from CXF it is possible to use CXF Local Transport for testing the JAX-RS endpoints and clients. This avoids the need to start an embedded servlet container and the tests will run faster. Maven Dependency <dependency> <groupid>org.apache.cxf</groupid> <artifactid>cxf-rt-transports-local</artifactid> <version>3.0.0</version> </dependency> Example import org.apache.cxf.endpoint.server; import org.apache.cxf.jaxrs.jaxrsserverfactorybean; import org.apache.cxf.jaxrs.client.webclient; import org.apache.cxf.jaxrs.lifecycle.singletonresourceprovider; import org.apache.cxf.transport.local.localconduit; import org.junit.test; import org.junit.assert; import org.junit.beforeclass; import org.junit.afterclass; import custom.myjaxrsresource; import custom.book; public class JAXRSTest extends Assert { private final static String ENDPOINT_ADDRESS = "local://books"; private static Server public static void initialize() throws Exception { startserver();

4 private static void startserver() throws Exception { JAXRSServerFactoryBean sf = new JAXRSServerFactoryBean(); sf.setresourceclasses(myjaxrsresource.class); List<Object> providers = new ArrayList<Object>(); // add custom providers if any sf.setproviders(providers); sf.setresourceprovider(myjaxrsresource.class.class, new SingletonResourceProvider(new MyJaxrsResource(), true)); sf.setaddress(endpoint_address); server = public static void destroy() throws Exception { server.stop(); server.destroy(); public void testgetbookwithwebclientdirectdispatch() { WebClient client = WebClient.create(ENDPOINT_ADDRESS); WebClient.getConfig(client).getRequestContext().put(LocalConduit. DIRECT_DISPATCH, Boolean.TRUE); client.accept("text/xml"); client.path("somepath"); Book book = client.get(book.class); public void testgetbookviapipe() { WebClient client = WebClient.create(ENDPOINT_ADDRESS); client.accept("text/xml"); client.path("somepath"); Book book = client.get(book.class); public void testaddbookwithproxydirectdispatch() { MyJaxrsResource client = JAXRSClientFactory.create(ENDPOINT_ADDRESS, MyJaxrsResource.class); WebClient.getConfig(client).getRequestContext().put(LocalConduit. DIRECT_DISPATCH, Boolean.TRUE); Book book = client.echobook(new Book(123));

5 Note that setting a LocalConduit.DIRECT_DISPATCH property to 'true' ensures that the invocation goes immediately into the service chain after the client out chain has completed. If this property is not set then CXF LocalConduit sets up a pipe which is initiated via an initial write on the client side. In the above code example Local transport is activated by using a URI "local:" scheme, for example, "local://books". Alternatively, the address can be set as a relative value such as "/books", with the server and client transportid attribute set to " In this case, when creating the clients, use JAXRSClientFactoryBean: private static void startserver() throws Exception { JAXRSServerFactoryBean sf = new JAXRSServerFactoryBean(); sf.settransportid(localtransportfactory.transport_id); sf.setaddress("/books"); sf.setresourceclasses(myjaxrsresource.class); server = sf.create(); public void testproxypipeddispatchget() throws Exception { JAXRSClientFactoryBean bean = new JAXRSClientFactoryBean(); bean.settransportid(localtransportfactory.transport_id); bean.setaddress("/books"); bean.setserviceclass(myjaxrsresource.class); MyJaxrsResource localproxy = bean.create(myjaxrsresource.class); Book book = localproxy.getbook("123"); Mocking HTTP contexts If you test a code which depends on the injected HTTP contexts such as HttpServletRequest then these contexts will have to be mocked. For example:

6 JAXRSServerFactoryBean sf = new JAXRSServerFactoryBean(); sf.setinvoker(new Invoker() { Invoker jarsinvoker = new public Object invoke(exchange exchange, Object o) { HttpServletRequest request = Mockito.mock(HttpServletRequest.class); Mockito.when(request.getRemoteHost()).thenReturn("host"); exchange.getinmessage().put(abstracthttpdestination.http_request, request); return jarsinvoker.invoke(exchange, o); );