RESTful简单介绍(入门)

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了RESTful简单介绍(入门)相关的知识,希望对你有一定的参考价值。

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      访问

技术分享

 

以上是关于RESTful简单介绍(入门)的主要内容,如果未能解决你的问题,请参考以下文章

MongoDB最简单的入门教程之五-通过Restful API访问MongoDB

beego框架入门

RESTful入门

RESTful WebService入门转

快速入门系列--WCF--03RESTFUL服务与示例

python RESTful API框架:Eve 高速入门