注解 - @ResponseBody

2025/9/20 1:37:54 来源：https://blog.csdn.net/run65536/article/details/139524782 浏览: 次关键词：注解 - @ResponseBody

注解简介

在今天的每日一注解中，我们将探讨@ResponseBody注解。@ResponseBody是Spring框架中的一个注解，用于将控制器方法的返回值直接写入HTTP响应体中。

注解定义

@ResponseBody注解用于将控制器方法的返回值直接作为HTTP响应体返回，而不是将其解析为视图名称。以下是一个基本的示例：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/api")
public class MyController {@GetMapping("/message")@ResponseBodypublic String getMessage() {return "Hello, World!";}
}

注解详解

@ResponseBody注解使得控制器方法返回的对象会通过适当的消息转换器（如Jackson）转换为指定格式（如JSON、XML），然后写入HTTP响应体中。通常与@RestController注解一起使用，因为@RestController本身就是一个组合注解，包含了@Controller和@ResponseBody。

用途：将方法返回值直接写入HTTP响应体，适用于RESTful服务。

使用场景

@ResponseBody广泛用于Spring MVC和Spring Boot应用程序中，用于构建RESTful API。它使得返回的Java对象能够直接被客户端（如Web浏览器或移动应用）以JSON或XML格式消费。

示例代码

以下是一个使用@ResponseBody注解的代码示例，展示了如何返回JSON格式的响应：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.RestController;import java.util.HashMap;
import java.util.Map;@RestController
@RequestMapping("/api")
public class UserController {@GetMapping("/userinfo")@ResponseBodypublic Map<String, String> getUserInfo() {Map<String, String> userInfo = new HashMap<>();userInfo.put("name", "John Doe");userInfo.put("email", "john.doe@example.com");return userInfo;}@GetMapping("/welcome")@ResponseBodypublic String welcomeMessage() {return "Welcome to the Spring Boot application!";}
}

常见问题

问题：为什么@ResponseBody注解不起作用？

解决方案：确保类上有@RestController或方法上有@ResponseBody注解。@RestController自动包含@ResponseBody功能。

@RestController
public class MyController {@GetMapping("/test")public String test() {return "This is a test response";}
}

问题：如何返回不同格式的数据？

解决方案：可以通过配置消息转换器（如Jackson或Gson）自动将Java对象转换为JSON或XML格式。确保你的Spring应用程序中包含了相应的依赖。

// 在Spring Boot项目中，通常只需添加Jackson依赖即可：<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.13.3</version>
</dependency>