RESTful简单介绍（入门）

Posted 2020-08-20

1.1      什么是RESTful

http://www.ruanyifeng.com/blog/2011/09/restful.html

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。。

 

1.2      REST的例子

1.2.1     需求

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

 

1.2.2     controller

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

 

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

 1     //查询商品信息，输出json
 2     ///itemsView/{id}里边的{id}表示占位符，通过@PathVariable获取占位符中的参数，
 3     //如果占位符中的名称和形参名一致，在@PathVariable可以不指定名称
 4     @RequestMapping("/itemsView/{id}")
 5     public @ResponseBody ItemsCustom itemsView(@PathVariable("id") Integer id)throws Exception{
 6         
 7         //调用service查询商品信息
 8         ItemsCustom itemsCustom = itemsService.findItemsById(id);
 9         
10         return itemsCustom;
11         
12     }

 

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

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

如果RequestMapping中表示为"/ itemsView /{id}"，id和形参名称一致，@PathVariable不用指定名称。

 

 

1.2.3     REST方法的前端控制器配置

 

在web.xml配置：

 1     <!-- springmvc前端控制器 -->
 2     <servlet>
 3         <servlet-name>springmvc</servlet-name>
 4         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
 5         <!-- contextConfigLocation配置springmvc加载的配置文件（配置处理器映射器、适配器等等） 如果不配置contextConfigLocation，默认加载的是/WEB-INF/servlet名称-serlvet.xml（springmvc-servlet.xml） -->
 6         <init-param>
 7             <param-name>contextConfigLocation</param-name>
 8             <param-value>classpath:spring/springmvc.xml</param-value>
 9         </init-param>
10     </servlet>
11 
12     <servlet-mapping>
13         <servlet-name>springmvc</servlet-name>
14         <!-- 第一种：*.action，访问以.action结尾 由DispatcherServlet进行解析 
15             第二种：/，所以访问的地址都由DispatcherServlet进行解析，对于静态文件的解析需要配置不让DispatcherServlet进行解析 
16             使用此种方式可以实现 RESTful风格的url 
17             第三种：/*，这样配置不对，使用这种配置，最终要转发到一个jsp页面时， 仍然会由DispatcherServlet解析jsp地址，不能根据jsp页面找到handler，会报错。 -->
18         <url-pattern>*.action</url-pattern>
19     </servlet-mapping>
20     
21     
22     <!-- springmvc前端控制器，rest配置 -->
23     <servlet>
24         <servlet-name>springmvc_rest</servlet-name>
25         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
26         <!-- contextConfigLocation配置springmvc加载的配置文件（配置处理器映射器、适配器等等） 如果不配置contextConfigLocation，默认加载的是/WEB-INF/servlet名称-serlvet.xml（springmvc-servlet.xml） -->
27         <init-param>
28             <param-name>contextConfigLocation</param-name>
29             <param-value>classpath:spring/springmvc.xml</param-value>
30         </init-param>
31     </servlet>
32 
33     <servlet-mapping>
34         <servlet-name>springmvc_rest</servlet-name>
35         <url-pattern>/</url-pattern>
36     </servlet-mapping>

 

1.3      对静态资源的解析

 

配置前端控制器的url-parttern中指定/，对静态资源的解析出现问题：

 

 

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

1     <!-- 静态资源解析
2     包括 ：js、css、img、..
3      -->
4      <mvc:resources location="/js/" mapping="/js/**"/>
5      <mvc:resources location="/img/" mapping="/img/**"/>

1.4      访问