英文:ARJEN POUTSMA 

译文:debugging, 达尔文, 混元归一, leoxu, xufuji456

链接:oschina.net/translate/new-in-spring-5-functional-web-framework

就像在昨天Juergen发布的博客的一样,Spring 5.0框架第二个里程碑版本中介绍了一个新的函数式web框架。在这篇文章中,我将更详细的介绍这个框架。

紧记该函数式web框架是在Spring5.0第一个里程碑版本基础上构建的。并且我们依旧提供基于注解的请求处理(例如@Controller,@RequestMapping),关于基于注解的请求处理部分的相关信息请查阅关于Spring5.0第一个里程碑版本的博客。

示例

我们选用示例程序作为开始。下面是一个响应资源库用于暴露Person对象。这个响应资源库与传统的无响应资源库类似,除了Flux对应传统的 List,Mono对应传统的 Person对象。Mono作为完成标识:用于指示保存工作完成.更多Reactor 类型信息请查阅 Dave发布的博客

    public interface PersonRepository {

      Mono<Person> getPerson(int id);

      Flux<Person> allPeople();

      Mono<Void> savePerson(Mono<Person> person);}

这里我们介绍如何使用新的函数式web框架暴露资源库:

    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));

        }));

这里我们介绍如何运行它,下面是Reactor Netty的示例:

    HttpHandler httpHandler = RouterFunctions.toHttpHandler(route);

    ReactorHttpHandlerAdapter adapter =

      new ReactorHttpHandlerAdapter(httpHandler);

    HttpServer server = HttpServer.create("localhost", 8080);

    server.startAndAwait(adapter);

最后要做的是,进行一次尝试请求:

    $ curl ' 

    {"name":"John Doe","age":42}

上面的介绍覆盖了很多内容,下面让我们深入挖掘下!

核心组件

我将通过依次介绍HandlerFunction,RouterFunction以及FilterFunction 等核心组件来介绍整个框架。这三个接口以及本文中其他类型都可以在org.springframework.web.reactive.function包中找到。

处理功能

新框架的起点是HandlerFunction,其实质是Function

    HandlerFunction<String> helloWorld =

      request -> Response.ok().body(fromObject("Hello World"));

如上,构建于Reactor之上的处理方法是完全的响应式的(reactive),它们可以接受Flux、Mono或者其他相应流(Reactive Streams)的发布者作为返回类型的参数。

需要注意的是处理方法本身是没有副作用的,因为它将response作为返回值,而不是作为参数(对比Servlet.service(ServletRequest,ServletResponse),其实质是BiConsumer

路由功能

入站请求是由RouterFunction,(即Function

    RouterFunction<String> helloWorldRoute = 

      request -> {

        if (request.path().equals("/hello-world")) {

          return Optional.of(r -> Response.ok().body(fromObject("Hello World")));

        } else {

          return Optional.empty();

        }

      };

一般不用写完整的路由方法,而是静态引入RouterFunctions.route(),这样就可以用请求判断式(RequestPredicate) (即 Predicate)和处理方法(HandlerFunction)创建路由方法了。如果判断式判断成功则返回处理方法,否则返回空结果。如下是用route方法方式重写上面的例子:

    RouterFunction<String> helloWorldRoute =

      RouterFunctions.route(request -> request.path().equals("/hello-world"),

        request -> Response.ok().body(fromObject("Hello World")));

静态引入RequestPredicates.*后就可以使用那些常用的判断式了,如匹配路径、HTTP方法、content-type等。这样上面的例子将会变得更精简:

    RouterFunction<String> helloWorldRoute =

      RouterFunctions.route(RequestPredicates.path("/hello-world"),

        request -> Response.ok().body(fromObject("Hello World")));

组合功能

两个路由方法可以被组合成一个新的路由方法,可以路由任意处理方法:如果第一个路由不匹配则执行第二个。可以通过调用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"))));

上面的例子如果路径匹配/hello-world会返回“Hello World”,如果匹配/the-answer则返回“42”。如果都不匹配则返回一个空的Optional对象。注意,组合的路由是按顺序执行的,所以应该将更通用的方法放到更明确的方法的前面。

请求判断式也是可以组合的,通过调研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));

过滤功能

由路由器函数进行映射的路由可以通过调用 RouterFunction.filter(FilterFunction

    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 是一个没有被绑定的路由器函数,我们就得知道接下来的处理会返回什么类型的响应消息。这就是为什么我们在过滤器中要以一个 Response

    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 中运行一个路由会是什么样子的。对于 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 并行)中运行了。

结论

至此便结束了对 Spring 新函数式 web 框架的介绍。让我简单小结一下:

  • 处理功能通过作出回应来处理请求,

  • 路由器功能可连接到处理功能,并可与其他路由器功能共用,

  • 路由器功能可由过滤器的功能进行过滤,

  • 路由器功能可在响应式网络运行机制中运行。


转载 http://geek.csdn.net/news/detail/107401

Spring 5 新功能:函数式 Web 框架的更多相关文章

  1. Spring 5 新特性:函数式Web框架

    举例 我们先从示例应用程序的一些摘录开始.下面是暴露Person对象的响应信息库.很类似于传统的,非响应信息库,只不过它返回Flux<Person>而传统的返回List<Person ...

  2. Salesforce 学习 | 官方总结最实用的Spring '20新功能

    在Spring '20正式发布之前,Trailblazers 社区举行了一个名为Treasure Hunt的在线活动,通过预览沙盒,分享他们认为Spring ‘20中最重要的功能.这篇文章就来盘点一下 ...

  3. Salesforce Spring '20新功能集锦系列(二)

    一.使用Data Mask保护沙盒数据 对于Salesforce管理员和开发人员,Data Mask是功能强大的新数据安全资源.管理员可以使用数据掩码自动加密沙盒中的数据,无需手动保护数据和沙盒组织的 ...

  4. Spring与Web框架(例如Spring MVC)漫谈——关于Spring对于多个Web框架的支持

    在看Spring MVC的官方文档时,最后一章是关于Spring对于其它Web框架的支持(如JSF,Apache Struts 2.x,Tapestry 5.x),当然Spring自己的MVC框架Sp ...

  5. tornado web 框架的认识

    tornado 简介 1,概述 Tornado就是我们在 FriendFeed 的 Web 服务器及其常用工具的开源版本.Tornado 和现在的主流 Web 服务器框架(包括大多数 Python 的 ...

  6. 浅析tornado web框架

    tornado简介 1.tornado概述 Tornado就是我们在 FriendFeed 的 Web 服务器及其常用工具的开源版本.Tornado 和现在的主流 Web 服务器框架(包括大多数 Py ...

  7. tornado web框架

    tornado web框架 tornado简介 1.tornado概述 Tornado就是我们在 FriendFeed 的 Web 服务器及其常用工具的开源版本.Tornado 和现在的主流 Web ...

  8. 最好的6个Go语言Web框架

    原文:Top 6 web frameworks for Go as of 2017 作者:Edward Marinescu 译者:roy 译者注:本文介绍截至目前(2017年)最好的6个Go语言Web ...

  9. 动手写一个简单的Web框架(Werkzeug路由问题)

    动手写一个简单的Web框架(Werkzeug路由问题) 继承上一篇博客,实现了HelloWorld,但是这并不是一个Web框架,只是自己手写的一个程序,别人是无法通过自己定义路由和返回文本,来使用的, ...

随机推荐

  1. 实现socket的服务和客户端通信

    对学习过程中自己敲的一些关于socket有关的代码做了个简单总结,在这分享一下,给有需要的同学借鉴一下. 什么是socket? 网络上的两个程序通过一个双向的通信连接实现数据的交换,这个连接的一端称为 ...

  2. 页面的隐藏或显示:hidden与visibilityState

    我们在很多地方都需要判断用户是不是在当前页面,如果离开了当前页面我们需要捕捉到并进行一些操作. 例如:当视频处于播放状态时,我们需要判断用户是不是在当前页面以继续播放,如果离开了我们需要暂停播放. 有 ...

  3. c++学习书籍推荐《C++编程思想第二卷》下载

    百度云及其他网盘下载地址:点我 编辑推荐 <C++编程思想>(第2卷)是惟一一本如此清晰地阐述如何重新思考以面向对象方法构造程序的书籍.<C++编程思想>(第2卷)介绍实用的编 ...

  4. 简单说一下SS的原理

    假设有主机A和B还有C.主机A是客户机,就是你的电脑,主机B是服务器,也就是位于日本的那台电脑.主机C是你需要访问的网站.在没有SS的情况下,数据传输的流程是:A-->C.在有SS的情况下,概括 ...

  5. [Noi2002]Savage 题解

    [Noi2002]Savage 时间限制: 5 Sec  内存限制: 64 MB 题目描述 输入 第1行为一个整数N(1<=N<=15),即野人的数目. 第2行到第N+1每行为三个整数Ci ...

  6. Linux学习之安装jdk

    下载jdk for linux jdk for linux oracle download 卸载已有的jdk (1)查询是否安装java软件: rpm -qa|grep java (2)卸载jdk: ...

  7. [HDOJ] 2026.Max Sum

    2026.Max Sum (c++) Problem Description Consider the aggregate An= { 1, 2, -, n }. For example, A1={1 ...

  8. Java秒杀系统实战系列~构建SpringBoot多模块项目

    摘要:本篇博文是“Java秒杀系统实战系列文章”的第二篇,主要分享介绍如何采用IDEA,基于SpringBoot+SpringMVC+Mybatis+分布式中间件构建一个多模块的项目,即“秒杀系统”! ...

  9. 【区分】Typescript 中 interface 和 type

    在接触 ts 相关代码的过程中,总能看到 interface 和 type 的身影.只记得,曾经遇到 type 时不懂查阅过,记得他们很像,相同的功能用哪一个都可以实现.但最近总看到他们,就想深入的了 ...

  10. Python连载24-函数list&read&seek

    一. 函数list (1)定义:用打开的文件作为参数,把文件内的每一行内容作为一个元素 (2)格式:list(文件) (3)例子: with open(r"test01.txt", ...