一、什么是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,步骤如下:

  1. 使用注解@RequestMapping("item/{id}")声明请求的url
    {xxx}叫做占位符,请求的URL可以是“item/1”或“item/2” 
  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数据。如果不加,就走视图解析器,返回页面