Spring Boot Web请求与响应
Spring Boot 是一个用于简化 Spring 应用程序开发的框架，它通过约定优于配置的方式，使得开发者能够快速构建具有高质量和高效率的应用。其中，处理 Web 请求与响应是 Spring Boot 的一项重要功能。本文将介绍如何在 Spring Boot 中处理 Web 请求与响应，包括使用控制器、请求映射、请求参数以及响应数据的返回。
1. 创建 Spring Boot 项目
首先，确保您已经创建了一个 Spring Boot 项目，可以使用 Spring Initializr 生成一个包含 Web 依赖的项目。您可以选择 Maven 或 Gradle 作为构建工具。确保添加以下依赖：
<!-- Maven 依赖示例 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
2. 创建控制器
控制器是处理请求的核心部分。在 Spring Boot 中，可以使用 @RestController 注解来定义一个控制器，它将自动将返回的对象转换为 JSON 格式的响应。
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/api")
public class MyController {
@GetMapping("/hello")
public String sayHello() {
return "你好，Spring Boot!";
}
@GetMapping("/greet")
public String greet(@RequestParam String name) {
return "你好，" + name + "!";
}
@PostMapping("/echo")
public String echo(@RequestBody String message) {
return "你说的是: " + message;
}
}
在上面的代码中，我们定义了一个 MyController 控制器，并提供了三个方法：
sayHello：处理 GET 请求，返回一条简单的问候信息。greet：接受一个请求参数name，返回个性化的问候信息。echo：处理 POST 请求，接收请求体中的消息并回显。
3. 请求参数与路径变量
除了简单的请求处理，我们还可以处理请求参数和路径变量。例如，假设我们希望通过 URL 中的路径变量来获取用户的信息：
@GetMapping("/user/{id}")
public String getUserById(@PathVariable String id) {
return "用户ID: " + id;
}
以上代码通过 @PathVariable 注解来获取 URL 路径中的 id 值。
4. 响应数据格式
Spring Boot 默认返回 JSON 格式的数据，如果你需要返回其他格式，例如 XML，可以在 pom.xml 中添加相关依赖，或者通过自定义 MessageConverter 实现。以下是返回 JSON 数据的示例：
@GetMapping("/user")
public User getUser() {
return new User(1, "张三", "zhangsan@example.com");
}
其中，User 类可以是：
public class User {
private int id;
private String name;
private String email;
// 构造器、 getters 和 setters
}
在响应时，Spring Boot 会自动将 User 对象转换为 JSON 格式，响应内容如下：
{
"id": 1,
"name": "张三",
"email": "zhangsan@example.com"
}
5. 处理异常
在 Web 应用中，异常处理是一个重要的方面。Spring Boot 提供了 @ControllerAdvice 注解来全球处理异常：
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(Exception.class)
@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
public String handleException(Exception e) {
return "发生错误: " + e.getMessage();
}
}
以上代码将捕获所有未处理的异常，并返回 500 错误及错误信息。
6. 小结
通过 Spring Boot，我们可以轻松地处理 Web 请求与响应。通过简单的注解配置，我们可以快速构建 RESTful API，包括请求参数的处理、响应数据的返回以及异常的全局处理。随着应用的复杂性增加，您可以根据需要进一步扩展和自定义这些功能。希望通过本文的介绍，您能够对 Spring Boot 的 Web 开发有一个初步的认识和理解。
