spring - Spring 5 WebFlux 中 @Controller 和 RouterFunction 的区别

Question

现在有两种方法可以在 Spring 5 中公开 HTTP 端点。

@Controller或 @RestController通过制作 Controller 的类，例如

@RestController
@RequestMapping("persons")
public class PersonController { 

    @Autowired
    private PersonRepo repo;

    @GetMapping("/{id}")
    public Mono<Person> personById(@PathVariable String id){
        retrun repo.findById(id);
    }
}

路线在@Configuration使用 RouterFunctions 类:

@Bean
public RouterFunction<ServerResponse> personRoute(PersonRepo repo) {
    return route(GET("/persons/{id}"), req -> Mono.justOrEmpty(req.pathVariable("id"))                                             
                                                 .flatMap(repo::getById)
                                                 .flatMap(p -> ok().syncBody(p))
                                                 .switchIfEmpty(notFound().build()));
}

使用任何人的方法是否有任何性能差异？从头开始编写应用程序时应该使用哪一个。

Answer 1

编程范式:命令式 vs 函数式
在 @Controller 的情况下或 @RestController注释，我们同意基于注释的模型，在该模型中，我们使用注释进行映射(不仅限于)，因此会产生副作用(在功能世界中是不允许的)来使我们的 API 正常工作。这种副作用可能是@Valid为请求的主体或 @RequestMapping 提供内置 bean 验证的注解与整个 Controller 的根路径。
另一方面，通过路由器功能，我们摆脱了由 API 实现方面的任何副作用组成的注释，并将其直接委托(delegate)给功能链:router -> handler .这两个非常适合构建基本的 react block :一系列事件和两个主角，一个发布者和这些事件的订阅者。
MVC 传统:Servlet 堆栈与 Netty 堆栈
当我们谈论 @Controller我想说，我们通常会从同步 Java 世界的角度来思考:Servlets , ServletContext , ServletContainerInitializer , DispatcherServlet 等等，即使我们会返回 Mono从 Controller 到使我们的应用程序具有响应性，我们仍然会使用 Servlet 3.0支持 java.nio.* 的规范并在相同的 servlet 容器上运行，例如 Jetty或 Tomcat .随后，在这里我们将使用相应的设计模式和方法来构建 Web 应用程序。RouterFunction另一方面，受到源自异步 Java 世界的真正响应式(Reactive)方法的启发 - Netty及其Channel Model .
随后出现了一组用于响应式(Reactive)环境的新类及其 API:ServerRequest , ServerResponse , WebFilter和别的。至于我，它们是由 Spring 团队根据前几年维护框架和理解新的 Web 系统需求而设计的。这些要求的名称是 Reactive Manifesto .
用例
最近我的团队遇到了无法集成的问题Swagger与 RouterFucntion端点。它可以支持 @Controlers ，但 Spring 团队介绍了他们的解决方案 - Spring REST Docs可以很容易地连接到响应式(Reactive) WebTestClient .我在这里使用“连接”这个词，因为它遵循真正的响应式(Reactive)含义:而不是 Swagger 的重载配置和副作用注释，您可以轻松地在测试中构建您的 API 文档，而无需触及您的工作代码。
2020 年更新 :尽管现在 Spring Webflux 已经可以随后使用 OpenAPI 规范与 Swagger 集成，但它仍然缺乏配置的简单性和透明度，在我看来，这是作为古老 MVC 方法的一部分的结果。
关闭(意见)
没有性能影响的原因可能会听到类似于“它绝对基于个人偏好使用什么”的内容。我同意这确实是两种选择中的个人偏好:当您让自己在同一个领域停留十年时，前进或后退。我认为对 @Controller 的 react 性支持由 Spring 团队完成，以使旧项目能够以某种方式与时间要求保持一致，并至少有机会进行迁移。
如果您要从头开始创建 Web 应用程序，请不要犹豫并使用引入的响应式堆栈。