什么是 awto？

Awto 将你的 Rust 项目视为微服务的真相来源，并根据你的架构和服务生成 数据库表 和 protobuf。

数据库生成

• 数据库表是从你的 Rust 结构体生成的
• 检测到你的结构体的更改，并将相应地修改表架构

Protobuf 生成

• 从你的模型生成 protobuf 架构
• 从你的应用程序服务编译 protobuf 服务器

概念

使用 awto，你为每个微服务创建一个 Cargo 工作空间。在你的工作空间下，你创建两个库：schema 和 service

架构

架构库的目的是定义你的微服务模型，这些模型将用于生成数据库表。

// schema/src/lib.rs
use awto::prelude::*;

schema! {
    #[database_table]
    #[protobuf_message]
    pub struct Product {
        pub id: Uuid,
        pub created_at: DateTime<FixedOffset>,
        pub updated_at: DateTime<FixedOffset>,
        pub name: String,
        #[awto(max_len = 120)]
        pub description: Option<String>,
        #[awto(default = 0)]
        pub price: i64,
    }
}

请参阅 examples/ecom 中的示例架构。

服务

服务库是你编写业务逻辑的地方。这种业务逻辑可以稍后用于创建 protobuf API（并在未来创建 graphql API）。

// service/src/lib.rs

register_services!(ProductService);

pub struct ProductService {
    pub conn: DatabaseConnection,
}

#[protobuf_service]
impl ProductService {
    pub async fn find_by_id(&self, request: ProductId) -> Result<Product, Status> {
        let product = product::Entity::find_by_id(request.id)
            .one(&self.conn)
            .await
            .map_err(|err| Status::internal(err.to_string()))?
            .ok_or_else(|| Status::not_found("product not found"))?;

        Ok(product.into())
    }
}

请参阅 examples/ecom 中的示例服务。

Cargo 工作空间

你的架构和服务库应在 cargo 工作空间下。

# root Cargo.toml
[workspace]
members = ["schema", "service"]

请参阅 examples/ecom 中的示例项目。

Awto CLI

Awto 提供了一个 CLI，用于使用 awto compile <lib> 命令生成额外的库。目前可用的库有

cargo install awto-cli

awto compile <output>