JAX-RS入门 二 :运行
上一节,已经成功的定义了一个REST服务,并且提供了具体的实现,不过我们还需要把它运行起来。
?
在上一节的装备部分,列举了必须的jar(在tomcat中运行)和可选的jar(作为一个独立的应用程序运行)。这一节将分别介绍如何做为一个独立的应用程序运行和如何在tomcat里运行。
?
Tomcat(或者其他Web容器)中运行要在tomcat之类的容器里运行,首先需要定义一个Application类:
?
这个REST服务已经实现完成,接下来就可以运行了,在工程上点右键: Run As -> Run on server
如果没有配server,这里需要配一个web server,配置完成后,工程就会自动在这个server上运行。最后就可以测试了,这里推荐用SoapUI测试。
?
假设选定是tomcat,tomcat的上下文路径是http://localhost:8080/,并且假设工程名是 JaxrsDemo,那么这个REST服务的根路径就是: http://localhost:8080/JaxrsDemo/customers?;它会对应提供一个wadl文件,路径为: http://localhost:8080/JaxrsDemo/customers/?_wadl 。
?
直接导入 http://localhost:8080/JaxrsDemo/customers/?_wadl? 到SoapUI中,对应的请求方法和结构就会自动生成,只需要填入测试内容即可。
?
独立的应用程序与web容器有几点不同之处:
需要提供自己的上下文路径,即上面的http://localhost:8080/JaxrsDemo部分需要自己控制启动和停止
如果看看org.apache.cxf.jaxrs.servlet.CXFNonSpringJaxrsServlet的源码就会发现,其中的关键类是:org.apache.cxf.jaxrs.JAXRSServerFactoryBean。
我们需要得到一个org.apache.cxf.jaxrs.JAXRSServerFactoryBean对象,然后通过它来得到一个org.apache.cxf.endpoint.Server对象,这个org.apache.cxf.endpoint.Server对象就可以理解成是一个tomcat。
?
参考org.apache.cxf.jaxrs.servlet.CXFNonSpringJaxrsServlet的实现,如下:
JAXRSServerFactoryBean bean = ResourceUtils.createApplication(new CustomerApplication(), false);String address = "http://localhost:8008/";bean.setAddress(address);Server server = bean.create();server.start();try {Thread.sleep(100000000);} catch (InterruptedException e) {e.printStackTrace();}server.stop();?
?
其中 http://localhost:8008/ 就相当于http://localhost:8080/JaxrsDemo部分,所以这个REST服务的路径为:http://localhost:8008/customers , 对应的服务定义文件为: http://localhost:8008/customers/?_wadl .
?
剩下的测试过程同上。