首先，在结构体上添加DeserializeOwned特性。（cder引入了serde作为依赖，因此可以使用derive(Deserialize)宏来完成这项工作）

use serde::Deserialize;

#[derive(Deserialize)] // add this derive macro
User {
  name: String,
  email: String,
}

impl User {
  // can be sync or async functions
  async fn insert(&self) -> Result<(i64)> {
    //
    // inserts a corresponding record into table, and returns its id when succeeded
    //
  }
}

您的用户种子由两个独立的文件定义，数据和胶水代码。

现在创建一个种子数据文件'fixtures/users.yml'。

# fixtures/users.yml

User1:
  name: Alice
  email: '[email protected]'
User2:
  name: Bob
  email: '[email protected]'

现在您可以将上述两个用户插入到数据库中。

use cder::DatabaseSeeder;

async fn populate_seeds() -> Result<()> {
    let mut seeder = DatabaseSeeder::new()

    seeder
        .populate_async("fixtures/users.yml", |input| {
            async move { User::insert(&input).await }
        })
        .await?;

    Ok(())
}

瞧！您将在数据库中填充记录Alice和Bob。

与非异步函数一起工作

如果您的函数是非异步（普通）函数，请使用Seeder::populate而不是Seeder::populate_async。

use cder::DatabaseSeeder;

fn main() -> Result<()> {
    let mut seeder = DatabaseSeeder::new();

    seeder
        .populate("fixtures/users.yml", |input| {
            // this block can contain any non-async functions
            // but it has to return Result<i64> in the end
            diesel::insert_into(users)
                .values((name.eq(input.name), email.eq(input.email)))
                .returning(id)
                .get_result(conn)
                .map(|value| value.into())
        })

        Ok(())
}

构建实例

如果您想在插入之前对反序列化的结构体有更细粒度的控制，请使用StructLoader。

use cder::{ Dict, StructLoader };

fn construct_users() -> Result<()> {
    // provide your fixture filename followed by its directory
    let mut loader = StructLoader::<User>::new("users.yml", "fixtures");

    // deserializes User struct from the given fixture
    // the argument is related to name resolution (described later)
    loader.load(&Dict::<String>::new())?;

    let customer = loader.get("User1")?;
    assert_eq!(customer.name, "Alice");
    assert_eq!(customer.email, "[email protected]");

    let customer = loader.get("User2")?;
    assert_eq!(customer.name, "Bob");
    assert_eq!(customer.email, "[email protected]");

    ok(())
}

动态定义值

cder根据一些规则替换了某些标签的值。这种'预处理'在反序列化之前运行，因此您可以定义依赖于您本地环境的动态值。

目前涵盖了以下两种情况

1. 定义关系（外键）

假设您有两条记录要插入到companies表中。companies.id是未知的，因为它们在插入时由本地数据库提供。

# fixtures/companies.yml

Company1:
  name: MassiveSoft
Company2:
  name: BuggyTech

现在您有引用这些公司的用户记录

# fixtures/users.yml

User1:
  name: Alice
  company_id: 1 // this might be wrong

您可能会在构建User1时失败，因为Company1不保证id=1（尤其是在您已经操作过companies表的情况下）。为此，请使用${{ REF(label) }}标签替换未定的值。

User1:
  name: Alice
  company_id: ${{ REF(Company1) }}

现在，Seeder是如何知道Company1记录的id的？如前所述，给 Seeder 的块必须返回Result<i64>。Seeder将结果值映射到记录标签，稍后将重新使用它来解决标签引用。

use cder::DatabaseSeeder;

async fn populate_seeds() -> Result<()> {
    let mut seeder = DatabaseSeeder::new();
    // you can specify the base directory, relative to the project root
    seeder.set_dir("fixtures");

    // Seeder stores mapping of companies record label and its id
    seeder
        .populate_async("companies.yml", |input| {
            async move { Company::insert(&input).await }
        })
        .await?;
    // the mapping is used to resolve the reference tags
    seeder
        .populate_async("users.yml", |input| {
            async move { User::insert(&input).await }
        })
        .await?;

    Ok(())
}

注意事项

1. 先插入包含'引用'记录的文件（如上面的示例中的'companies'），然后再插入'引用'记录（如'users'）。
2. 目前 Seeder 在读取源文件时解析标签。这意味着您不能在同一个文件中有对记录的引用。如果您想从一个文件中引用用户记录，可以通过将yaml文件分成两部分来实现。

2. 环境变量

您还可以使用${{ ENV(var_name) }}语法来引用环境变量。

Dev:
  name: Developer
  email: ${{ ENV(DEVELOPER_EMAIL) }}

Dev:
  name: Developer
  email: ${{ ENV(DEVELOPER_EMAIL:-"[email protected]") }}

Label_1:
  name: Alice
  email: '[email protected]'
Label_2:
  name: Bob
  email: '[email protected]'

struct CustomerProfile {
  name: String,
  contact: Option<Contact>,
}

enum Contact {
  Email { email: String }
  Employee(usize),
  Unknown
}

Customer1:
  name: "Jane Doe"
  contact: !Email { email: "[email protected]" }
Customer2:
  name: "Uncle Doe"
  contact: !Employee(10100)
Customer3:
  name: "John Doe"
  contact: !Unknown