如何使用新方式编写Spring MVC接口

如何使用新方式编写Spring MVC接口

1. 前言

通常我们编写 Spring MVC 接口的范式是这样的：

@RestController

@RequestMapping("/v1/userinfo")

public class UserInfoController {

@GetMapping("/foo")

public String foo() {

return "felord.cn";

}

}

这种我都写吐了，今天换个口味，使用 Spring 5 新引入的函数式端点（Functional Endpoints）来耍耍。这种方式同样支持 Spring Webflux。

请注意可使用该特性的 Spring 版本不低于 Spring 5.2

2. 依赖

为了演示，这里极简化只引入 Spring MVC 的 starter :

org.springframework.boot

spring-boot-starter-web

3. RouterFunction

在函数式端点的写法中，传统的请求映射(@RequestMapping)被路由函数(RouterFunction)所代替。上面的写法等同于：

@Bean

public RouterFunction fooFunction() {

return RouterFunctions.route()

.GET("/v1/userinfo/foo", request -> ServerResponse.ok()

.body("felord.cn"))

.build();

}

在该示例中，我使用了 RouterFunctions.route() 创建了一个RouterFunction，然后RouterFunction 提供了从请求到响应的细节操作。

4. ServerRequest/ServerResponse

ServerRequest 是对服务器端的 HTTP 请求的抽象，你可以通过该抽象获取请求的细节。对应的，ServerResponse 是对服务器端响应的抽象，你也可以通过该抽象构建响应的细节。这两个概念由下面的 HandlerFunction 接口进行 请求 → 响应 处理。

5. HandlerFunction

HandlerFunction 是一个函数式接口，它提供了从请求( ServerRequest)到响应(ServerResponse)的函数映射抽象。通常你的业务逻辑由该接口进行实现。从 ServerRequest 中获取请求的细节，然后根据业务构建一个 ServerResponse 响应。

HandlerFunction handlerFunction = request -> ServerResponse.ok().body("felord.cn");

6. RequestPredicate

RequestPredicate 可以让你根据请求的一些细节，比如 请求方法、请求头、请求参数等等进行断言以决定是否路由。

这里举一个例子，假如我们希望请求接口/v1/userinfo/predicate时根据不同的参数处理不同的业务，当携带参数 plan时才能进行处理。我们可以这么写：

@Bean

public RouterFunction predicateFunction() {

return RouterFunctions.route()

.GET("/v1/userinfo/predicate",

request -> request.param("plan").isPresent(),

request -> ServerResponse.ok().body("felord.cn"))

.build();

}

然后我们测试一下：

当携带参数 plan时：

GET http://localhost:8080/v1/userinfo/predicate?plan=

HTTP/1.1 200

Content-Type: text/plain;charset=UTF-8

Content-Length: 9

Date: Thu, 14 May 2020 07:57:35 GMT

Keep-Alive: timeout=60

Connection: keep-alive

felord.cn

不携带参数plan时:

GET http://localhost:8080/v1/userinfo/predicate

HTTP/1.1 404

Vary: Origin

Vary: Access-Control-Request-Method

Vary: Access-Control-Request-Headers

Content-Type: application/json

Transfer-Encoding: chunked

Date: Thu, 14 May 2020 08:00:15 GMT

Keep-Alive: timeout=60

Connection: keep-alive

{

"timestamp": "2020-05-14T08:00:15.659+0000",

"status": 404,

"error": "Not Found",

"message": "No message available",

"path": "/v1/userinfo/predicate"

}

7. 小结

函数式端点是 Spring 5 提供的一个新的接口范式风格，对于 Spring MVC 来说 Spring 5.2 才进行了支持。也是顺应函数式编程的一个未来趋势。

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。