C#如何实现构建者模式_C# Builder链式调用流式接口设计【经典】

冰火之心

冰火之心

2026-05-05

243人浏览

原创

链式调用是 fluent builder 的必要手段,但 builder 模式的核心在于构造逻辑分离、终态校验集中和 product 不可变;builder 方法必须返回 this,build() 唯一出口负责校验与创建 product,避免中间校验与状态丢失。

c#如何实现构建者模式_c# builder链式调用流式接口设计【经典】

链式调用本身不等于建造者模式,但它是实现 Fluent Builder 的必要手段;真正决定是否是 Builder 模式的,是构造逻辑的分离、终态校验的集中、以及 Product 的不可变性。

Builder 类必须返回 this,不能返回新实例或 void

这是链式调用能成立的底层前提。返回 void 会中断调用链;返回新实例(比如 new PizzaBuilder())会导致前面设置的状态丢失——因为新对象没继承旧对象的字段值。

  • WithSize("large") 必须返回 this(即当前 PizzaBuilder 实例的引用),不是 new PizzaBuilder()
  • C# 中推荐用 public PizzaBuilder WithSize(string size),而非 void 或泛型返回类型——后者会干扰类型推导和 IDE 自动补全
  • 如果 Builder 内部状态含可变集合(如 List<string></string>),注意不要在 WithXxx() 中重新 new 它,否则历史数据清空

Build() 是唯一出口,所有校验和副作用必须放在这里

很多人把参数校验提前到每个 SetXxx() 方法里,结果导致错误堆栈分散、重复校验、甚至构建中途抛异常后无法继续链式调用。正确做法是延迟校验,只在 Build() 中一次性检查完整状态。

C函数速查手册(CHM版)
C函数速查手册(CHM版)

C函数速查手册(CHM版)

下载
  • 例如:URL 字段为空、超时值为负数、必填 toppings 数量不足——这些都该在 Build() 里统一判断并 throw InvalidOperationException
  • Build() 还应负责创建最终 Product 实例。Product 类建议用私有构造 + 只读属性,避免外部绕过 Builder 直接 new
  • 不要在 Builder 中持有 Product 引用并逐步修改它;而是把所有字段收集好,在 Build() 里 new 一次传参完成

Director 类多数时候是多余的一层

除非你有多个构建流程复用同一组步骤(比如“测试环境跳过认证,预发环境启用缓存,生产环境全开”),否则硬加 Director 只会让调用更啰嗦:先 new Director,再传 Builder,再调 Construct(),最后还要从 Director 拿结果。

  • 简单场景直接链式调用:new ApiClientBuilder().SetUrl("https://api.example.com").SetTimeout(5).SetRetry(3).Build()
  • Director 真正有价值的地方,是封装条件分支逻辑,且这些逻辑被三处以上共享。此时它应只依赖抽象 IBuilder,不感知具体类型
  • 如果构建步骤固定、组合极少,加 Director 反而增加维护成本和理解门槛

Fluent Builder 最容易崩在 null 引用,但错误堆栈不提示哪步出错

链式调用看着顺滑,但一旦某步初始化失败(比如 JSON 配置解析失败导致 _toppings 仍为 null),后续 AddTopping() 就会直接抛 NullReferenceException,堆栈里只显示在 AddTopping 行,根本看不出是上一步没初始化好。

  • 所有可空字段(如集合、嵌套 builder)必须在构造函数里初始化,别等第一次调用才 lazy 创建
  • 避免在 WithXxx() 中做重操作(如远程拉配置、IO 解析),这些应该前置或移到 Build() 里统一处理
  • 如果真需要中间校验,可用 TrySetXxx() + 返回布尔值替代,但会破坏链式结构——这时就得权衡可读性与健壮性

最常被忽略的点是:Builder 不是语法糖,它是控制对象生命周期和约束合法状态的边界。写得越“顺手”,越要警惕状态漂移和校验遗漏。

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

2023.08.08

528

5

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2023.08.31

1158

3

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

2024.03.13

556

8

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2024.03.14

1050

11

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

2026.02.03

148

18

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

2026.02.06

202

20

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

2026.03.11

526

24

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

2026.04.13

137

20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
RabbitMQ 教程手册
RabbitMQ 教程手册

共0课时 | 0人学习

Linux man-pages 项目
Linux man-pages 项目

共0课时 | 0人学习

C# 教程
C# 教程

共94课时 | 20.2万人学习