Spring WebFlux的使用指南

 更新时间:2021年05月06日 11:56:45   作者:老K的JAVA博客  
这篇文章主要介绍了Spring WebFlux的使用指南,帮助大家更好的理解和学习使用Spring框架,感兴趣的朋友可以了解下

Spring WebFlux是spring5的一部分,它为web应用程序提供反应式编程支持。

在本教程中,我们将使用RestController和WebClient创建一个小型响应式REST应用程序。

我们还将研究如何使用Spring安全保护我们的反应端点。

Spring-WebFlux框架

Spring WebFlux在内部使用Project Reactor及其发布者实现Flux和Mono。

新框架支持两种编程模型:

  • 基于注释的反应元件
  • 功能路由和处理

依赖项

让我们从spring boot starter webflux依赖项开始,它包含所有其他必需的依赖项:

  • spring boot和spring boot starter,用于基本的spring boot应用程序设置
  • spring-webflux框架
  • reactor-core我们需要的反应流,也需要reactor-netty
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
    <version>2.2.6.RELEASE</version>
</dependency>

响应式应用

我们现在将使用Spring WebFlux构建一个非常简单的REST EmployeeManagement应用程序:

  • 我们将使用一个简单的域模型-带有id和name字段的Employee
  • 我们将使用RestController构建restapi,以将员工资源作为单个资源和集合发布
  • 我们将使用WebClient构建一个客户端来检索相同的资源
  • 我们将使用WebFlux和Spring Security创建一个安全的被动端点

响应式RestController

springwebflux支持基于注释的配置,方式与springwebmvc框架相同。

首先,在服务器上,我们创建一个带注释的控制器,它发布员工资源的反应流。

让我们创建带注释的EmployeeController

@RestController
@RequestMapping("/employees")
public class EmployeeController {

    private final EmployeeRepository employeeRepository;
    
    // constructor...
}

EmployeeRepository可以是任何支持非阻塞反应流的数据存储库。

单一资源

让我们在控制器中创建一个端点,用于发布单个员工资源:

@GetMapping("/{id}")
private Mono<Employee> getEmployeeById(@PathVariable String id) {
    return employeeRepository.findEmployeeById(id);
}

我们在Mono中包装一个Employee资源,因为我们最多返回一个Employee。

集合资源

我们还要添加一个端点来发布所有雇员的集合资源:

@GetMapping
private Flux<Employee> getAllEmployees() {
    return employeeRepository.findAllEmployees();
}

对于集合资源,我们使用类型为Employee的流量,因为它是0..n元素的发布者。

反应式Web客户端

Spring5中引入的WebClient是一个支持反应流的非阻塞客户端。

我们可以使用WebClient创建一个客户端,从EmployeeController提供的端点检索数据。

让我们创建一个简单的EmployeeWebClient:

public class EmployeeWebClient {

    WebClient client = WebClient.create("http://localhost:8080");

    // ...
}

在这里,我们使用工厂方法create创建了一个WebClient。它会指向localhost:8080,所以我们可以使用或相对的URL来调用这个客户端实例。

检索单个资源

要从endpoint/employee/{id}检索Mono类型的单个资源,请执行以下操作:

Mono<Employee> employeeMono = client.get()
  .uri("/employees/{id}", "1")
  .retrieve()
  .bodyToMono(Employee.class);

employeeMono.subscribe(System.out::println);

检索集合资源

类似地,要从endpoint/employees检索Flux类型的集合资源,请执行以下操作:

Flux<Employee> employeeFlux = client.get()
  .uri("/employees")
  .retrieve()
  .bodyToFlux(Employee.class);
        
employeeFlux.subscribe(System.out::println);

Spring WebFlux安全性

我们可以使用Spring Security来保护我们的反应端点。

假设我们在EmployeeController中有一个新的端点。此端点更新员工详细信息并发回更新的员工。

由于这允许用户更改现有员工,因此我们希望仅将此端点限制为管理员角色用户。

让我们为EmployeeController添加一个新方法:

@PostMapping("/update")
private Mono<Employee> updateEmployee(@RequestBody Employee employee) {
    return employeeRepository.updateEmployee(employee);
}

现在,为了限制对该方法的访问,让我们创建SecurityConfig并定义一些基于路径的规则以仅允许管理员用户:

@EnableWebFluxSecurity
public class EmployeeWebSecurityConfig {

    // ...

    @Bean
    public SecurityWebFilterChain springSecurityFilterChain(
      ServerHttpSecurity http) {
        http.csrf().disable()
          .authorizeExchange()
          .pathMatchers(HttpMethod.POST, "/employees/update").hasRole("ADMIN")
          .pathMatchers("/**").permitAll()
          .and()
          .httpBasic();
        return http.build();
    }
}

此配置将限制对/employees/update的访问。因此,只有具有ADMIN角色的用户才能访问此端点并更新现有员工。

最后,注解@EnableWebFluxSecurity添加了一些默认配置的Spring-Security-WebFlux支持。

结论

在本文中,我们探讨了如何创建和使用springwebflux框架支持的反应式web组件。例如,我们构建了一个小型的REST应用程序。

除了Reactive RestController和WebClient之外,WebFlux框架还支持Reactive WebSocket和对应的WebSocketClient,以进行套接字样式的Reactive流。

最后,在Github上提供了本文中使用的完整源代码:https://github.com/eugenp/tutorials/tree/master/spring-5-reactive-security

以上就是Spring WebFlux的使用指南的详细内容,更多关于Spring WebFlux的使用的资料请关注脚本之家其它相关文章!

相关文章

  • Spring Boot Actuator端点相关原理解析

    Spring Boot Actuator端点相关原理解析

    这篇文章主要介绍了Spring Boot Actuator端点相关原理解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-07-07
  • SpringBoot整合Flyway的方法(数据库版本迁移工具)

    SpringBoot整合Flyway的方法(数据库版本迁移工具)

    这篇文章主要介绍了SpringBoot整合Flyway的方法(数据库版本迁移工具),本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-06-06
  • Java对Excel表格的上传和下载处理方法

    Java对Excel表格的上传和下载处理方法

    这篇文章主要介绍了Java对Excel表格的上传和下载处理方法,需要的朋友可以参考下
    2017-08-08
  • Java实现创建Zip压缩包并写入文件

    Java实现创建Zip压缩包并写入文件

    这篇文章主要为大家详细介绍了Java实现创建Zip压缩包并写入文件,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-01-01
  • java使用hashMap缓存保存数据的方法

    java使用hashMap缓存保存数据的方法

    这篇文章主要介绍了java使用hashMap缓存保存数据的方法,结合实例形式简单分析了java基于hashmap读写缓存数据的相关操作技巧,需要的朋友可以参考下
    2016-08-08
  • 深入学习MyBatis中的参数(推荐)

    深入学习MyBatis中的参数(推荐)

    大家日常使用MyBatis经常会遇到一些异常,想要避免参数引起的错误,我们需要深入了解参数。想了解参数,我们首先看MyBatis处理参数和使用参数的全部过程。下面这篇文章主要给大家介绍了MyBatis中参数的的相关资料,需要的朋友可以参考借鉴,下面来一起看看吧。
    2017-06-06
  • Java银行取钱线程安全问题实例分析

    Java银行取钱线程安全问题实例分析

    这篇文章主要介绍了Java银行取钱线程安全问题,结合具体实例形式分析了java使用线程操作模拟银行取钱的相关安全问题,需要的朋友可以参考下
    2019-09-09
  • Java利用反射实现框架类的方法实例

    Java利用反射实现框架类的方法实例

    这篇文章主要给大家介绍了关于Java利用反射实现框架类的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-10-10
  • Java中ArrayList的工作原理详解

    Java中ArrayList的工作原理详解

    本文主要介绍了Java中ArrayList的工作原理,具有很好的参考价值。下面跟着小编一起来看下吧
    2017-03-03
  • java后端pageHelper分页实现方法步骤

    java后端pageHelper分页实现方法步骤

    这篇文章主要给大家介绍了关于java后端pageHelper分页实现方法的相关资料,在我们的Java项目中分页是必不可少的数据展示页面,文中通过图文以及示例代码介绍的非常详细,需要的朋友可以参考下
    2023-07-07

最新评论