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

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

1. 總體架構

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

2. 代碼結構

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

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

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

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

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

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

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

3. 數據遷移

現在，讓我們來看看如何實現數據遷移（在 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 函數。

4. SOA 約定

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

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

5. 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 的地方。所有函數的增刪改查操作都是異步的。

6. DAO

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

這是 DAO 層的實現。這里有一個名為 connect() 的函數用于連接 Postgres 數據庫，它使用異步非阻塞的方式實現。然后展示的是如何實現 find_by_id 功能。在 Postgres 中 ID 使用 UUID 來生成，因此需要將其轉成字符串類型，這就是為什么代碼中會看見 id::text=$1。同樣在這一行中，我將從入參獲取到的 ID 轉換成了 &[&id] 傳入。DAO 層還有很多函數，有興趣的話可以在我的 GitHub 上查看完整代碼。

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

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