如何使用新方式编写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 :
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>
3. RouterFunction
在函数式端点的写法中,传统的请求映射(@RequestMapping)被路由函数(RouterFunction)所代替。上面的写法等同于:
@Bean public RouterFunction<ServerResponse> 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<ServerResponse> handlerFunction = request -> ServerResponse.ok().body('felord.cn');
6. RequestPredicate
RequestPredicate 可以让你根据请求的一些细节,比如 请求方法、请求头、请求参数等等进行断言以决定是否路由。
这里举一个例子,假如我们希望请求接口/v1/userinfo/predicate时根据不同的参数处理不同的业务,当携带参数 plan时才能进行处理。我们可以这么写:
@Bean public RouterFunction<ServerResponse> 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 200Content-Type: text/plain;charset=UTF-8Content-Length: 9Date: Thu, 14 May 2020 07:57:35 GMTKeep-Alive: timeout=60Connection: keep-alive
felord.cn
不携带参数plan时:
GET http://localhost:8080/v1/userinfo/predicateHTTP/1.1 404Vary: OriginVary: Access-Control-Request-MethodVary: Access-Control-Request-HeadersContent-Type: application/jsonTransfer-Encoding: chunkedDate: Thu, 14 May 2020 08:00:15 GMTKeep-Alive: timeout=60Connection: 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 才进行了支持。也是顺应函数式编程的一个未来趋势。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持好吧啦网。
相关文章: