首页 > 代码库 > RESTful简单介绍(入门)
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="http://www.mamicode.com/ 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简单介绍(入门)