#[derive(golem_rust::WIT_From_Into))]
    pub struct Person {
        pub name: String,
        pub age: i32,
    }

然后以下代码可以无问题编译

    let me = Person {
        name: "Jaro".to_owned(),
        age: 32,
    };

    let converted: WitPerson = me.into();

自定义数据类型名称

上述宏假定我们从 From<> 和 Into<> 推导的数据类型称为 WitPerson。默认情况下，宏假定数据类型的名称是 Wit + 注解数据类型名称。如果名称不同，我们需要添加 #[wit_type_name(DerivedName)] 属性。

    #[derive(golem_rust::WIT_From_Into))]
    #[wit_type_name(DerivedName)]
    pub struct Person {
        pub name: String,
        pub age: i32,
    }

字段重命名

如果派生数据类型中的字段名称不同，我们可以使用字段属性 #[rename_field("")]

    #[derive(golem_rust::WIT_From_Into))]
    #[wit_type_name(WitPerson)]
    pub struct Person {

        #[rename_field("name2")]
        pub name: String,

        #[rename_field("age2")]
        pub age: i32,
    }

枚举

与结构体非常相似，假设我们有以下枚举数据类型

    #[derive(golem_rust::WIT_From_Into))]
    #[wit_type_name(SimilarColors)] 
    pub enum Colors {
        Red,
        White,

        #[rename_field("Yellow2")]
        Yellow,
    }

    pub enum SimilarColors {
        Red,
        White,
        Yellow2,
    }

然后非常简单，我们可以使用 .into() 并将其编译。

    let yellow = Colors::Yellow;

    let wit_collors: SimilarColors = yellow.into();

更多示例可以在 golem-rust-example/src/main.rs 中找到。

2. 从 Rust 模块生成 WIT 文件。

假设我们正在构建一个由 Golem Cloud 提供支持的拍卖应用。我们希望支持一些基本功能，例如

• 初始化拍卖
• 获取所有拍卖
• 关闭拍卖
• 创建一个竞标者
• 出价。同时，我们还需要一些数据类型来描述拍卖、竞标者、结果等。

WIT 文件本身可能看起来像这样

package auction:app

interface api {

    record bidder-id {
        bidder-id: string,
    }

    record auction-id {
        auction-id: string,
    }

    record auction {
        auction-id: auction-id, 
		name: string, 
		description: string, 
		starting-price: float32, 
		deadline: deadline,
    }

    variant bid-result {
        failure(string), 
 		success
    }

    type deadline = u64
                

    initialize: func(auction: auction)
                    

    bid: func(bidder-id: bidder-id, price: float32) -> bid-result
                    

    close-auction: func() -> option<bidder-id>
                    

    create-bidder: func(name: string, address: string) -> bidder-id
                    

    create-auction: func(name: string, description: string, starting-price: float32, deadline: u64) -> auction-id
                    

    get-auctions: func() -> list<auction>
                    
}

world golem-service {
    export api
}

在编写此文件时可能会出现许多错误，特别是如果您不熟悉 WIT。但大多数情况下，它只是一个可以避免的样板。

只需使用 #[golem_rust::create_wit_file] 宏来注释您的内部模块。

#[golem_rust::create_wit_file]
mod auction_app {
    
    struct BidderId {
        bidder_id: String 
    }

    struct AuctionId {
        auction_id: String
    }

    struct Auction {
        auction_id: AuctionId,
        name: String, 
        description: String,
        starting_price: f32,
        deadline: Deadline,
    }

    enum BidResult {
        Failure(String),
        Success 
    }

    type Deadline = u64;

    trait AuctionService {

        fn initialize(auction: Auction);

        fn bid(bidder_id: BidderId, price: f32) -> BidResult;

        fn close_auction() -> Option<BidderId>;

        fn create_bidder(name: String, address: String) -> BidderId;

        fn create_auction(name: String, description: String, starting_price: f32, deadline: u64) -> AuctionId;

        fn get_auctions() -> Vec<Auction>;
    }
}

#[golem_rust::create_wit_file]
mod package_name {

}

package package:name
    
interface api {

}

world golem-service {
    export api
}