如何使用 Rust 來構建微服務？

作者丨Diego Pacheco

譯者丨金靈傑

策劃丨田曉旭

Rust 是一門很棒的語言，也是我在 2019 年和 2020 年（截止當前）學的最多的語言。Rust 幾乎可以和任何語言互操作，同時對於容器和在 Kubernetes 上運行也非常友好。

今天，我想展示下如何使用 Rust 構建一個簡單的微服務。本文中，我們將使用 Actix、Tokio-Postgress 和其他一些庫，使用 Postgres 作為唯一數據源，同時為了便於開發，我們會將其運行在 Docker 容器中。另外，我還會使用自己開發的 Barrel 作為數據庫遷移工具。代碼將全部使用異步和非阻塞 IO 實現。

總體架構

這裡我們採用多層架構，業務規則和 REST 請求定義在 news-contract 中實現。SOA 約定定義在 news-contract + news-service，數據結構（News）定義在 news-contract。REST 請求的 endpoint 和服務定義在 news-service 中。Postgres 持久化相關功能定義在 news-dao 中。

代碼結構

我們一個有 5 個工程，最頂層是一個全局工作空間，作為第一個工程。其余工程有：

news-contract：SOA 約定部分，這裡定義了其他工程使用的 News 結構體。

news-dao：包含響應式持久化代碼，基於 tokio-postgres 實現對 News 資源的增刪改查操作。

news-migrations：我們使用 barrel 和自定義邏輯來創建表結構和初始化測試數據。

news-service：這裡我們有 endpoint、服務實現和包含 actix-web 框架配置的入口代碼。

每個工程都有自己的依賴，定義在其 Cargo.toml 文件中。

同時，工程中還有 2 個處理 Docker 容器的腳本，一個用於運行 Postgres，另一個用於運行 psql。

數據遷移

現在，讓我們來看看如何實現數據遷移（在 Postgres SQL 中創建表和插入記錄）。

首先，我們需要連接運行在 Docker 容器中的 Postgres 數據庫，創建一個向量，向其中添加所有需要運行的數據遷移邏輯。然後循環執行其中的所有數據遷移邏輯，並檢查結果是否正常。

現在，讓我們看下一段代碼，數據遷移邏輯。

我創建了一個名為 NewsMigration 的 trait，其中包含 new 函數（用於創建結構體）和 run 函數（用於運行數據遷移）。如你所見，然後創建了 CreateTableNewsMigration 結構體，使用 impl 關鍵字實現了這個 trait。這裡我使用了 barrel 來創建表結構，barrel 將會生成 Postgres SQL 的 INSERT 語句。最後，我們使用 pg_client 在 Postres 中運行生成的腳本。這段代碼看上去很繞：&news_table[..]，這裡我們在傳遞 String 類型 news_table 的引用，將其變成 slice 之後，傳給 pg_client 的 execute 函數。

SOA 約定

首先讓我們來看下約定的第一部分，News 結構體。

我們定義了一個名為 News 的結構體，同時使用了 serde 和 serde_json，以便於該結構體的序列化和反序列化。這個結構體還實現了 Display trait，用於列印結構體內容。最後在文件的末尾有一個單元測試，用於測試結構體的列印。

Endpoint 和服務

這裡我定義了一個基於 actix 的 HttpServer，然後定義了一系列處理器：index、list_news、insert_news、get_news_by_id 和 delete_news_by_id。服務將會運行在本地的 8080 端口上。所有的信息都使用 log 和 env_logger creates 進行日誌記錄。

現在讓我們來看下 endpoint.rs，這裡有 REST 請求的定義。

這裡我們使用宏來定義 REST 操作，例如 PUT、DELETE 和 GET。每個函數處理器都定義成公有且非常簡單，僅僅調用對應的服務，將返回結果序列化成 json 結構返回。

這是服務的實現，這裡沒有任何 REST 或者 actix 框架的依賴。這裡是實現校驗、業務邏輯和代理請求 dao crate 的地方。所有函數的增刪改查操作都是異步的。

DAO

這裡是魔法發生的地方，我們使用了 tokio-postgress 庫。先來看下代碼。

視頻：代碼走讀和功能演示

https://vimeo.com/384505355

完整代碼

https://github.com/diegopacheco/rust-playground/tree/master/rust-microservice

參考鏈接

http://diego-pacheco.blogspot.com/2020/01/building-microservice-with-rust.html

點個在看少個 bug