Spring Web MVC实现Restful Web Service

   

一引言：

之前一说到Web Service你们确定会联想到SOAP，如今提到Web Service你们立刻联想到RESTful,由于RESTful Web Service已经深得人心，获得重用，相比笨重的SOAP愈来愈流行了，那么什么是RESTful Web Service？REST英文全称为Representational State Transfer，翻译为中文即表征状态转移，是一种软件架构风格，REST关键原则为：

1. 为全部“事物”定义ID

2. 将全部事物连接在一块儿

3. 使用标准方法

4. 资源多重表述

5. 无状态通讯

RESTful Web Service 是一个使用HTTP并遵循REST原则的Web服务。它从三个方面资源进行定义：

1. URI，好比：http://example.com/resources/。

2. Web Service接受与返回的互联网媒体类型，好比：JSON，XML等。

3. Web Service在该资源上所支持的一系列请求方法（好比：POST，GET，PUT或DELETE）。

HTTP 请求方法在RESTful Web 服务中的典型应用
资源	GET	PUT	POST	DELETE
一组资源的URI，好比http://example.com/resources/	列出 URI，以及该资源组中每一个资源的详细信息（后者可选）。	使用给定的一组资源替换当前整组资源。	在本组资源中建立/追加一个新的资源。该操做每每返回新资源的URL。	删除整组资源。
单个资源的URI，好比http://example.com/resources/142	获取指定的资源的详细信息，格式能够自选一个合适的网络媒体类型（好比：XML、JSON等）	替换/建立指定的资源。并将其追加到相应的资源组中。	把指定的资源当作一个资源组，并在其下建立/追加一个新的元素，使其隶属于当前资源。	删除指定的元素。

二SpringMVC对RESTful Web Service的支持：

1.将URI和HTTP请求方法映射到JAVA处理方法，并将JAVA方法处理结果返回给HTTP请求者（对应资源定义I和III）。

@RequestMapping

这是最重要的一个注解，用于处理HTTP请求地址映射，可用于类或方法上，用于类上时表示类中的全部响应请求的方法都是以该地址做为父路径，在Spring中，通常一个Controller类处理一种资源，因此每一个Controller类都会加@RequestMapping注解。

经常使用属性：

value：指定请求的地址

method：指定请求的method类型， GET、POST、PUT、DELETE等

params：指定request中必须包含某些参数值是，才让该方法处理

1 2 3 4 5 6 7 8 9 10 11

@Controller @RequestMapping (value =  "/contact" ) public  class  ContactController {      final  Logger logger = LoggerFactory.getLogger(ContactController. class );      @Autowired      private  ContactService contactService;      @RequestMapping (value =  "/listdata" , method = RequestMethod.GET)      @ResponseBody      public  Contacts listData() {          return  new  Contacts(contactService.findAll());      }

@PathVariable

映射URL路径里面的参数

1 2 3 4 5

@RequestMapping (value =  "/{id}" , method = RequestMethod.GET)      @ResponseBody      public  Contact findContactById( @PathVariable  Long id) {          return  contactService.findById(id);      }

2.将接收的数据（如JSON格式数据）转换为JAVA对象和将JAVA对象转换为请求格式（如XML）的数据（对应资源定义II）。

@RequestBody

用于读取Request请求的body数据，使用Bean配置中的 HttpMessageConverter 将数据转换为JAVA对象，再把对象绑定到 controller中方法的参数上。

1 2 3 4 5 6 7 8

@RequestMapping (value =  "/" , method = RequestMethod.POST)      @ResponseBody      public  Contact create( @RequestBody  Contact contact) {          logger.info( "Creating contact: "  + contact);          contactService.save(contact);          logger.info( "Contact created successfully with info: "  + contact);          return  contact;      }

@ResponseBody

用于将Controller中方法返回的对象，使用Bean配置中的 HttpMessageConverter 转换为指定格式数据，再写入到Response对象的body数据区。

1 2 3 4 5

@RequestMapping (value =  "/listdata" , method = RequestMethod.GET)      @ResponseBody      public  Contacts listData() {          return  new  Contacts(contactService.findAll());      }

HttpMessageConverter配置示例：

1 2 3 4 5 6 7 8 9 10

< mvc:annotation-driven >          < mvc:message-converters >              < bean  class = "org.springframework.http.converter.json.MappingJackson2HttpMessageConverter" />              < bean                  class = "org.springframework.http.converter.xml.MarshallingHttpMessageConverter" >                  < property  name = "marshaller"  ref = "castorMarshaller"  />                  < property  name = "unmarshaller"  ref = "castorMarshaller"  />              </ bean >          </ mvc:message-converters >      </ mvc:annotation-driven >

默认状况下Spring已经启用了不少HttpMessageConverter，只要将他们的实如今类路径下便可，无需再配置。

• ByteArrayHttpMessageConverter – converts byte arrays

• StringHttpMessageConverter – converts Strings

• ResourceHttpMessageConverter – converts org.springframework.core.io.Resource for any type of octet stream

• SourceHttpMessageConverter – converts javax.xml.transform.Source

• FormHttpMessageConverter – converts form data to/from a MultiValueMap<String, String>.

• Jaxb2RootElementHttpMessageConverter – converts Java objects to/from XML (added only if JAXB2 is present on the classpath)

• MappingJackson2HttpMessageConverter – converts JSON (added only if Jackson 2 is present on the classpath)

• MappingJacksonHttpMessageConverter – converts JSON (added only if Jackson is present on the classpath)

• AtomFeedHttpMessageConverter – converts Atom feeds (added only if Rome is present on the classpath)

• RssChannelHttpMessageConverter – converts RSS feeds (added only if Rome is present on the classpath)

Spring作得太贴心了，因此开发者简单配置就搞定RESTful WebService功能，而后就可专一于业务逻辑实现上。

本文出自 “力量来源于赤诚的爱！” 博客，请务必保留此出处http://stevex.blog.51cto.com/4300375/1355154