RESTful Webservice

1，REST和RESTFUL是什么？

   REST ( REpresentational State Transfer )，State Transfer 为 "状态传输" 或 "状态转移 "，Representational 中文有人翻译为"表征"、"具象"，合起来就是 "表征状态传输" 或 "具象状态传输" 或 "表述性状态转移"
   REST是一种架构风格，REST 指的是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是 RESTful。其核心是面向资源，REST专门针对网络应用设计和开发方式，以降低开发的复杂性，提高系统的可伸缩性。
   REST提出设计概念和准则为：
   1.网络上的所有事物都可以被抽象为资源(resource)
   2.每一个资源都有唯一的资源标识(resource identifier)，对资源的操作不会改变这些标识
   3.所有的操作都是无状态的
   REST简化开发，其架构遵循CRUD原则，该原则告诉我们对于资源(包括网络资源)只需要四种行为：创建，获取，更新和删除就可以完成相关的操作和处理。您可以通过统一资源标识符（Universal Resource Identifier，URI）来识别和定位资源，并且针对这些资源而执行的操作是通过 HTTP 规范定义的。其核心操作只有GET,PUT,POST,DELETE。

   由于REST强制所有的操作都必须是stateless的，这就没有上下文的约束，如果做分布式，集群都不需要考虑上下文和会话保持的问题。极大的提高系统的可伸缩性。

2.SOAP Webservice和RESTful Webservice

　　WebService是一种能够使应用程序在不同的平台使用不同的编程语言进行通讯的技术规范，而这种技术规范的实现可以用不同的方法，比如使用基于XML形式的协议（SOAP）进行通讯或者是RESTFUL形式的。

 　　既然我们知道可以使用上面的两种形式进行通讯，那么我们就需要对上面的两种形式进行描述，规范化。而这些规范化的工作sun已经帮我们完成了，也就是JAX-WS,JAX-RS这两种规范.

　　JAX-WS是一种规范，而在jdk1.6之后就有了自带的实现，但是这种实现是比较简单的，基本上就只能够传递SOAP协议格式的消息。这就是为什么我们可以在没有axis2或者CXF的情况下开发WebService。  这时候我们就会想了，如果我们需要其他的服务，比如我想让JAX-WS与Spring集成。这种需求前辈都已经考虑过了，也实现了，不需要我们在去实现这样的需求。而这种需求的解决方案在JAX-WS中是采用框架。而JAX-WS的框架就有AXIS2和CXF。框架使用起来可能会更加灵活，功能更加强大。比如CXF不仅仅实现JAX-WS，也实现了JAX-RS规范。

 

　　那么选择SOAP Webservice和Restful Webservice的使用，首先需要理解就是SOAP偏向于面向活动，有严格的规范和标准，包括安全，事务等各个方面的内容，同时SOAP强调操作方法和操作对象的分离，有WSDL文件规范和XSD文件分别对其定义。而REST强调面向资源，只要我们要操作的对象可以抽象为资源即可以使用REST架构风格。

 

3. Cxf 开发soap webservice 简单实例：

接口和实现类：

 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

package  demo2;   import  javax.jws.WebParam; import  javax.jws.WebService;   @WebService public  interface  HiGirl {        String sayHi( @WebParam (name =  "text" ) String text); }     package  demo2;   import  javax.jws.WebParam;   public  class  HiGirlImpl  implements  HiGirl {        @Override      public  String sayHi( @WebParam (name =  "text" ) String text) {          return  "hi,"  + text;      }   }

 

 spring配置：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

<? xml  version="1.0" encoding="UTF-8"?> < beans  xmlns="http://www.springframework.org/schema/beans"      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:tx="http://www.springframework.org/schema/tx"      xmlns:jaxws="http://cxf.apache.org/jaxws" xmlns:cxf="http://cxf.apache.org/core"      xmlns:wsa="http://cxf.apache.org/ws/addressing"      xsi:schemaLocation="            http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.1.xsd        http://cxf.apache.org/core http://cxf.apache.org/schemas/core.xsd       http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd          http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd">        <!-- 以下三个文件在 cxf-2.7.18.jar 中定义 ，主要功能室CXF和Spring集成时，注册一些Process Bean -->      < import  resource="classpath:META-INF/cxf/cxf.xml" />      < import  resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />      < import  resource="classpath:META-INF/cxf/cxf-servlet.xml" />        <!-- publish -->      < jaxws:endpoint  id="hiGirl" implementor="demo2.HiGirlImpl"          address="/hiGirl" />            <!-- client 如果是通过web的方式访问，可以不用配置 该client，但是需要配置web.xml-->      < bean  id="client" class="demo2.HiGirl" factory-bean="clientFactory"          factory-method="create"></ bean >        < bean  id="clientFactory" class="org.apache.cxf.jaxws.JaxWsProxyFactoryBean">          < property  name="serviceClass" value="demo2.HiGirl"></ property >          < property  name="address" value="http://localhost:8080/webservice/hiGirl"></ property >      </ bean > </ beans >

 web.xml 配置：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48

<? 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"      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">      < display-name >CXFwebservice</ display-name >      < welcome-file-list >          < welcome-file >index.html</ welcome-file >      </ welcome-file-list >        < context-param >          < param-name >contextConfigLocation</ param-name >          < param-value >classpath:demo2/applicationContext.xml</ param-value >      </ context-param >      < listener >          < listener-class >org.springframework.web.context.ContextLoaderListener</ listener-class >      </ listener >      < servlet >          < servlet-name >CxfServlet</ servlet-name >          < servlet-class >org.apache.cxf.transport.servlet.CXFServlet</ servlet-class >          < load-on-startup >1</ load-on-startup >      </ servlet >      < servlet-mapping >          < servlet-name >CxfServlet</ servlet-name >          < url-pattern >/webservice/*</ url-pattern >      </ servlet-mapping >        < filter >          < filter-name >encoding</ filter-name >          < filter-class >org.springframework.web.filter.CharacterEncodingFilter</ filter-class >          < init-param >              < param-name >encoding</ param-name >              < param-value >UTF-8</ param-value >          </ init-param >          < init-param >              < param-name >forceEncoding</ param-name >              < param-value >true</ param-value >          </ init-param >      </ filter >      < filter-mapping >          < filter-name >encoding</ filter-name >          < url-pattern >*.jsp</ url-pattern >      </ filter-mapping >      < filter-mapping >          < filter-name >encoding</ filter-name >          < url-pattern >*.do</ url-pattern >      </ filter-mapping > </ web-app >

 客户端调用：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

package  demo2;   import  org.springframework.context.ApplicationContext; import  org.springframework.context.support.ClassPathXmlApplicationContext;   public  class  WebServiceApp {        public  static  void  main(String[] args) {          ApplicationContext factory =  new  ClassPathXmlApplicationContext( "demo2/applicationContext.xml" );          HiGirl client = (HiGirl) factory.getBean( "client" );          System.out.println(client.sayHi( "bitch!" ));        }   }

 4，CXF开发 restful webservice 简单实例：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129

package  demo;   import  java.util.LinkedList; import  java.util.List;   public  class  Config {        public  static  List<Person> persons;      static  {          persons =  new  LinkedList<Person>();          Person person =  new  Person();          person.setId( "6272058" );          person.setName( "刘德华" );          persons.add(person);      } }   package  demo;   import  javax.xml.bind.annotation.XmlRootElement;   @XmlRootElement (name =  "Person" ) public  class  Person {        private  String name;      private  String id;        public  String getName() {          return  name;      }        public  void  setName(String name) {          this .name = name;      }        public  String getId() {          return  id;      }        public  void  setId(String id) {          this .id = id;      }   } package  demo;   import  javax.ws.rs.Consumes; import  javax.ws.rs.DELETE; import  javax.ws.rs.GET; import  javax.ws.rs.POST; import  javax.ws.rs.PUT; import  javax.ws.rs.Path; import  javax.ws.rs.PathParam; import  javax.ws.rs.Produces; import  javax.ws.rs.QueryParam; import  javax.ws.rs.core.MediaType; import  javax.ws.rs.core.Response; import  javax.ws.rs.core.Response.Status;   @Path ( "/PersonService" ) //@Produces注释用来指定将要返回给client端的数据标识类型（MIME）。 //@Produces可以作为class注释，也可以作为方法注释，方法的@Produces注释将会覆盖class的注释。 //覆盖的意思是假如方法声明了自己的Produce，那么以方法的为准，class的仅供参考 @Produces ({  "application/json" ,  "application/xml"  }) public  class  PersonService {        @GET      @Path ( "/getPerson/{dd}" )      @Produces (MediaType.APPLICATION_XML)      public  Person getPerson( @PathParam ( "dd" ) String id) {          if  (id !=  null  && id.length() >  0 ) {              for  (Person pp : Config.persons) {                  if (id.equals(pp.getId())){                      return  pp;                  }              }              Person result =  new  Person();              result.setId(id);              return  result;          }  else  {              return  new  Person();          }      }        @POST      @Path ( "/regPerson" )      //@Consumes与@Produces相反，用来指定可以接受client发送过来的MIME类型，      //同样可以用于class或者method，也可以指定多个MIME类型,一般用于@PUT，@POST。      @Consumes ({  "application/json" ,  "application/xml"  })      public  Response regPerson(Person person) {          if  (Config.persons.contains(person)) {              return  Response.status(Status.BAD_REQUEST).build();          }  else  {              Config.persons.add(person);              return  Response.ok(person).build();          }      }        @DELETE      @Path ( "/delPerson" )      @Consumes ({  "application/json" ,  "application/xml"  })      public  Response delPerson( @QueryParam ( "id" ) String id) {          Person person =  new  Person();          person.setId(id);          if  (Config.persons.contains(person)) {              return  Response.status(Status.BAD_REQUEST).build();          }  else  {              Config.persons.remove(person);              return  Response.ok(person).build();          }      }        @PUT      @Path ( "/updatePerson" )      @Consumes ({  "application/json" ,  "application/xml"  })      public  Response updatePerson(Person person) {          if  (Config.persons.contains(person)) {              return  Response.status(Status.BAD_REQUEST).build();          }  else  {              for  (Person pp : Config.persons) {                  if  (pp.equals(person)) {                      pp.setName(person.getName());                  }              }              return  Response.ok(person).build();          }      }   }

 spring配置：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

<? xml  version="1.0" encoding="UTF-8"?> < beans  xmlns="http://www.springframework.org/schema/beans"      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:jaxrs="http://cxf.apache.org/jaxrs"      xsi:schemaLocation="http://www.springframework.org/schema/beans                              http://www.springframework.org/schema/beans/spring-beans-2.5.xsd                              http://cxf.apache.org/jaxrs                              http://cxf.apache.org/schemas/jaxrs.xsd">        < import  resource="classpath:META-INF/cxf/cxf.xml" />      < import  resource="classpath:META-INF/cxf/cxf-servlet.xml" />        < bean  id="personService" class="demo.PersonService" />        < jaxrs:server  id="rs_server" address="/rs">          < jaxrs:serviceBeans >              < ref  bean="personService"/>          </ jaxrs:serviceBeans >      </ jaxrs:server > </ beans >

 web.xml 配置：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30

<? 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"      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">      < display-name >CxfRestWebservice</ display-name >      < welcome-file-list >          < welcome-file >index.html</ welcome-file >      </ welcome-file-list >        < context-param >          < param-name >contextConfigLocation</ param-name >          < param-value >classpath:demo/beans.xml</ param-value >      </ context-param >        < listener >          < listener-class >org.springframework.web.context.ContextLoaderListener</ listener-class >      </ listener >        < servlet >          < servlet-name >cxfservlet</ servlet-name >          < servlet-class >org.apache.cxf.transport.servlet.CXFServlet</ servlet-class >          < load-on-startup >1</ load-on-startup >      </ servlet >        < servlet-mapping >          < servlet-name >cxfservlet</ servlet-name >          < url-pattern >/webservice/*</ url-pattern >      </ servlet-mapping > </ web-app >

 通过浏览器访问：注意URL和配置文件的及参数的对应关系

 

OK 本文到此结束，这只是个入门级的简单实例，更多更复杂功能都是在此基础上演化而来，跟过更复杂的配置也是以此为基础，有兴趣可以继续挖掘研究。