|
对于最新稳定版本，请使用 Spring Framework 7.0.6！ |
@Controller
你可以使用标准的 Spring Bean 定义来定义控制器 Bean。
@Controller 刻板注解（stereotype）支持自动检测，并与 Spring 对在类路径中检测 @Component 类并自动注册其 Bean 定义的通用支持保持一致。它还作为被注解类的刻板注解，表明该类作为 Web 组件的角色。
要启用对此类 @Controller bean 的自动检测，您可以将组件扫描添加到您的 Java 配置中，如下例所示：
-
Java
-
Kotlin
@Configuration
@ComponentScan("org.example.web") (1)
public class WebConfig {
// ...
}| 1 | 扫描 org.example.web 包。 |
@Configuration
@ComponentScan("org.example.web") (1)
class WebConfig {
// ...
}| 1 | 扫描 org.example.web 包。 |
@RestController 是一个组合注解，
它本身通过元注解方式标注了 @Controller 和 @ResponseBody，
表示该控制器的所有方法都继承了类级别的 @ResponseBody 注解，
因此会直接将内容写入响应体，而不是通过视图解析并使用 HTML 模板进行渲染。
AOP 代理
在某些情况下，你可能需要在运行时使用 AOP 代理来包装控制器。
一个例子是，如果你选择直接在控制器上使用 @Transactional 注解。
在这种情况下，特别是对于控制器，我们建议使用基于类的代理。
当你直接在控制器上使用此类注解时，Spring 会自动采用这种方式。
如果控制器实现了某个接口，并且需要 AOP 代理，则可能需要显式配置基于类的代理。例如，使用 @EnableTransactionManagement 时，可以更改为 @EnableTransactionManagement(proxyTargetClass = true)；使用 <tx:annotation-driven/> 时，可以更改为 <tx:annotation-driven proxy-target-class="true"/>。
请注意，从 6.0 版本开始，在使用接口代理的情况下，Spring WebFlux 不再仅根据接口上类型级别的 @RequestMapping 注解来检测控制器。
请启用基于类的代理，否则该接口还必须添加 @Controller 注解。 |