文章目录:
1.一些新的注解
@RestController:Spring 4 后新增注解,是@Controller注解功能的增强,是 @Controller 与 @ResponseBody 的组合注解。
如果一个 Controller 类添加了@RestController,那么该Controller 类下的所有方法都相当于添加了@ResponseBody 注解,用于返回字符串或 json 数据。
1.2 @RequestMapping(常用)
支持 Get 请求,也支持Post 请求
@RequestMapping 和 Get 请求方法的组合,只支持Get 请求,Get 请求主要用于查询操作。
@RequestMapping 和 Post 请求方法的组合,只支持 Post 请求,Post 请求主要用户新增数据。
@RequestMapping 和 Put 请求方法的组合,只支持Put 请求,Put 通常用于修改数据。
@RequestMapping 和 Delete 请求方法的组合,只支持 Delete 请求,通常用于删除数据。
获取 url 中的数据,该注解是实现RESTful最主要的一个注解。
2.SpringBoot实现RESTful风格
REST (英文:Representational State Transfer ,简称REST )
一种互联网软件架构设计的风格,但它并不是标准,它只是提出了一组客户端和服务器交互时的架构理念和设计原则,基于这种理念和原则设计的接口可以更简洁,更有层次,REST这个词,是 Roy Thomas Fielding 在他2000 年的博士论文中提出的。
任何的技术都可以实现这种理念,如果一个架构符合 REST 原则,就称它为 RESTFul 架构。
比如我们要访问一个 http 接口:http://localhost:8080/springboot/order?id=1021&status=1
采用 RESTFul 风格则 http 地址为:http://localhost:8080/springboot/order/1021/1
2.1 实例代码
首先是一个实体类
package com.songzihao.springboot.entity; public class Student { private Integer id; private String name; private Integer age; //getter and setter }
然后是我们的控制层
package com.songzihao.springboot.controller; import org.springframework.web.bind.annotation.*; import java.util.HashMap; import java.util.Map; /** * */ @RestController //相当于是 @Controller 与 @ResponseBody 的组合注解,意味着当前控制层类中的所有方法返回的都是Json对象 public class StudentController { @GetMapping(value = "/student/{id}/{age}") public Object student(@PathVariable("id") Integer id, @PathVariable("age") Integer age) { Map<String,Object> map=new HashMap<>(); map.put("id",id); map.put("age",age); return map; } @DeleteMapping(value = "/student/detail/{id}/{status}") public Object student2(@PathVariable("id") Integer id, @PathVariable("status") Integer status) { Map<String,Object> map=new HashMap<>(); map.put("id",id); map.put("status",status); return map; } @DeleteMapping(value = "/student/{id}/detail/{phone}") public Object student3(@PathVariable("id") Integer id, @PathVariable("phone") Integer phone) { Map<String,Object> map=new HashMap<>(); map.put("id",id); map.put("phone",phone); return map; } @PostMapping(value = "/student/{id}") public String addStudent(@PathVariable("id") Integer id) { return "add student ID: " + id; } @PutMapping(value = "/student/{id}") public String updateStudent(@PathVariable("id") Integer id) { return "update student ID: " + id; } }
接下来是springboot的核心配置文件
server.port=8082 server.servlet.context-path=/springboot
最后通过springboot项目入口类启动
package com.songzihao.springboot; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } }
由于请求方式的不同(有GET、POST、PUT、DELETE),这里我使用Postman工具来模拟发送请求,查看测试结果。
2.3 DELETE请求方式
2.4 POST请求方式
2.5 PUT请求方式
3.RESTful风格中请求冲突的问题
对于下面这两段代码,就会出现请求冲突的问题。
@DeleteMapping(value = "/student/detail/{id}/{status}") public Object student2(@PathVariable("id") Integer id, @PathVariable("status") Integer status) { Map<String,Object> map=new HashMap<>(); map.put("id",id); map.put("status",status); return map; }
@DeleteMapping(value = "/student/detail/{id}/{phone}") public Object student2(@PathVariable("id") Integer id, @PathVariable("phone") Integer phone) { Map<String,Object> map=new HashMap<>(); map.put("id",id); map.put("phone",phone); return map; }
因为当我们发起请求之后,服务器并不知道这个地址 http://localhost:8082/springboot/student/1001/666 对应的是那个方法
解决的方法有两个:
1. 修改路径。(见下面的代码)
2. 修改请求方式。(这个意思是说,将请求方式由DELETE改为其他三种,所以就不再举例了)
@DeleteMapping(value = "/student/detail/{id}/{status}") public Object student2(@PathVariable("id") Integer id, @PathVariable("status") Integer status) { Map<String,Object> map=new HashMap<>(); map.put("id",id); map.put("status",status); return map; }
@DeleteMapping(value = "/student/{phone}/detail/{id}") public Object student3(@PathVariable("id") Integer id, @PathVariable("phone") Integer phone) { Map<String,Object> map=new HashMap<>(); map.put("id",id); map.put("phone",phone); return map; }