摘要：對(duì)于集成測(cè)試，直接模擬實(shí)際的環(huán)境，再加上合適的，目前看來(lái)也還不錯(cuò)。這里給出兩個(gè)例子集成測(cè)試單元測(cè)試都是基于寫(xiě)的，各位可以體驗(yàn)其酸爽度。好啦，本期內(nèi)容就此結(jié)束，請(qǐng)保持關(guān)注，期待下期繼續(xù)本系列其他文章入坑須知入坑須知

隨著Vert.x進(jìn)化到3.5.0，本系列也迎來(lái)了新篇章。

對(duì)于CORS，搞Web開(kāi)發(fā)（不論你是前端，還是后端）的同志應(yīng)該不陌生，尤其是如今微服務(wù)盛行的時(shí)代，CORS更是最常用的配置項(xiàng)之一。假若你對(duì)此還有一點(diǎn)點(diǎn)的疑問(wèn)，不用問(wèn)，你已經(jīng)落伍了！

Vert.x很早就支持了CORS，但到了3.5.0，出于安全性上的考慮，它增加了一個(gè)限制：

當(dāng)allowedOriginPattern為“*”時(shí)，allowCredentials不允許為“true”。

這個(gè)限制其實(shí)起源自協(xié)議的限制：

The string "*" cannot be used for a resource that supports credentials.The string "*" cannot be used for a resource that supports credentials.

即：Access-Control-Allow-Origin為“*”時(shí)，Access-Control-Allow-Credentials會(huì)被忽略，Credentials信息（一般是Cookie）也不會(huì)被user-agent發(fā)送。大家可以參考這篇文章（英文原版）了解如何安全地設(shè)置各個(gè)header。

在3.5.0時(shí)，當(dāng)allowedOriginPattern為“*”和allowCredentials為“true”時(shí)，Vert.x會(huì)產(chǎn)生一個(gè)異常，若不處理會(huì)導(dǎo)致Verticle不能正常啟動(dòng)。在之前的版本中，不會(huì)出現(xiàn)這種情況。

斷路器是個(gè)好東東，強(qiáng)烈建議在框架設(shè)計(jì)上就考慮它，以避免粗心的開(kāi)發(fā)者寫(xiě)的代碼擾亂其他好代碼。在我寫(xiě)dgate和dfx時(shí)，對(duì)所有對(duì)外暴露的服務(wù)也都強(qiáng)加了這個(gè)限制。

既然CB這么好，是不是動(dòng)過(guò)將其應(yīng)用到普通Handler上的念頭？不過(guò)由于Vert.x CB的文檔示例中給出的都是清一色的HTTP請(qǐng)求的例子，要想將CB推而廣之應(yīng)用到普通的Handler上還得費(fèi)點(diǎn)氣力。

在dfx中我寫(xiě)了一個(gè)工具類(lèi)，對(duì)此需求進(jìn)行了封裝：

public static void withCircuitBreaker(Vertx vertx, CircuitBreaker circuitBreaker
        , Accessible accessible, Map params, Handler

它的使用很簡(jiǎn)單：

Utils.withCircuitBreaker(vertx, circuitBreaker, accessible, body.getMap()
               , result -> Utils.fireJsonResponse(response, 200, result)
               , throwable -> Utils.fireSingleMessageResponse(response, 500, throwable.getMessage()));

各位可依葫蘆畫(huà)瓢將其改為自己的形式，其中的重點(diǎn)在于以“vertx.executeBlocking”方式來(lái)執(zhí)行Handler的代碼。

在稍微正規(guī)的隊(duì)伍中，自動(dòng)化測(cè)試應(yīng)該已經(jīng)是一個(gè)標(biāo)準(zhǔn)實(shí)踐了，并且Vert.x對(duì)于測(cè)試也提供了支持。

不過(guò)，我不喜歡。原因有幾個(gè)：

Vert.x Unit是基于JUnit，而我已經(jīng)有鐘情的測(cè)試框架：Spock。相比起JUnit而言，后者簡(jiǎn)直可以說(shuō)是Java測(cè)試領(lǐng)域的戰(zhàn)斗機(jī)。

好的單元測(cè)試本來(lái)就是要盡量少的依賴(lài)所用框架，注意這一點(diǎn)之后，盡力將類(lèi)設(shè)計(jì)得好測(cè)試，這樣的結(jié)果就是普通的單元測(cè)試類(lèi)編寫(xiě)。既然有讓人爽的工具用，也就沒(méi)有必要去用Vert.x Unit了。

對(duì)于集成測(cè)試，直接模擬實(shí)際的環(huán)境，再加上合適的timer，目前看來(lái)也還不錯(cuò)。而且Vert.x Unit中也一樣需要用timer，這樣一來(lái)，也就沒(méi)有必要專(zhuān)門(mén)用它了。

為了證明我所言非虛，大家可以去看看dgate和dfx的測(cè)試代碼。這里給出兩個(gè)例子：

集成測(cè)試

單元測(cè)試

都是基于Spock寫(xiě)的，各位可以體驗(yàn)其酸爽度。

在本系列第一篇里，我就提出了一個(gè)鐘意的工程結(jié)構(gòu)組成，但里面沒(méi)有提到“運(yùn)行時(shí)外部配置文件”這一常見(jiàn)的實(shí)踐。

經(jīng)過(guò)若干項(xiàng)目的錘煉之后，目前對(duì)于這種運(yùn)行時(shí)的外部配置文件，我基本形成了一個(gè)固定套路：Groovy DSL + Groovy ConfigSlurper。它倆簡(jiǎn)直是完成這一任務(wù)的絕配，比起Vert.x的提供的json配置文件要爽太多。

看看Gradle的build文件，你就可以知道這種DSL的靈活度可以到什么程度，更何況Groovy的語(yǔ)法對(duì)于Java開(kāi)發(fā)者極其友好。

或許有人會(huì)覺(jué)得Groovy不酷，甚至有點(diǎn)鄙夷，言必稱(chēng)Scala、Clojure、Kotlin、Go或者Rust。對(duì)此，哥只想說(shuō)：作為開(kāi)發(fā)者，最讓人鄙夷的是交不出活，客戶才不關(guān)心你用什么語(yǔ)言呢！

dgate是我寫(xiě)的一個(gè)基于vertx的輕量級(jí)網(wǎng)關(guān)，所有的配置全部通過(guò)配置文件來(lái)定義，無(wú)需數(shù)據(jù)庫(kù)。關(guān)于它的詳細(xì)介紹，可以參見(jiàn)其文檔。為了說(shuō)明上一節(jié)采用Groovy DSL的靈活度，這里展示幾個(gè)dgate的配置例子。

利用dgate的mock功能，分離開(kāi)的前后端開(kāi)發(fā)人員可以并行工作，只需將mock響應(yīng)配置到dgate的配置文件中就好。

"/summary" {
    expected {
        statusCode = 200
        payload {
            eqLocations = []
            opRateInLast30Days = []
            myOrgs = [
                ["name": "org1", "admin": false]
            ]
        }
    }
}

動(dòng)態(tài)Mock為那些返回動(dòng)態(tài)結(jié)果（如某些情況下成功，某些情況下失敗）的URL模擬提供了便利。

"/login" {
    required = ["sub", "password"]
    methods = [HttpMethod.GET, HttpMethod.POST]
    expected {
        statusCode = 200
        payload = {
            JWTAuth jwtAuth = Utils.createAuthProvider(Vertx.vertx())
            JWTTokenGenerator tokenGenerator = new JWTTokenGenerator(jwtAuth)
            [token: tokenGenerator.token(["sub": "……", "name": "……", "role": "normal"], 200)]
        }
    }
}

上例將模擬一個(gè)實(shí)際的動(dòng)態(tài)JWT，這樣的好處在于，方便前端/移動(dòng)端開(kāi)發(fā)直接去完成刷新token或重新登錄的過(guò)程，而不需要再針對(duì)此場(chǎng)景做其他特殊處理。

請(qǐng)注意，為了產(chǎn)生動(dòng)態(tài)結(jié)果，此處的payload使用的是閉包，而不像前一例用的是Map。此時(shí)，閉包的返回值為Mock響應(yīng)的結(jié)果。

以上的例子已經(jīng)充分展現(xiàn)了將Groovy DSL作為運(yùn)行時(shí)外部配置的能力，可以說(shuō)是完勝Vert.x自帶的json配置方式。

好啦，本期內(nèi)容就此結(jié)束，請(qǐng)保持關(guān)注，期待下期繼續(xù)！

Vert.x入坑須知（1）

Vert.x入坑須知（2）