Spring Boot WebFlux 教程

Spring Boot WebFlux 教程展示了如何使用 WebFlux 创建一个简单的 Spring Boot 响应式 Web 应用程序。

WebFlux

WebFlux 是一个 Spring 响应式 Web 框架。它已添加到 Spring 5 中。它是完全非阻塞的,支持 reactive streams 响应流,并且可以很好运行在 Netty,Undertow 和 Servlet 3.1 + 容器等服务器上。

Spring WebFlux 是传统 Spring MVC 的一个替代方案。

Spring WebFlux 在内部使用 Project Reactor 和它的 Publisher 实现 Flux 和 Mono。它支持两种编程模型:a)基于注释的响应式组件,b)函数级别的路由和处理。

响应式编程

响应式编程是一种编程范例,它是功能性的,基于事件的,非阻塞的,异步的,并且以数据流处理为中心。术语 “响应式” 来自于我们对鼠标单击或 I / O 事件等更改做出反应的事实。

当我们处理大量流数据时,响应式应用程序可以更好地扩展,并且效率更高。响应式应用程序是非阻塞的;他们没有使用资源去等待流程完成。

响应式应用程序将数据推送到使用者是基于事件的模型。数据消费者,订阅者,订阅发布者,它们发布异步数据流。

Spring Reactor

Spring Reactor 是一个响应式库,用于根据响应式流规范在 JVM 上构建非阻塞应用程序。

Reactor 项目提供两种类型的发布者:Mono 和 Flux。Flux 是产生 0 到 N 个值的发布者。返回多个元素的操作使用此类型。Mono 是产生 0 到 1 值的发布者。它用于返回单个元素的操作。

Spring Boot WebFlux 示例

在以下应用程序中,我们创建一个带有响应式的简单的 Spring Boot Web 应用程序。

pom.xml
src
├───main
│   ├───java
│   │   └───com
│   │       └───zetcode
│   │           │   Application.java
│   │           └───controller
│   │                   MyController.java
│   └───resources
│           application.properties
└───test
    └───java

这是项目结构。

pom.xml


<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         http://maven.apache.org/xsd/maven-4.0.0.xsd"
>

    <modelVersion>4.0.0</modelVersion>

    <groupId>com.zetcode</groupId>
    <artifactId>springbootwebfluxsimple</artifactId>
    <version>1.0-SNAPSHOT</version>

    <packaging>jar</packaging>

    <properties>
        <java.version>13</java.version>
    </properties>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.4.RELEASE</version>
    </parent>

    <dependencies>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-webflux</artifactId>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>

        </plugins>
    </build>
</project>

这是 Maven 的 pom.xml 文件。spring-boot-starter-webflux 是 Spring Boot 的一个启动器,它使用 Spring Framework 的 Reactive Web 来构建 WebFlux 应用程序。

resources/application.properties

spring.main.banner-mode=off

在 application.properties 文件中,我们关闭 Spring Boot 的 banner 模式。

com/zetcode/MyController.java

package com.zetcode.controller;

import org.reactivestreams.Publisher;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import reactor.core.publisher.Mono;

@RestController
public class MyController {

    @GetMapping("/")
    public Publisher<String> home() {

        return Mono.just("Home page");
    }
}

我们有一个简单的 REST 端点,它返回一条消息。该 home() 方法返回类型是 Publisher。Mono.just() 发出指定的字符串消息。

com/zetcode/Application.java

package com.zetcode;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application  {

    public static void main(String[] args) {
        SpringApplication.run(Application.classargs);
    }
}

这段代码运行了 Spring Boot 应用程序。

$ mvn spring-boot:run

我们运行该应用程序并在浏览器网址栏中输入 localhost:8080。

在本教程中,我们创建了一个简单的 Spring Boot WebFlux 应用程序。