데이터 모델링 및 직렬화

사용자 지정 구조체 예제

다음 코드는 serde 직렬화 특성을 구현하는 샘플 Vegetable 구조체를 정의합니다.

#[derive(Serialize, Deserialize)]
struct Vegetable {
    name: String,
    category: String,
    tropical: bool,
}

다음 코드는 일반 유형 매개 변수로 Vegetable 를 사용하여 vegetables collection에 액세스합니다.

let my_coll: Collection<Vegetable> = client
    .database("db")
    .collection("vegetables");

Collection 인스턴스는 Vegetable 구조체로 매개변수화되어 있으므로 이 유형으로 CRUD 작업을 수행할 수 있습니다. 다음 코드는 Vegetable 인스턴스를 컬렉션에 삽입합니다.

let calabash = Vegetable {
    name: "calabash".to_string(),
    category: "gourd".to_string(),
    tropical: true,
};
my_coll.insert_one(calabash).await?;

다중 매개변수화

collection에 여러 스키마가 포함된 경우 사용자 지정 유형을 정의하여 각 데이터 유형을 모델링하고 각 유형에 대해 원본 Collection 인스턴스의 복제본을 만들 수 있습니다. clone_with_type() 메서드를 사용하여 Collection 인스턴스의 복제본을 만들 수 있습니다.

원래 Square 구조체를 사용하여 collection을 매개변수화했지만 나중에 Circle 구조체에 의해 모델링된 다른 유형의 데이터를 collection에 삽입하고 싶다는 것을 알게 되었다고 가정해 보겠습니다. 다음 코드는 Square 유형으로 collection을 매개변수화한 다음 Circle 유형으로 매개변수화된 collection의 복제본을 만듭니다.

let shapes_coll: Collection<Square> = client
    .database("db")
    .collection("shapes");
// ... perform some operations with Square
let shapes_coll: Collection<Circle> = shapes_coll.clone_with_type();
// ... perform some operations with Circle

문자열을 ObjectId로 직렬화

문서의 _id 필드를 구조체의 16진수 문자열로 표현할 수 있습니다. 16진수 문자열을 ObjectId BSON types로 변환하려면 serialize_hex_string_as_object_id 헬퍼 함수를 serialize_with 속성 값으로 사용합니다. 다음 예시에서는 serialize_with 속성을 _id 필드에 연결하여 드라이버가 16진수 문자열을 ObjectId 유형으로 직렬화하도록 합니다.

#[derive(Serialize, Deserialize)]
struct Order {
    #[serde(serialize_with = "serialize_hex_string_as_object_id")]
    _id: String,
    item: String,
}

드라이버가 샘플 Order 구조체를 BSON으로 직렬화하는 방법을 확인하려면 다음 Struct 및 BSON 탭에서 선택합니다.

let order = Order {
    _id: "6348acd2e1a47ca32e79f46f".to_string(),
    item: "lima beans".to_string(),
};

{
  "_id": { "$oid": "6348acd2e1a47ca32e79f46f" },
  "item": "lima beans"
}

DateTime을 문자열로 직렬화

문서의 DateTime 필드 값을 BSON에서 ISO 형식의 문자열로 표현할 수 있습니다. 이 변환을 지정하려면 serialize_bson_datetime_as_rfc3339_string 헬퍼 함수를 DateTime 값이 있는 필드에 첨부된 serialize_with 속성의 값으로 사용합니다. 다음 예시에서는 serialize_with 속성을 delivery_date 필드에 연결하여 드라이버가 DateTime 값을 문자열로 직렬화하도록 합니다.

#[derive(Serialize, Deserialize)]
struct Order {
    item: String,
    #[serde(serialize_with = "serialize_bson_datetime_as_rfc3339_string")]
    delivery_date: DateTime,
}

드라이버가 샘플 Order 구조체를 BSON으로 직렬화하는 방법을 확인하려면 다음 Struct 및 BSON 탭에서 선택합니다.

let order = Order {
    item: "lima beans".to_string(),
    delivery_date: DateTime::now(),
};

{
  "_id": { ... },
  "item": "lima beans",
  "delivery_date": "2023-09-26T17:30:18.181Z"
}

u32를 f64로 직렬화

문서에서 u32 필드 값을 BSON의 f64 또는 Double 유형으로 나타낼 수 있습니다. 이 변환을 지정하려면 serialize_u32_as_f64 헬퍼 함수를 u32 값이 있는 필드에 첨부된 serialize_with 속성의 값으로 사용합니다. 다음 예시에서는 serialize_with 속성을 quantity 필드에 연결하여 드라이버가 u32 값을 Double 유형으로 직렬화하도록 합니다.

#[derive(Serialize, Deserialize)]
struct Order {
    item: String,
    #[serde(serialize_with = "serialize_u32_as_f64")]
    quantity: u32,
}

기타 속성 및 모듈

헬퍼 함수 외에도 bson 라이브러리는 직렬화와 역직렬화를 모두 처리하는 모듈을 제공합니다. 특정 필드 또는 변형에서 사용할 모듈을 선택하려면 with 속성 값을 모듈 이름으로 설정합니다.

#[derive(Serialize, Deserialize)]
struct MyStruct {
    #[serde(with = "<module>")]
    field1: u32,
    // ... other fields
}

이러한 모듈의 전체 목록은 serde_helpers API 설명서를 참조하세요.

serde 크레이트는 직렬화를 사용자 지정하기 위한 다른 많은 속성을 제공합니다. 다음 목록에서는 몇 가지 일반적인 속성과 해당 기능을 설명합니다.

• rename: Rust 구조체 또는 변형 이름 대신 지정된 이름을 사용하여 필드를 직렬화 및 역직렬화합니다.

• skip: 지정된 필드를 직렬화 또는 역직렬화하지 않습니다.

• default: 역직렬화 중에 값이 없으면 다음의 기본값을 사용합니다. Default::default()

속성의 전체 목록은 serde serde 속성 API 설명서를 참조하세요.

API 문서

이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 문서를 참조하세요.

• collection()

• clone_with_type()

• serialize_with Serde 속성

• deserialize_with Serde 속성

• with Serde 속성