RESTful

RESTFUL（Representational State Transfer）是一种网络应用程序的设计风格和开发方式，基于HTTP，可以使用XML格式定义或JSON格式定义。RESTFUL适用于移动互联网厂商作为业务使能接口的场景，实现第三方OTT调用移动网络资源的功能，动作类型为新增、变更、删除所调用资源。

Restful就是一个资源定位及资源操作的风格。不是标准也不是协议，只是一种风格。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。

---

功能

• 资源：互联网所有的事物都可以被抽象为资源

• 资源操作：使用POST、DELETE、PUT、GET，使用不同方法对资源进行操作。

• 分别对应 添加、 删除、修改、查询。

---

传统方式操作资源：通过不同的参数来实现不同的效果！方法单一，post 和 get

• 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

测试

1. 新建一个类 RestFulController

package com.hecn.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * @author hecn
 * @site hecn.gitee.io
 * @discription
 */
@Controller
public class RestFulController {
    @RequestMapping("/commit/{p1}/{p2}")
    public String index(@PathVariable int p1, @PathVariable int p2, Model model){
        int result=p1+p2;
        model.addAttribute("msg","结果"+result);
        return "test";
    }
}

2. 在Spring MVC中可以使用 @PathVariable 注解，让方法参数的值对应绑定到一个URI模板变量上。

3. 测试localhost:8080/commit/1/2(得到的结果为3)

4. 修改对应参数类型

//映射访问路径
@RequestMapping("/commit/{p1}/{p2}")
public String index(@PathVariable int p1, @PathVariable String p2, Model model){

    String result = p1+p2;
    //Spring MVC会自动实例化一个Model对象用于向视图中传值
    model.addAttribute("msg", "结果："+result);
    //返回视图位置
    return "test";

}

测试localhost:8080/commit/1/a(得到的结果为1a)

使用路径变量的好处？

• 使路径变得更加简洁；
• 获得参数更加方便，框架会自动进行类型转换。
• 通过路径变量的类型可以约束访问参数，如果类型不一样，则访问不到对应的请求方法，如这里访问是的路径是/commit/1/a，则路径与方法不匹配，而不会是参数转换失败。

---

使用method属性指定请求类型

用于约束请求的类型，可以收窄请求范围。指定请求谓词的类型如GET, POST, HEAD, OPTIONS, PUT, PATCH, DELETE, TRACE等。

method = {RequestMethod.GET}

• 增加一个方法

//映射访问路径,必须是GET请求
@RequestMapping(value = "/hello",method = {RequestMethod.GET})
    public String index2( Model model){
        model.addAttribute("msg","hello");
        return "test";
    }

小结:

1. Spring MVC 的@RequestMapping注解能够处理 HTTP 请求的方法, 比如 GET, PUT, POST, DELETE 以及 PATCH。

2. 所有的地址栏请求默认都会是 HTTP GET 类型的。

3. 方法级别的注解变体有如下几个： 组合注解

@GetMapping
@PostMapping
@PutMapping
@DeleteMapping
@PatchMapping

4. @GetMapping 是一个组合注解

   它所扮演的是 @RequestMapping(method =RequestMethod.GET) 的一个快捷方式。