← 返回起始笔记位置

知识卡片

结构图卡 · 6074.c.3.a

构建器集中复杂对象初始化

理解等级:中级

构建器在new中接收必填参数,通过命名方法设置可选项,最后build生成目标对象,让调用点少写重复字段。新增可选字段时,初始化责任集中在构建器中。构建器不能自动验证所有业务规则;是否返回Result或允许某种组合,仍需按对象契约设计。

结构图:

classDiagram
class Details {
  +String given_name
  +String family_name
  +time.Date date_of_birth
}
class DetailsBuilder {
  +new(given_name: &str, family_name: &str, date_of_birth: time.Date) Self
  +preferred_name(self, preferred_name: &str) Self
  +middle_name(self, middle_name: &str) Self
  +build(self) Details
}
DetailsBuilder *-- Details : 示例持有待构建值

这里只画原书按值构建版本;设置方法实际以mut self接收以修改内部对象,再返回Self。Details仅展示相关必填字段。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • Chapter 1. Types Item 7: Use builders for complex types · 查看原书依据

      DetailsBuilder(Details); impl DetailsBuilder { /// Start building a new [`Details`] object. pub fn new( given_name: &str, family_name: &str, date_of_birth: time::Date, ) -> Self { DetailsBuilder(Details { given_name: given_name.to_owned(), preferred_name: None, middle_name: None, family_name: family_name.to_owned(), mobile_phone: None, date_of_birth, last_se

    参考来源

    - 位置:《Effective Rust 35 Specific Ways to Improve Your Rust Code (David Drysdale)》第1章《Item 7: Use builders for complex types》(spine5;extracted/Effective Rust 35 Specific Ways to Improve Your Rust Code (David Drysdale)/_epub-src/OEBPS/ch01.html;u038-ch01-050)。 - 结论依据:原文在“DetailsBuilder”附近的定义、例子或代码支撑本卡核心说明:构建器在new中接收必填参数,通过命名方法设置可选项,最后build生成目标对象,让调用点少写重复字段。边界按已读前提解释;示例未执行。 - 原始内容:DetailsBuilder(Details); impl DetailsBuilder { /// Start building a new [`Details`] object. pub fn new( given_name: &str, family_name: &str, date_of_birth: time::Date, ) -> Self { DetailsBuilder(Details { given_name: given_name.to_owned(), preferred_name: None, middle_name: None, family_name: family_name.to_owned(), mobile_phone: None, date_of_birth, last_se