SprimgMVC学习笔记(九)—— RESTful支持
一、什么是restful?
Restful就是一个资源定位及资源操作的风格,其核心是面向资源。不是标准也不是协议,只是一种风格。基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存等机制。REST提出设计概念和准则为:
1. 网络上的所有事物都可以被抽象为资源(resource)
2. 每一个资源都有唯一的资源标识(resource identifier),对资源的操作不会改变这些标识
3. 所有的操作都是无状态的
REST简化开发,其架构遵循CRUD原则,该原则告诉我们对于资源(包括网络资源)只需要四种行为:创建(Create),获取(Retrieve),更新(Update)和删除(Delete)就可以完成相关的操作和处理。我们可以通过统一资源标识符(Universal Resource Identifier,URI)来识别和定位资源,并且针对这些资源而执行的操作是通过 HTTP 规范定义的。其支持的四种核心操作分别为:
- GET – 获取信息/请求信息内容。绝大多数浏览器获取信息时使用该方式。
- POST – 添加信息内容。显示曾经的信息内容,能够看作是insert操作
- PUT – 更新信息内容。相当与update
- DELETE – 删除信息内容能够看作是delete
传统方式操作资源:
-
-
http://127.0.0.1/item/queryItem.action?id=1 查询,GET
-
http://127.0.0.1/item/saveItem.action 新增,POST
-
http://127.0.0.1/item/updateItem.action 更新,POST
-
http://127.0.0.1/item/deleteItem.action?id=1 删除,GET或POST
-
使用RESTful操作资源:
-
-
http://127.0.0.1/item/1 查询,GET
-
http://127.0.0.1/item 新增,POST
-
http://127.0.0.1/item 更新,PUT
-
http://127.0.0.1/item/1 删除,DELETE
-
二、RESTful入门案例
2.1 需求
使用RESTful方式实现商品信息查询,返回json数据
2.2 从URL上获取参数
使用RESTful风格开发的接口,根据id查询商品,接口地址是:http://127.0.0.1/item/1
我们需要从url上获取商品id,步骤如下:
-
使用注解@RequestMapping("item/{id}")声明请求的url
{xxx}叫做占位符,请求的URL可以是“item/1”或“item/2”
- 使用(@PathVariable() Integer id)获取url上的数据
/** * 使用RESTful风格开发接口,实现根据id查询商品 * * @param id * @return */ @RequestMapping("item/{id}") @ResponseBody public Item queryItemById(@PathVariable() Integer id) { Item item = this.itemService.queryItemById(id); return item; }
如果@RequestMapping中表示为"item/{id}",id和形参名称一致,@PathVariable不用指定名称。如果不一致,例如"item/{ItemId}"则需要指定名称@PathVariable("itemId")。
注意两个区别:
-
@PathVariable是获取url上数据的。@RequestParam获取请求参数的(包括post表单提交)
-
如果加上@ResponseBody注解,就不会走视图解析器,不会返回页面,而是返回json数据。如果不加,就走视图解析器,返回页面