As mentioned in Juergen's blog yesterday, the second milestone of Spring 5.0 is the introduction of a new functional web framework. In this article, we will give more information about this framework.
Let’s start with some excerpts from a sample application. Below is the response information base exposing Person
object. Very similar to a traditional, non-responsive information base, except that it returns Flux8abf60ac54173a2785e603c7a1f95b4e whereas the traditional one returns List8abf60ac54173a2785e603c7a1f95b4e, and Mono8abf60ac54173a2785e603c7a1f95b4e ;
returns Person. Mono903bf37051cf83cbd9686768ac0189ae is used as a completion flag: indicating when the save is completed. For more information on Reactor types, see this blog post.
public interface PersonRepository { Mono<Person> getPerson(int id); Flux<Person> allPeople(); Mono<Void> savePerson(Mono<Person> person); }
Here's how we expose the resource library with the new functional web framework:
RouterFunction<?> route = route(GET("/person/{id}"), request -> { Mono<Person> person = Mono.justOrEmpty(request.pathVariable("id")) .map(Integer::valueOf) .then(repository::getPerson); return Response.ok().body(fromPublisher(person, Person.class)); }) .and(route(GET("/person"), request -> { Flux<Person> people = repository.allPeople(); return Response.ok().body(fromPublisher(people, Person.class)); })) .and(route(POST("/person"), request -> { Mono<Person> person = request.body(toMono(Person.class)); return Response.ok().build(repository.savePerson(person)); }));
Here we'll show you how to run it, such as in Reactor Netty:
HttpHandler httpHandler = RouterFunctions.toHttpHandler(route); ReactorHttpHandlerAdapter adapter = new ReactorHttpHandlerAdapter(httpHandler); HttpServer server = HttpServer.create("localhost", 8080); server.startAndAwait(adapter);
The last thing to do is give it a try:
$ curl 'http://localhost:8080/person/1' {"name":"John Doe","age":42}
There’s more below, so let’s dig deeper!
I will introduce the framework by thoroughly explaining the core components: HandlerFunction
, RouterFunction
, and FilterFunction
. These three interfaces, as well as all other types described in the article, can be found in the org.springframework.web.reactive.function package.
HandlerFunction
The starting point of this new framework is HandlerFunction8742468051c85b06f0a0af9e3e506b5c
, which is basically FunctionRequest
and Response are newly defined, immutable interface-friendly to provide JDK-8 DSL to the underlying HTTP messages. For building Response
entities is a convenience build tool, very similar to what you see in ResponseEntity. The annotation corresponding to HandlerFunction
is a method with @RequestMapping.
The following is an example of a simple "Hello World" processing function, which returns a response message with a 200 status and a body of String:
HandlerFunction<String> helloWorld = request -> Response.ok().body(fromObject("Hello World"));
As we saw in the example above, handler functions are fully responsive by building on top of Reactor: they accept Flux, Mono, or any other corresponding stream Publisher
as the response type.
One thing to note is that HandlerFunction
itself has no side effects, because it returns the response instead of treating it as a parameter (see Servlet.service(ServletRequest,ServletResponse), this essence Above is BiConsumer6e72f5b255c484787157de45967f7d3d). No side effects have many benefits: easy to test, write and optimize.
RouterFunction
Incoming requests are routed to the handler function with RouterFunction8742468051c85b06f0a0af9e3e506b5c
(i.e. Function< Request, Optional
The following is an example of a routing function with built-in processing functions. It may seem a bit lengthy, but don't worry: we'll find a way to make it shorter.
RouterFunction<String> helloWorldRoute = request -> { if (request.path().equals("/hello-world")) { return Optional.of(r -> Response.ok().body(fromObject("Hello World"))); } else { return Optional.empty(); } };
Generally, you do not need to write a complete routing method, but staticIntroduce RouterFunctions.route(), so that you can use the request judgment (RequestPredicate) (i.e. Predicatef7d8f1c8612adb3bda833145b9a351cc) and processing Method (HandlerFunction) creates a routing method. If the judgment is successful, the processing method is returned, otherwise an empty result is returned. The following is a rewrite of the above example using the route method:
RouterFunction<String> helloWorldRoute = RouterFunctions.route(request -> request.path().equals("/hello-world"), request -> Response.ok().body(fromObject("Hello World")));
You can (statically) import RequestPredicates.* to access commonly used predicates, matching based on path, HTTP method, content type, etc. With it, we can make helloWorldRoute simpler:
RouterFunction<String> helloWorldRoute = RouterFunctions.route(RequestPredicates.path("/hello-world"), request -> Response.ok().body(fromObject("Hello World")));
Combined function
Two routing functions can form a new routing function and route to any processing function : If the first function does not match, then execute the second one. You can combine two routing functions like this by calling RouterFunction.and():
RouterFunction<?> route = route(path("/hello-world"), request -> Response.ok().body(fromObject("Hello World"))) .and(route(path("/the-answer"), request -> Response.ok().body(fromObject("42"))));
If the path matches /hello-world, the above will respond with "Hello World", if it matches /the-answer, both Returns "42". If neither matches, an empty Optional
is returned. Note that the combined routing functions are executed sequentially, so it makes sense to put the generic function before the concrete function.
你也可以组合要求谓词,通过调用and
或or。工作方式是这样:对于and,如果两个给定谓词匹配的话,结果谓词匹配,而如果两者中的一个谓语匹配的话,那么就or匹配。例如:
RouterFunction<?> route = route(method(HttpMethod.GET).and(path("/hello-world")), request -> Response.ok().body(fromObject("Hello World"))) .and(route(method(HttpMethod.GET).and(path("/the-answer")), request -> Response.ok().body(fromObject("42"))));
事实上,在RequestPredicates
发现的大多数谓词是组合的!例如,RequestPredicates.GET(String)是RequestPredicates.method(HttpMethod)和RequestPredicates.path(String)的组合物。因此,我们可以将上面的代码重写为:
RouterFunction<?> route = route(GET("/hello-world"), request -> Response.ok().body(fromObject("Hello World"))) .and(route(GET("/the-answer"), request -> Response.ok().body(fromObject(42))));
方法引用
顺便说一句:到目前为止,我们已经编写了所有的处理函数作为内联的lambda表达式。虽然这在演示和短的例子中表现良好,但是不得不说这有一种会导致“混乱”的倾向,因为你要混合两种担忧:请求路由和请求处理。因此,我们要看看是否能够让事情变得更简洁。首先,我们创建一个包含处理代码的类:
class DemoHandler { public Response<String> helloWorld(Request request) { return Response.ok().body(fromObject("Hello World")); } public Response<String> theAnswer(Request request) { return Response.ok().body(fromObject("42")); } }
注意,两个方法都有一个兼容了处理函数的标志。这允许我们使用方法引用:
DemoHandler handler = new DemoHandler(); // or obtain via DI RouterFunction<?> route = route(GET("/hello-world"), handler::helloWorld) .and(route(GET("/the-answer"), handler::theAnswer));
FilterFunction
由路由函数映射的路径可以通过调用RouterFunction.filter(FilterFunction469df1b70b2914a3841e0404ec3e3d5d)进行过滤,其中FilterFunction43ca9160a1fbc6e1e17f36fac17e2094本质上是BiFunction
RouterFunction<?> route = route(GET("/hello-world"), handler::helloWorld) .and(route(GET("/the-answer"), handler::theAnswer)) .filter((request, next) -> { System.out.println("Before handler invocation: " + request.path()); Response<?> response = next.handle(request); Object body = response.body(); System.out.println("After handler invocation: " + body); return response; });
需要注意的是,要不要调用下一个处理程序是可选的。这在安全和缓存方案中非常有用(如只在用户有足够权限的时候调用next
)。
由于route
是一个无限路由函数,因此我们知道接下来的处理程序会返回什么类型的响应信息。这就是为什么我们最终在我们的过滤器中用Response6b3d0130bba23ae47fe2b8e8cddf0195结束以及用Object
响应body的原因。在处理程序类中,两种方法都返回Responsef7e83be87db5cd2d9a8a0b8117b38cd4,所以应该有可能有String
响应主体。我们可以通过使用RouterFunction.andSame()来代替and()做到这一点。这种组合方法需要参数路由函数是相同的类型。例如,我们可以让所有的响应变成大写:
RouterFunction<String> route = route(GET("/hello-world"), handler::helloWorld) .andSame(route(GET("/the-answer"), handler::theAnswer)) .filter((request, next) -> { Response<String> response = next.handle(request); String newBody = response.body().toUpperCase(); return Response.from(response).body(fromObject(newBody)); });
使用注解,相似的功能可以用@ControllerAdvice和/或ServletFilter来实现。
所有这一切都很好,但有一件事忘了:我们如何才能在实际的HTTP服务器中运行这些函数呢?答案勿庸置疑是通过调用另一个函数。你可以通过使用RouterFunctions.toHttpHandler()将路由函数转换成HttpHandler。HttpHandler
是引进到Spring 5.0 M1的一个响应抽象:它允许你运行在各种响应运行时上:Reactor Netty、RxNetty、Servlet 3.1+,和Undertow。在这个例子中,我们已经表明了在Reactor Netty中运行route
是怎么样的。对于Tomcat,它看起来像这样:
HttpHandler httpHandler = RouterFunctions.toHttpHandler(route); HttpServlet servlet = new ServletHttpHandlerAdapter(httpHandler); Tomcat server = new Tomcat(); Context rootContext = server.addContext("", System.getProperty("java.io.tmpdir")); Tomcat.addServlet(rootContext, "servlet", servlet); rootContext.addServletMapping("/", "servlet"); tomcatServer.start();
有一点要注意的是,上面的代码不依赖于Spring应用程序上下文。就像JdbcTemplate
和其他Spring实用工具类,使用应用程序上下文是可选的:你可以在上下文中接通处理程序和路由函数,但它不是必需的。
还要注意的是,你也可以转换路由函数为HandlerMapping,以便它可以在DispatcherHandler
中运行(可能需要有响应的@Controllers)。
让我通过简短的总结来得出结论:
处理函数通过返回响应处理请求。
路由函数路由到处理函数,并且可以与其他路由函数组合。
路由函数可以通过过滤器进行过滤。
路由函数可以在响应的web运行时中运行。
The above is the detailed content of Spring5 new features-detailed code examples of functional web framework. For more information, please follow other related articles on the PHP Chinese website!