SpringBoot中的请求处理(超详细)：涵盖原理、注解、参数绑定和请求映射

2023-10-01 09:46:06

前言

大家好，一直以来我都本着“用最通俗的话理解核心的知识点”，我认为所有的难点都离不开“基础知识”的铺垫。本篇文章面向学完Java基础，想通过Java快速构建Web应用程序，或者想学习或了解SpringBoot的人群。

请求处理原理

SpringBoot采用Spring MVC框架处理请求。当客户端向SpringBoot应用程序发送HTTP请求时，Spring MVC会根据请求的URL找到对应的控制器方法，并调用该方法处理请求。控制器方法处理完成后，会将结果返回给客户端。

SpringBoot支持多种HTTP方法，包括GET、POST、PUT、DELETE等。这些方法用于指定客户端请求资源时希望执行的操作。例如，GET方法用于获取资源，POST方法用于创建资源，PUT方法用于更新资源，DELETE方法用于删除资源。

注解

SpringBoot提供了丰富的注解来简化请求处理。这些注解包括：

@RequestMapping：用于映射请求路径到控制器方法。
@GetMapping：用于映射GET请求。
@PostMapping：用于映射POST请求。
@PutMapping：用于映射PUT请求。
@DeleteMapping：用于映射DELETE请求。
@PathVariable：用于获取请求路径中的变量。
@RequestParam：用于获取请求参数。
@RequestBody：用于获取请求体。

参数绑定

SpringBoot提供了强大的参数绑定功能，可以自动将请求参数绑定到控制器方法的参数上。这使得开发人员无需手动解析请求参数，大大简化了代码编写。

SpringBoot支持绑定多种类型的参数，包括基本数据类型、字符串、集合、对象等。

请求映射

SpringBoot使用@RequestMapping注解来映射请求路径到控制器方法。@RequestMapping注解可以放在类上或方法上。

当@RequestMapping注解放在类上时，表示该类下的所有方法都映射到该路径。

当@RequestMapping注解放在方法上时，表示该方法映射到该路径。

路径变量

SpringBoot支持使用路径变量来获取请求路径中的变量。路径变量使用{}括起来。

例如，以下控制器方法映射到/user/{id}路径：

@GetMapping("/user/{id}")
public User getUserById(@PathVariable Long id) {
    return userService.getUserById(id);
}

当客户端向/user/1发送GET请求时，@PathVariable注解会将路径变量id的值（即1）绑定到控制器方法的参数id上。

请求体

SpringBoot支持使用@RequestBody注解来获取请求体。@RequestBody注解只能放在方法参数上。

例如，以下控制器方法映射到/user路径，并使用@RequestBody注解获取请求体：

@PostMapping("/user")
public User createUser(@RequestBody User user) {
    return userService.createUser(user);
}

当客户端向/user发送POST请求时，@RequestBody注解会将请求体中的JSON数据反序列化为Java对象，并绑定到控制器方法的参数user上。

响应

SpringBoot支持使用@ResponseBody注解来将控制器方法的返回值直接输出到响应体中。

例如，以下控制器方法映射到/user路径，并使用@ResponseBody注解将返回值输出到响应体中：

@GetMapping("/user")
@ResponseBody
public List<User> getAllUsers() {
    return userService.getAllUsers();
}

当客户端向/user发送GET请求时，控制器方法getAllUsers()会返回所有用户列表。@ResponseBody注解会将用户列表序列化为JSON数据，并输出到响应体中。

错误处理

SpringBoot提供了丰富的错误处理机制，可以帮助开发人员轻松处理错误。

SpringBoot支持使用@ExceptionHandler注解来处理异常。@ExceptionHandler注解可以放在类上或方法上。

当@ExceptionHandler注解放在类上时，表示该类下的所有方法都可以处理该异常。

当@ExceptionHandler注解放在方法上时，表示该方法可以处理该异常。

例如，以下控制器类使用@ExceptionHandler注解处理NullPointerException异常：

@RestController
public class UserController {

    @GetMapping("/user/{id}")
    public User getUserById(@PathVariable Long id) {
        return userService.getUserById(id);
    }

    @ExceptionHandler(NullPointerException.class)
    public ResponseEntity<String> handleNullPointerException(NullPointerException ex) {
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("用户不存在");
    }
}

当客户端向/user/1发送GET请求时，如果用户不存在，getUserById()方法会抛出NullPointerException异常。@ExceptionHandler注解会将该异常映射到handleNullPointerException()方法。handleNullPointerException()方法会返回一个HTTP 400 Bad Request响应，并输出错误消息"用户不存在"。