1. 前言

通常我們編寫 Spring MVC 接口的范式是這樣的：

@RestController
@RequestMapping("/v1/userinfo")
public class UserInfoController {
    
    @GetMapping("/foo")
    public String foo() {
        return "felord.cn";
    }
}

這種我都寫吐了，今天換個(gè)口味，使用 Spring 5 新引入的函數(shù)式端點(diǎn)（Functional Endpoints）來耍耍。 這種方式同樣支持 Spring Webflux。

請注意可使用該特性的 Spring 版本不低于 Spring 5.2

2. 依賴

為了演示，這里極簡化只引入 Spring MVC 的 starter :

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

3. RouterFunction

在函數(shù)式端點(diǎn)的寫法中，傳統(tǒng)的請求映射(@RequestMapping)被路由函數(shù)(RouterFunction)所代替。上面的寫法等同于：

    @Bean
    public RouterFunction<ServerResponse> fooFunction() {
        return RouterFunctions.route()
                .GET("/v1/userinfo/foo", request -> ServerResponse.ok()
                        .body("felord.cn"))
                .build();
    }

在該示例中，我使用了 RouterFunctions.route() 創(chuàng)建了一個(gè)RouterFunction，然后RouterFunction 提供了從請求到響應(yīng)的細(xì)節(jié)操作。

4. ServerRequest/ServerResponse

ServerRequest 是對服務(wù)器端的HTTP請求的抽象，你可以通過該抽象獲取請求的細(xì)節(jié)。對應(yīng)的，ServerResponse 是對服務(wù)器端響應(yīng)的抽象，你也可以通過該抽象構(gòu)建響應(yīng)的細(xì)節(jié)。這兩個(gè)概念由下面的 HandlerFunction 接口進(jìn)行 請求→ 響應(yīng) 處理。

5. HandlerFunction

HandlerFunction 是一個(gè)函數(shù)式接口，它提供了從請求( ServerRequest)到響應(yīng)(ServerResponse)的函數(shù)映射抽象。通常你的業(yè)務(wù)邏輯由該接口進(jìn)行實(shí)現(xiàn)。從 ServerRequest 中獲取請求的細(xì)節(jié)，然后根據(jù)業(yè)務(wù)構(gòu)建一個(gè) ServerResponse 響應(yīng)。

HandlerFunction<ServerResponse> handlerFunction = request -> ServerResponse.ok().body("felord.cn");

6. RequestPredicate

RequestPredicate 可以讓你根據(jù)請求的一些細(xì)節(jié)，比如 請求方法、請求頭、請求參數(shù)等等進(jìn)行斷言以決定是否路由。

這里舉一個(gè)例子，假如我們希望請求接口/v1/userinfo/predicate時(shí)根據(jù)不同的參數(shù)處理不同的業(yè)務(wù)，當(dāng)攜帶參數(shù) plan時(shí)才能進(jìn)行處理。我們可以這么寫：

    @Bean
    public RouterFunction<ServerResponse> predicateFunction() {
        return RouterFunctions.route()
                .GET("/v1/userinfo/predicate",
                        request -> request.param("plan").isPresent(),
                        request -> ServerResponse.ok().body("felord.cn"))
                .build();
    }

然后我們測試一下：

當(dāng)攜帶參數(shù) plan時(shí)：

GET http://localhost:8080/v1/userinfo/predicate?plan=

HTTP/1.1 200 
Content-Type: text/plain;charset=UTF-8
Content-Length: 9
Date: Thu, 14 May 2020 07:57:35 GMT
Keep-Alive: timeout=60
Connection: keep-alive

felord.cn

不攜帶參數(shù)plan時(shí):

GET http://localhost:8080/v1/userinfo/predicate

HTTP/1.1 404 
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Transfer-Encoding: chunked
Date: Thu, 14 May 2020 08:00:15 GMT
Keep-Alive: timeout=60
Connection: keep-alive

{
  "timestamp": "2020-05-14T08:00:15.659+0000",
  "status": 404,
  "error": "Not Found",
  "message": "No message available",
  "path": "/v1/userinfo/predicate"
}

7. 小結(jié)

函數(shù)式端點(diǎn)是 Spring 5 提供的一個(gè)新的接口范式風(fēng)格，對于 Spring MVC 來說 Spring 5.2 才進(jìn)行了支持。也是順應(yīng)函數(shù)式編程的一個(gè)未來趨勢。由于篇幅原因這里僅僅對其中的關(guān)鍵概念進(jìn)行了講解。下一篇我們會(huì)對這種接口范式進(jìn)行進(jìn)一步的講解和實(shí)際使用。敬請關(guān)注：碼農(nóng)小胖哥 。

關(guān)注公眾號：碼農(nóng)小胖哥，獲取更多資訊

個(gè)人博客：https://felord.cn