JAVA webservice实践之Jersey(转)

本文转自：http://www.ishang123.com/jishubowen/java/2012-08-01/126.html

 

JAVA webservice实践之Jersey

发布时间：2012-08-01 10:20:49  作者：cxshun  来源：http://cxshun.iteye.com/blog/1282146   点击：1248次

 

 

 

编辑推荐：

JAVA webservice实践之Jersey

Java JAX-RS WebService 服务的发布与访问

Java JAX-WS和JAX-RS webservice的区别和特点

Java REST Web Service开发实例--Jersey,Google Protocol Buffer, Tomcat结合

 

前几天我们一起学习了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

www.ishang123.com   复制内容到剪贴板 折叠 Java 代码

1. @XmlRootElement     
2. public class Reader implements Serializable{      
3.     private static final long serialVersionUID = 1L;      
4.     private String name;      
5.     private String password;      
6.           
7.     public Reader(){}      
8.     public Reader(String name,String password) {      
9.         this.name = name;      
10.         this.password = password;      
11.     }      
12.     //省略Get/Set方法      
13.     public String toString(){      
14.         return "Name:"+name+",Password:"+password;      
15.     }      
16. }     
17.   

 

  这里用到了一个标签，这里用到的表示它返回的时候的类型，即此Reader类可以用于XML返回。

 2）来个service类，这时已经不用像以前的CXF和xfire一样要接口了，直接来个类就OK了。

www.ishang123.com   复制内容到剪贴板 折叠 Java 代码

1. @Path("/readerService/{name}/{password}")      
2. ublic class ReaderService {      
3.          
4.    @GET     
5.    @Produces(MediaType.APPLICATION_JSON)      
6.    public Reader getReader(@PathParam("name") String name,@PathParam("password") String password) {      
7.        return new Reader(name,password);      
8.    }      
9.          
10.    public static void main(String[] args) throws IllegalArgumentException, IOException, URISyntaxException {      
11.        HttpServer server = HttpServerFactory.create("http://localhost:8080/");      
12.        server.start();      
13.    }      
14.    

 

这时用到了几个标签，Path相信用过springMVC的朋友应该知道这种写法，就是URL匹配，如果不清楚的，可以先去看看。Get标签表示这个方法只能通过Get方法来进行访问，而Produces表示生成的结果，它表示系统会把Reader对象封闭成JSON结果进行返回。

 如果不理解不要紧，等一下看结果就可以理解了。

 而这时有一个main方法，相信有很大疑问吧。这是jersey内部提供的一个轻量级的内部容器，它可以暂时供我们调试用，但真正使用肯定不能用这个。

 3）我们写一个测试类

www.ishang123.com   复制内容到剪贴板 折叠 Java 代码

1. public class ReaderClient {      
2.      
3.     public static void main(String[] args) {      
4.         Client client = Client.create();      
5.         WebResource resource = client.resource("http://localhost:8080/readerService/shun/123213");      
6.         Reader reader = resource.get(Reader.class);      
7.         System.out.println(reader);      
8.     }      
9.      
10. }     

 

 很简单的代码，应该都看得懂的，一个client对象，请求webservice，返回一个resource，然后resource就直接调用相应的方法，当然这个方法是通过我们的URl来进行匹配的。

 

 这里我们先用它自带的一个轻量级服务测试一下。直接运行ReaderService，它里面有包含一个main方法，运行后，我们再运行ReaderClient，我们可以看到结果为：

 

  结果正确。

 

 我们当然不想就这样用自带的轻量级服务来作为我我们的服务器，我们需要放到和我们的项目在同一个服务器，比如tomcat，jboss等。

 4）WEB项目当然就少不了web.xml。

www.ishang123.com   复制内容到剪贴板 折叠 XML/HTML 代码

1. <?xml version="1.0" encoding="UTF-8"?>     
2. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     
3.     xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"     
4.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"     
5.     id="WebApp_ID" version="3.0">     
6.     <servlet>     
7.         <servlet-name>Jersey Web Application</servlet-name>     
8.         <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class>     
9.         <load-on-startup>1</load-on-startup>     
10.     </servlet>     
11.     <servlet-mapping>     
12.         <servlet-name>Jersey Web Application</servlet-name>     
13.         <url-pattern>/rest/*</url-pattern>     
14.     </servlet-mapping>     
15.     <welcome-file-list>     
16.         <welcome-file>index.jsp</welcome-file>     
17.     </welcome-file-list>     
18. </web-app>     
19.   

 

这时指定了rest路径下的所有都将被jersey进行拦截。

 我们部署到tomcat下启动后再重新运行readerClient，注意先要修改resource的路径：

Java代码  
WebResource resource = client.resource("http://localhost:8080/jerseyWebService/rest/readerService/shun/123213"); 

WebResource resource = client.resource("http://localhost:8080/jerseyWebService/rest/readerService/shun/123213");  我的项目名为jerseyWebService，请根据你的项目名进行修改。

 修改后，我们重新运行，结果如下：

 

  
 和上面的结果一致，说明部署的效果是一样的，也是正确的。

 jersey的大概用法先介绍到这时，我们在以后会继续深入去研究一下jersey.