理解Spring4.0新特性@RestController注解

最新推荐文章于 2022-07-18 17:12:57 发布

原创最新推荐文章于 2022-07-18 17:12:57 发布 · 287 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#json #java #runtime

spring 专栏收录该内容

2 篇文章

订阅专栏

本文探讨了Spring MVC中@Controller与@RestController的区别。@RestController是@Controller与@ResponseBody的组合，适用于RESTful Web服务开发，使得所有@RequestMapping方法默认拥有@ResponseBody语义。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

前两天学习微框架spring Boot时候在定义Controller类的时候习惯性的使用了@Controller此时发现无论怎么访问都访问不了,此时将@Controller改为@RestController便一切正常了。当时为了搞懂这两个注解查询了相关的资料，现在记录一下。

@RestController注解是它继承自@Controller注解。4.0之前的版本，spring MVC的组件都使用@Controller来标识当前类是一个控制器servlet。
使用这个特性，我们可以开发REST服务的时候不需要使用@Controller而专门的@RestController。

当你实现一个RESTful web services的时候，response将一直通过response body发送。为了简化开发，Spring 4.0提供了一个专门版本的controller。下面我们来看看@RestController实现的定义：

@Target(value=TYPE)  
 @Retention(value=RUNTIME)  
 @Documented  
 @Controller  
 @ResponseBody  
public @interface RestController

Spring的官方文档解释如下:

A convenience annotation that is itself annotated with @Controller and @ResponseBody. Types that carry this annotation are treated as controllers where @RequestMapping methods assume @ResponseBody semantics by default. 注解本身使用@Controller和@ResponseBody注解。使用了这个注解的类会被看作一个controller-使用@RequestMapping的方法有一个默认的@ResponseBody注解。 @ResponseBody – As of version 4.0 this annotation can also be added on the type level in which case is inherited and does not need to be added on the method level. @ResponseBody也可以加到类一级，通过继承方法一级不需要添加。

为了更加了解@RestController注解先了解一下@ResponseBody注解:
该注解用于将Controller的方法返回的对象，通过适当的HttpMessageConverter转换为指定格式后，写入到Response对象的body数据区。
使用时机：
返回的数据不是html标签的页面，而是其他某种格式的数据时（如json、xml等）使用；

当我们在Controller上标注了@RestController，这样相当于Controller的所有方法都标注了@ResponseBody