知识卡片
构建器集中复杂对象初始化
构建器在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