构建RESTful应用接口

RESTful架构是目前最流行的互联网软件架构规范，是Web API（应用编程接口）的大趋势和主流规范，了解了RESTful的众多优点之后，接下来一步一步地学习如何使用Spring Boot构建RESTful Web API。

1.Spring Boot对RESTful的支持

Spring Boot提供的spring-boot-starter-web组件完全支持开发RESTful API，提供了与REST操作方式（GET、POST、PUT、DELETE）对应的注解：

1）@GetMapping：处理GET请求，获取资源。

2）@PostMapping：处理POST请求，新增资源。

3）@PutMapping：处理PUT请求，更新资源。

4）@DeleteMapping：处理DELETE请求，删除资源。

5）@PatchMapping：处理PATCH请求，用于部分更新资源。

通过这些注解就可以在Spring Boot项目中轻松构建RESTful接口。其中比较常用的是@GetMapping、@PostMapping、@PutMapping、@DeleteMapping四个注解。

使用Spring Boot开发RESTful接口非常简单，通过@RestController定义控制器，然后使用@GetMapping和@PostMapping等注解定义地址映射，实现相应的资源操作方法即可。

    @GetMapping(value="/user/{id}")public String getUserByID(@PathVariable int id){return "getUserByID:"+id;}@PostMapping(value="/user")public String save(User user) {return "save successed";}@PutMapping(value="/user")public String update(User user){return "update successed";}@DeleteMapping(value="/{id}")public String delete(@PathVariable int id){return "delete id:"+id;}

在上面的示例中，通过Spring Boot提供的@GetMapping等注解简单实现了对用户（user）的操作。其实，这些注解就是@RequestMapping注解的简化：

    @RequestMapping(value = "/user/(id}", method = RequestMethod.GET)public String getUserByID(@PathVariable int id){return "getUserByID:"+id;}@RequestMapping(value ="/user", method = RequestMethod.POST)public String save(User user) {return "save successed";}@RequestMapping(value ="/user", method = RequestMethod.PUT)public String update(User user){return "update successed";}@RequestMapping(value = "/user/{id}", method = RequestMethod.DELETE)public String delete(@PathVariable int id) {return "delete id:" + id;}

之前介绍的@RequestMapping注解通过method参数定义映射的HTTP请求方法，就相当于@RequestMapping+ RequestMethod的简化版。

我们看到，Get和Delete、Post和Put请求的URL是相同的，不同的Method（GET、PUT、POST、DELETE）会被映射到对应的处理方法上。这就是REST的魅力，简单明了的URL就能显示它的功能和作用。

2.Spring Boot实现RESTful API

接下来根据之前介绍的RESTful设计风格，以用户管理模块为例演示Spring Boot如何实现RESTful API。

步骤01 设计API。

在RESTful架构中，每个网址代表一种资源，所以URI中建议不要包含动词，只包含名词即可，而且所用的名词往往与数据库的表格名对应。下表是用户管理模块的接口定义，实际项目的RESTful API文档要更详细，还会定义全部请求的数据结构体。

在这里插入图片描述
表中定义了用户管理模块的接口，根据REST的定义，我们将用户定义为一种资源，通过POST、DELETE、PUT、GET等HTTP Method实现对用户的增、删、改、查。

可能大家会有疑问，为什么URI中没有我们习惯的getUser、saveUser这类路径？这正是RESTful优雅的地方，它将对资源的操作都定义在HTTP Method中，使得URL地址看起来更简洁。

除了设计URL接口之外，还需要定义服务端向客户端返回的状态码和提示信息。详细的状态码说明见下表。

在这里插入图片描述
表中除了定义用户管理相关的业务状态码之外，还需要定义通用的错误码，如400对应数据校验错误、401对应数据无权限等。

步骤02 实现用户管理接口。

上面定义了RESTful API以及接口返回的状态码，接下来根据之前的接口定义先创建UserController，再实现用户管理模块的用户新增、用户修改、用户删除、用户查询等接口。

1）用户新增：

    @PostMapping(value = "user")public JSONResult save(@RequestBody User user) {System.out.println("用户创建成功:" + user.getName());return JSONResult.ok(201,"用户创建成功");}

@PostMapping注解表示此为POST接口。通过POST方法传入用户数据，然后调用Save方法保存用户数据。

2）用户修改：

    @PutMapping(value = "user")public JSONResult update(@RequestBody User user) {System.out.println("用户修改成功:" + user.getName());return JSONResult.ok(203,"用户修改成功");}

3）用户删除：

    @DeleteMapping(value = "user/{userId}")public JSONResult delete(@PathVariable String userId) {System.out.println("用户删除成功:" + userId);return JSONResult.ok(204,"用户删除成功");}

@DeleteMapping注解表示此为删除接口。通过传入参数userId删除人员信息。

4）获取用户：

    @GetMapping(value = "user/{userId}")public JSONResult queryUserById(@PathVariable String userId) {User user = new User();user.setUserId(userId);user.setName("zhang");user.setAge(20);System.out.println("获取用户成功:" + userId);return JSONResult.ok(200,"获取用户成功",user);}