二十二.HandlerFunction vs. HandlerAdapter：处理器函数与处理器适配器的比较

转载

锋哥

2024-04-07

Java - Spring

398

# Spring WebFlux

二十二.HandlerFunction vs. HandlerAdapter：处理器函数与处理器适配器的比较

在Spring框架中，处理器函数（HandlerFunction）和处理器适配器（HandlerAdapter）是两个重要的概念，用于处理HTTP请求并生成响应。虽然它们都是用于处理请求的组件，但它们之间存在一些区别。本文将对HandlerFunction和HandlerAdapter进行比较，并介绍它们的特点、用法以及适用场景。

1.HandlerFunction

HandlerFunction是Spring WebFlux框架中用于处理HTTP请求的函数式接口。它接收一个ServerRequest对象作为输入参数，并返回一个Mono对象作为输出结果。HandlerFunction通常用于定义路由处理器，将特定的HTTP请求映射到相应的处理函数上。
特点：
• 函数式接口：HandlerFunction是一个函数式接口，可以通过Lambda表达式或方法引用来定义处理函数。
• 响应式编程：HandlerFunction的返回值是一个Mono对象，可以利用响应式编程的特性处理异步请求。
• 轻量级：HandlerFunction是一个轻量级的处理器组件，适用于处理简单的HTTP请求和响应。
用法：

public class ExampleHandler {

    public Mono<ServerResponse> handleRequest(ServerRequest request) {
        // 处理HTTP请求逻辑
        return ServerResponse.ok().build();
    }
}

@Configuration
public class RouterConfig {

    @Bean
    public RouterFunction<ServerResponse> route(ExampleHandler handler) {
        return RouterFunctions
            .route(RequestPredicates.GET("/example"), handler::handleRequest);
    }
}

2.HandlerAdapter

HandlerAdapter是Spring MVC框架中用于将处理器对象适配为处理器函数的接口。它负责调用处理器对象的适当方法，并将处理结果转换为服务器响应。HandlerAdapter通常用于将传统的基于注解的控制器适配为函数式的处理器函数。
特点：
• 适配器接口：HandlerAdapter是一个接口，定义了将处理器对象适配为处理器函数的方法。
• 支持多种处理器类型：HandlerAdapter可以适配多种类型的处理器对象，包括基于注解的控制器、HTTP请求映射处理器等。
• 灵活性：HandlerAdapter提供了灵活的适配策略，可以根据不同的处理器类型采用不同的适配方式。
用法：

public class ExampleController {

    @GetMapping("/example")
    public ResponseEntity<String> handleRequest() {
        // 处理HTTP请求逻辑
        return ResponseEntity.ok("Hello World");
    }
}

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Override
    public void configureAdapter(HandlerAdapterRegistry registry) {
        registry.addHandlerAdapter(new RequestMappingHandlerAdapter());
    }
}

3.比较

在HandlerFunction和HandlerAdapter之间存在一些显著的区别，包括框架依赖、编程模式、异步处理等方面。
框架依赖
• HandlerFunction依赖于Spring WebFlux框架，是响应式编程模型的一部分。
• HandlerAdapter依赖于Spring MVC框架，是传统的Servlet编程模型的一部分。
编程模式
• HandlerFunction采用函数式编程模式，通过Lambda表达式或方法引用来定义处理函数。
• HandlerAdapter通常用于适配基于注解的控制器类，采用注解驱动的编程模式。
异步处理
• HandlerFunction支持响应式编程，可以利用Mono对象处理异步请求。
• HandlerAdapter适配的控制器类通常采用同步处理方式，无法直接支持异步编程。
示例代码
HandlerFunction示例：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.reactive.function.server.RouterFunction;
import org.springframework.web.reactive.function.server.RouterFunctions;
import org.springframework.web.reactive.function.server.ServerResponse;
import org.springframework.web.reactive.function.server.RequestPredicates;
import reactor.core.publisher.Mono;

@Configuration
public class HandlerFunctionConfig {

    @Bean
    public RouterFunction<ServerResponse> route() {
        return RouterFunctions
            .route(RequestPredicates.GET("/hello"),
                   request -> ServerResponse.ok().body(Mono.just("Hello World"), String.class));
    }
}

HandlerAdapter示例：

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HandlerAdapterController {

    @GetMapping("/hello")
    public ResponseEntity<String> hello() {
        return ResponseEntity.ok("Hello World");
    }
}

在上述示例中，HandlerFunction通过函数式编程方式定义了处理逻辑，并使用RouterFunction进行路由配置；而HandlerAdapter则是通过注解驱动的方式定义了控制器类，并使用@GetMapping注解进行请求映射。

4.适用场景

HandlerFunction的适用场景：
• 异步处理需求：当需要处理大量并发请求或执行IO密集型操作时，HandlerFunction适合采用响应式编程模式，利用Mono对象实现异步处理，从而提高系统的吞吐量和性能。
• 函数式编程倾向：如果团队倾向于采用函数式编程风格，或对响应式编程有一定了解和经验，那么HandlerFunction是一个不错的选择，能够带来更加简洁、灵活的代码。
HandlerAdapter的适用场景：
• 传统Web应用：对于已经存在的传统的Spring MVC应用，采用HandlerAdapter是一种较为自然的选择，可以继续使用注解驱动的控制器类进行开发，无需进行过多的改动。
• 同步处理需求：如果应用场景中大部分请求都是同步处理，且对异步编程没有特别的需求，那么HandlerAdapter可以满足业务需求，无需引入响应式编程的复杂性。
示例代码
HandlerFunction适用场景示例：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.reactive.function.server.RouterFunction;
import org.springframework.web.reactive.function.server.RouterFunctions;
import org.springframework.web.reactive.function.server.ServerResponse;
import org.springframework.web.reactive.function.server.RequestPredicates;
import reactor.core.publisher.Mono;

@Configuration
public class HandlerFunctionConfig {

    @Bean
    public RouterFunction<ServerResponse> route() {
        return RouterFunctions
            .route(RequestPredicates.GET("/hello"),
                   request -> ServerResponse.ok().body(Mono.just("Hello World"), String.class));
    }
}

HandlerAdapter适用场景示例：

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HandlerAdapterController {

    @GetMapping("/hello")
    public ResponseEntity<String> hello() {
        return ResponseEntity.ok("Hello World");
    }
}

在上述示例中，HandlerFunction适用于异步处理需求较多的场景，而HandlerAdapter适用于同步处理需求较多的传统Web应用场景。开发团队可以根据具体业务需求和技术偏好，选择合适的处理器模式。

5.总结

HandlerFunction和HandlerAdapter都是Spring框架中用于处理HTTP请求的重要组件，但它们在框架依赖、编程模式和适用场景等方面存在一定的区别。开发人员可以根据项目需求和技术选型选择合适的处理器组件，以实现最佳的开发效果和用户体验。