springmvc学习笔记(19)-RESTful支持

标签： springmvc

本文介绍RESTful的概念，并通过一个小样例展示怎样编写RESTful风格的controller和配置前端控制器，最后展示静态资源的解析

概念

首先附上两篇博客链接

• 理解RESTful架构 - 阮一峰的网络日志
• RESTful API 设计指南- 阮一峰的网络日志

RESTful架构。就是眼下最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便。所以正得到越来越多站点的採用。

RESTful（即Representational State Transfer的缩写）事实上是一个开发理念，是对http的非常好的诠释。

1.对url进行规范，写RESTful格式的url

• 非REST的url：http://...../queryItems.action?id=001&type=T01
• REST的url风格：http://..../items/001

特点：url简洁，将參数通过url传到服务端

2.http的方法规范

无论是删除、加入、更新，等等。使用url是一致的，假设进行删除，须要设置http的方法为delete，其它同理。

后台controller方法：推断http方法，假设是delete运行删除。假设是post运行加入。

3.对http的contentType规范

请求时指定contentType。要json数据。设置成json格式的type。

REST的样例

查询商品信息。返回json数据。

controller

定义方法，进行url映射使用REST风格的url，将查询商品信息的id传入controller .

输出json使用@ResponseBody将java对象输出json。

//查询商品信息，输出json
//itemsView/{id}里边的{id}表示占位符。通过@PathVariable获取占位符中的參数。
//@PathVariable中名称要和占位符一致，形參名无需和其一致
//假设占位符中的名称和形參名一致，在@PathVariable能够不指定名称
@RequestMapping("/itemsView/{id}")
public @ResponseBody ItemsCustom itemsView(@PathVariable("id") Integer items_id)throws Exception{//调用service查询商品信息ItemsCustom itemsCustom = itemsService.findItemsById(items_id);return itemsCustom;}

@RequestMapping(value="/ itemsView/{id}")：{×××}占位符。请求的URL能够是/viewItems/1或/viewItems/2，通过在方法中使用@PathVariable获取{×××}中的×××变量。

@PathVariable用于将请求URL中的模板变量映射到功能处理方法的參数上。

假设@RequestMapping中表示为/itemsView/{id}，id和形參名称一致，@PathVariable不用指定名称。

REST方法的前端控制器配置

<!-- springmvc前端控制器。rest配置 -->
<servlet><servlet-name>springmvc_rest</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><!-- contextConfigLocation配置springmvc载入的配置文件（配置处理器映射器、适配器等等） 假设不配置contextConfigLocation。默认载入的是/WEB-INF/servlet名称-serlvet.xml（springmvc-servlet.xml） --><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:spring/springmvc.xml</param-value></init-param>
</servlet><servlet-mapping><servlet-name>springmvc_rest</servlet-name><url-pattern>/</url-pattern>
</servlet-mapping>

訪问结果如图：

对静态资源的解析

配置前端控制器的url-parttern中指定/。对静态资源的解析会出现故障，报404错误。

在springmvc.xml中加入静态资源解析方法。

<!-- 静态资源解析包含 ：js、css、img、..-->
<mvc:resources location="/js/" mapping="/js/**"/>

这时訪问http://localhost:8080/ssm1/js/jquery-1.4.4.min.js，能够在浏览器中看到js的内容

作者@brianway很多其它文章：个人站点 | CSDN | oschina