本指南解釋了我如何簡(jiǎn)化 Go 微服務(wù)中請(qǐng)求、驗(yàn)證和回應(yīng)的處理，旨在實(shí)現(xiàn)簡(jiǎn)單性、可重用性和更易於維護(hù)的程式碼庫(kù)。

介紹

我在 Go 中使用微服務(wù)已經(jīng)有一段時(shí)間了，我一直很欣賞這種語(yǔ)言提供的清晰度和簡(jiǎn)單性。我最喜歡 Go 的事情之一是幕後沒有發(fā)生任何事情；程式碼始終是透明且可預(yù)測(cè)的。

但是，開發(fā)的某些部分可能非常乏味，尤其是在驗(yàn)證和標(biāo)準(zhǔn)化 API 端點(diǎn)中的回應(yīng)時(shí)。我嘗試了許多不同的方法來解決這個(gè)問題，但最近，在編寫 Go 課程時(shí)，我想到了一個(gè)相當(dāng)意想不到的想法。這個(gè)想法為我的訓(xùn)練員增添了一絲“魔力”，令我驚訝的是，我喜歡它。透過這個(gè)解決方案，我能夠集中請(qǐng)求的驗(yàn)證、解碼和參數(shù)解析的所有邏輯，並統(tǒng)一 API 的編碼和回應(yīng)。最終，我在保持程式碼清晰性和減少重複實(shí)現(xiàn)之間找到了平衡。

問題

開發(fā) Go 微服務(wù)時(shí)，常見任務(wù)是有效處理傳入的 HTTP 請(qǐng)求。此過程通常涉及解析請(qǐng)求主體、提取參數(shù)、驗(yàn)證資料以及發(fā)回一致的回應(yīng)。讓我用一個(gè)例子來說明這個(gè)問題：

讓我解釋一下上面的程式碼，重點(diǎn)是我們手動(dòng)處理的處理程序部分：

• 處理路徑參數(shù)：驗(yàn)證所需的路徑參數(shù)是否存在並處理它。
• 解碼請(qǐng)求正文：確保正確解析傳入的 JSON。
• 驗(yàn)證：使用驗(yàn)證器包檢查請(qǐng)求欄位是否符合要求標(biāo)準(zhǔn)。
• 錯(cuò)誤處理：當(dāng)驗(yàn)證失敗或JSON格式錯(cuò)誤時(shí)，用適當(dāng)?shù)腻e(cuò)誤訊息回應(yīng)客戶端。
• 一致的回應(yīng)：手動(dòng)建立響應(yīng)結(jié)構(gòu)。

雖然程式碼有效，但它涉及大量的樣板邏輯，必須為每個(gè)新端點(diǎn)重複這些邏輯，這使得維護(hù)更加困難並且容易出現(xiàn)不一致。

那麼，我們?cè)撊绾胃倪M(jìn)呢？

分解代碼

為了解決這個(gè)問題並提高程式碼的可維護(hù)性，我決定將邏輯分為三個(gè)不同的層：請(qǐng)求、回應(yīng)和驗(yàn)證 。這種方法封裝了每個(gè)部分的邏輯，使其可重複使用且更易於獨(dú)立測(cè)試。

請(qǐng)求層

Request 層負(fù)責(zé)從傳入的 HTTP 請(qǐng)求中解析和提取資料。透過隔離這個(gè)邏輯，我們可以標(biāo)準(zhǔn)化資料的處理方式，並確保所有解析都得到統(tǒng)一處理。

驗(yàn)證層

驗(yàn)證層僅專注於根據(jù)預(yù)定義規(guī)則驗(yàn)證解析的資料。這使驗(yàn)證邏輯與請(qǐng)求處理分開，使其在不同端點(diǎn)之間更易於維護(hù)和重複使用。

響應(yīng)層

Response 層處理程序回應(yīng)的建構(gòu)與格式化。透過集中回應(yīng)邏輯，我們可以確保所有 API 回應(yīng)遵循一致的結(jié)構(gòu)，從而簡(jiǎn)化偵錯(cuò)並改善客戶端互動(dòng)。

所以......雖然將程式碼分成層可以帶來諸如可重用性、可測(cè)試性和可維護(hù)性之類的好處，但它也帶來了一些權(quán)衡。複雜性的增加可能會(huì)使新開發(fā)人員更難掌握專案結(jié)構(gòu)，而對(duì)於簡(jiǎn)單的端點(diǎn)，使用單獨(dú)的層可能會(huì)讓人感覺過度，可能會(huì)導(dǎo)致過度設(shè)計(jì)。了解這些優(yōu)點(diǎn)和缺點(diǎn)有助於決定何時(shí)有效應(yīng)用此模式。

在一天結(jié)束的時(shí)候，總是關(guān)於最困擾你的事情。正確的？所以，現(xiàn)在讓我們介入我們的舊程式碼並開始實(shí)現(xiàn)上面提到的層。

將程式碼重構(gòu)為層

第 1 步：建立請(qǐng)求層

首先，我們重構(gòu)程式碼，將請(qǐng)求解析封裝到專用的函數(shù)或模組中。此層僅專注於讀取和解析請(qǐng)求主體，確保其與處理程序中的其他職責(zé)分離。

建立一個(gè)新檔案httpsuite/request.go:

注意：此時(shí)，我不得不使用反射。也許我太愚蠢了，找不到更好的等待去做。 ？

當(dāng)然，我們也可以測(cè)試這個(gè)，建立測(cè)試檔httpsuite/request_test.go:

如您所見，請(qǐng)求層使用驗(yàn)證層。然而，我仍然希望在程式碼中保持層的分離，不僅是為了更容易維護(hù)，而且因?yàn)槲铱赡苓€想使用隔離的驗(yàn)證層。

根據(jù)需要，將來我可能會(huì)決定將所有層保持隔離，並透過使用一些介面來允許其相互依賴。

第 2 步：實(shí)現(xiàn)驗(yàn)證層

一旦請(qǐng)求解析被分離，我們就會(huì)建立一個(gè)獨(dú)立的驗(yàn)證函數(shù)或模組來處理驗(yàn)證邏輯。透過隔離此邏輯，我們可以輕鬆測(cè)試它並跨多個(gè)端點(diǎn)應(yīng)用一致的驗(yàn)證規(guī)則。

為此，我們建立 httpsuite/validation.go 檔案：

現(xiàn)在，建立測(cè)試檔案httpsuite/validation_test.go:

第 3 步：建立響應(yīng)層

最後，我們將響應(yīng)構(gòu)造重構(gòu)為一個(gè)單獨(dú)的模組。這可確保所有回應(yīng)遵循一致的格式，從而更輕鬆地管理和調(diào)試整個(gè)應(yīng)用程式中的回應(yīng)。

建立檔案httpsuite/response.go:

建立測(cè)試檔案httpsuite/response_test.go:

此重構(gòu)的每一步都允許我們透過將特定職責(zé)委託給定義良好的層來簡(jiǎn)化處理程序邏輯。雖然我不會(huì)在每個(gè)步驟中顯示完整的程式碼，但這些變更涉及將解析、驗(yàn)證和回應(yīng)邏輯移動(dòng)到各自的函數(shù)或檔案中。

重構(gòu)範(fàn)例程式碼

現(xiàn)在，我們需要更改舊程式碼以使用圖層，讓我們看看它會(huì)是什麼樣子。

透過將處理程序程式碼重構(gòu)為請(qǐng)求解析、驗(yàn)證和回應(yīng)格式化層，我們成功刪除了先前嵌入處理程序本身的重複邏輯。這種模組化方法不僅提高了可讀性，而且透過保持每個(gè)職責(zé)的重點(diǎn)和可重用性來增強(qiáng)可維護(hù)性和可測(cè)試性。現(xiàn)在，處理程序已簡(jiǎn)化，開發(fā)人員可以輕鬆理解和修改特定層，而不會(huì)影響整個(gè)流程，從而創(chuàng)建更清晰、更具可擴(kuò)展性的程式碼庫(kù)。

結(jié)論

我希望這份關(guān)於使用專用請(qǐng)求、驗(yàn)證和回應(yīng)層來建立 Go 微服務(wù)的逐步指南能夠?yàn)閯?chuàng)建更清晰、更可維護(hù)的程式碼提供深入見解。我很想聽聽您對(duì)這種方法的想法。我錯(cuò)過了什麼重要的事情嗎？您將如何在自己的專案中擴(kuò)展或改進(jìn)這個(gè)想法？

我鼓勵(lì)您探索原始程式碼並直接在專案中使用httpsuite。您可以在 rluders/httpsuite 儲(chǔ)存庫(kù)中找到該庫(kù)。您的回饋和貢獻(xiàn)對(duì)於使這個(gè)函式庫(kù)對(duì) Go 社群更加強(qiáng)大和有用來說非常寶貴。

大家下期見。

以上是改進(jìn) Go 微服務(wù)中的請(qǐng)求、驗(yàn)證和回應(yīng)處理的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！