前几天我们一起学习了CXF和xfire,那两天都存在WSDL描述文件,今天我们一起来看一下一个比较新的webservice框架,sun的Jersey,它与前两个和以后我们看的axis2最大的不同就是它没有WSDL文件,而是WADL,它属于restful webservice框架,什么是RESTFUl呢?具体可以看看这篇文章,写得很不错:http://zhangjunhd.blog.51cto.com/113473/47283。
具体的那些什么文件之类的留给大家去学习,我们来看看它的基本用法。
直接来个项目看看。开始项目之前大家还是先自己去下载包:https://maven.java.net/content/repositories/releases/com/sun/jersey/要运行例子需要同时下载server和client。当然不想找那么多,可以直接下这个zip包,https://maven.java.net/service/local/artifact/maven/redirect?r=releases&g=com.sun.jersey&a=jersey-archive&v=1.10&e=zip
1)直接来个JAVABEAN
@XmlRootElement public class Reader implements Serializable{ private static final long serialVersionUID = 1L; private String name; private String password; public Reader(){} public Reader(String name,String password) { this.name = name; this.password = password; } //省略Get/Set方法 public String toString(){ return "Name:"+name+",Password:"+password; } }
这里用到了一个标签,这里用到的表示它返回的时候的类型,即此Reader类可以用于XML返回。
2)来个service类,这时已经不用像以前的CXF和xfire一样要接口了,直接来个类就OK了。
@Path("/readerService/{name}/{password}") public class ReaderService { @GET @Produces(MediaType.APPLICATION_JSON) public Reader getReader(@PathParam("name") String name,@PathParam("password") String password) { return new Reader(name,password); } public static void main(String[] args) throws IllegalArgumentException, IOException, URISyntaxException { HttpServer server = HttpServerFactory.create("http://localhost:8080/"); server.start(); } }
这时用到了几个标签,Path相信用过springMVC的朋友应该知道这种写法,就是URL匹配,如果不清楚的,可以先去看看。Get标签表示这个方法只能通过Get方法来进行访问,而Produces表示生成的结果,它表示系统会把Reader对象封闭成JSON结果进行返回。
如果不理解不要紧,等一下看结果就可以理解了。
而这时有一个main方法,相信有很大疑问吧。这是jersey内部提供的一个轻量级的内部容器,它可以暂时供我们调试用,但真正使用肯定不能用这个。
3)我们写一个测试类
public class ReaderClient { public static void main(String[] args) { Client client = Client.create(); WebResource resource = client.resource("http://localhost:8080/readerService/shun/123213"); Reader reader = resource.get(Reader.class); System.out.println(reader); } }
很简单的代码,应该都看得懂的,一个client对象,请求webservice,返回一个resource,然后resource就直接调用相应的方法,当然这个方法是通过我们的URl来进行匹配的。
这里我们先用它自带的一个轻量级服务测试一下。直接运行ReaderService,它里面有包含一个main方法,运行后,我们再运行ReaderClient,我们可以看到结果为:
结果正确。
我们当然不想就这样用自带的轻量级服务来作为我我们的服务器,我们需要放到和我们的项目在同一个服务器,比如tomcat,jboss等。
4)WEB项目当然就少不了web.xml。
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0"> <servlet> <servlet-name>Jersey Web Application</servlet-name> <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>Jersey Web Application</servlet-name> <url-pattern>/rest/*</url-pattern> </servlet-mapping> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> </web-app>
这时指定了rest路径下的所有都将被jersey进行拦截。
我们部署到tomcat下启动后再重新运行readerClient,注意先要修改resource的路径:
WebResource resource = client.resource("http://localhost:8080/jerseyWebService/rest/readerService/shun/123213");
我的项目名为jerseyWebService,请根据你的项目名进行修改。
修改后,我们重新运行,结果如下:
和上面的结果一致,说明部署的效果是一样的,也是正确的。
jersey的大概用法先介绍到这时,我们在以后会继续深入去研究一下jersey.