换一种方式编写 Spring MVC 接口
2020/5/15 14:25:34
本文主要是介绍换一种方式编写 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 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 才进行了支持。也是顺应函数式编程的一个未来趋势。由于篇幅原因这里仅仅对其中的关键概念进行了讲解。下一篇我们会对这种接口范式进行进一步的讲解和实际使用。敬请关注:码农小胖哥 。
关注公众号:Felordcn 获取更多资讯
个人博客:https://felord.cn
这篇关于换一种方式编写 Spring MVC 接口的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!
- 2024-10-01基于Python+Vue开发的医院门诊预约挂号系统
- 2024-10-01基于Python+Vue开发的旅游景区管理系统
- 2024-10-01RestfulAPI入门指南:打造简单易懂的API接口
- 2024-10-01初学者指南:了解和使用Server Action
- 2024-10-01Server Component入门指南:搭建与配置详解
- 2024-10-01React 中使用 useRequest 实现数据请求
- 2024-10-01使用 golang 将ETH账户的资产平均分散到其他账户
- 2024-10-01JWT用户校验课程:从入门到实践
- 2024-10-01Server Component课程入门指南
- 2024-09-30Dnd-Kit学习:新手快速入门指南