Spring WebFlux使用函数式编程之HandlerFunction
本篇主要内容:
- RouterFunction的使用
概述
路由器函数用于将请求路由到相应的HandlerFunction。通常情况下,你不需要自己编写路由器函数,而是使用RouterFunctions类中的方法来创建一个。RouterFunctions.route()(无参数)为创建路由器函数提供了一个流畅的构建器,而RouterFunctions.route(RequestPredicate, HandlerFunction)提供了创建路由器的直接方法。
通常,建议使用route()构建器,因为它为典型的映射场景提供了方便的快捷方式,而不需要难以发现的静态导入。例如,路由器函数构建器提供了方法GET(String, HandlerFunction)来为GET请求创建映射;和POST(String, HandlerFunction)用于POST。
除了基于HTTP方法的映射之外,路由构建器还提供了一种在映射到请求时引入附加谓词的方法。对于每个HTTP方法,都有一个以RequestPredicate作为参数的重载变体,尽管可以表示附加的约束。
谓词Predicates
你可以编写自己的RequestPredicate,但RequestPredites类提供了常用的实现,基于请求路径、HTTP方法、内容类型等。以下示例使用请求谓词根据Accept标头创建约束:
RouterFunction<ServerResponse> route = RouterFunctions.route() .GET("/hello-world", accept(MediaType.TEXT_PLAIN), request -> ServerResponse.ok().bodyValue("Hello World")).build();
你可以使用以下命令将多个请求谓词组合在一起:
- RequestPredicate.and(RequestPredicate) // 两者必须匹配。
- RequestPredicate.or(RequestPredicate) // 两者都可以匹配。
RequestPredicates中的许多谓词都是组合的。例如,RequestPredicates.GET(String)由RequestPredicates.method(HttpMethod)和RequestPredicates.path(String)组合而成。上面显示的示例还使用了两个请求谓词,因为构建器使用RequestPredicates.GET内部,并用accept谓词组合它。
路由Routes
路由器函数按顺序计算:如果第一个路由不匹配,则计算第二个路由,依此类推。因此,在一般路由之前声明更具体的路由是有意义的。这在将路由器函数注册为Spring bean时也很重要,稍后将对此进行描述。注意,此行为不同于基于注释的编程模型,后者自动选择“最特定的”控制器方法。
当使用路由器函数构建器时,所有定义的路由被组合到一个RouterFunction中,该RouterFunction从build()返回。还有其他方法可以将多个路由器功能组合在一起:
- add(RouterFunction) on the RouterFunctions.route() builder。
- RouterFunction.and(RouterFunction)。
- RouterFunction.andRoute(RequestPredicate, HandlerFunction) — shortcut for RouterFunction.and() with nested RouterFunctions.route()。
下面的例子展示了四条路由的组合:
import static org.springframework.http.MediaType.APPLICATION_JSON; import static org.springframework.web.reactive.function.server.RequestPredicates.*; PersonRepository repository = ... PersonHandler handler = new PersonHandler(repository); RouterFunction<ServerResponse> otherRoute = ... RouterFunction<ServerResponse> route = route() .GET("/person/{id}", accept(APPLICATION_JSON), handler::getPerson) // 1 .GET("/person", accept(APPLICATION_JSON), handler::listPeople) // 2 .POST("/person", handler::createPerson) // 3 .add(otherRoute) // 4 .build();
- 带有匹配JSON的Accept头的GET /person/{id}被路由到 PersonHandler.getPerson。
- 带有与JSON匹配的Accept头的GET /person被路由到 PersonHandler.listPeople。
- 没有附加谓词的POST /person被映射到 PersonHandler.createPerson。
- otherRoute是一个在别处创建的路由器函数,并添加到构建的路由中。
嵌套路由Nested Routes
一组路由器函数通常具有一个共享谓词,例如共享路径。在上面的示例中,共享谓词将是一个与/person匹配的路径谓词,由三条路由使用。在使用注释时,可以通过使用映射到/person的类型级 @RequestMapping 注释来消除这种重复。在WebFlux.Fn,路径谓词可以通过路由器函数构建器上的路径方法共享。例如,上面例子的最后几行可以通过使用嵌套路由通过以下方式进行改进:
RouterFunction<ServerResponse> route = route() .path("/person", builder -> builder // 1 .GET("/{id}", accept(APPLICATION_JSON), handler::getPerson) .GET(accept(APPLICATION_JSON), handler::listPeople) .POST(handler::createPerson)) .build();
注意:path的第二个参数是接受路由器构建器的消费者。
尽管基于路径的嵌套是最常见的,但是你可以通过在构建器上使用嵌套方法来嵌套任何类型的谓词。上面的内容仍然以共享的Accept-header谓词的形式包含了一些重复。我们可以通过使用nest方法和accept来进一步改进:
RouterFunction<ServerResponse> route = route() .path("/person", b1 -> b1 .nest(accept(APPLICATION_JSON), b2 -> b2 .GET("/{id}", handler::getPerson) .GET(handler::listPeople)) .POST(handler::createPerson)) .build();
总结:
- 路由函数中 RouteFunction 的使用。
- 嵌套路由的使用。
- Spring中实现异步调用的方式有哪些?
- 带参数的全类型 Python 装饰器
- 整理了几个Python正则表达式,拿走就能用!
- SOLID:开闭原则Go代码实战
- React中如何引入CSS呢
- 一个新视角:前端框架们都卷错方向了?
- 编码中的Adapter,不仅是一种设计模式,更是一种架构理念与解决方案
- 手写编程语言-递归函数是如何实现的?
- 一文搞懂模糊匹配:定义、过程与技术
- 新来个阿里 P7,仅花 2 小时,做出一个多线程永动任务,看完直接跪了
- Puzzlescript,一种开发H5益智游戏的引擎
- @Autowired和@Resource到底什么区别,你明白了吗?
- CSS transition 小技巧!如何保留 hover 的状态?
- React如此受欢迎离不开这4个主要原则
- LeCun再炮轰Marcus: 他是心理学家,不是搞AI的
- Java保证线程安全的方式有哪些?
- 19个杀手级 JavaScript 单行代码,让你看起来像专业人士
- Python 的"self"参数是什么?
- 别整一坨 CSS 代码了,试试这几个实用函数
- 再有人问你什么是MVCC,就把这篇文章发给他!