深入解析 Factory Kit 工厂套件模式：基于 java-design-patterns 的可配置对象工厂实现指南

示例工程教程【免费下载链接】java-design-patternsDesign patterns implemented in Java项目地址https://gitcode.com/GitHub_Trending/ja/java-design-patterns点击查看免费下载工厂套件Factory Kit是一种创建型设计模式它通过分离的构建器Builder与工厂Factory接口来定义一个内容不可变的工厂从而解决工厂无法预知所需创建对象类别的问题。本指南以开源仓库 java-design-patterns 中的 factory-kit 模块 为实例结合源码与测试完整讲解该模式的定义、适用场景、核心实现与实战用法帮助你掌握如何用一行配置式代码注册并创建任意对象类型的可扩展工厂方案。模式含义什么是 Factory Kit根据本仓库的官方定义Factory Kit 的核心含义是使用分离的构建器和工厂接口来定义一个不可变内容的工厂。换句话说它提供了一个可配置的对象构建器或者说一个用来创建工厂的工厂。在英文版文档中该模式还有两个别名Object Kit对象套件Toolkit工具包从仓库源码的类注释App.java可以进一步确认其定义Factory Kit 是一种创建型模式通过分离的构建器接口和工厂接口定义一个内容不可变的工厂以解决在工厂套件实例中直接指定创建某个对象的问题。现实世界的类比英文版文档给出了一个非常直观的类比餐厅厨房。厨房中央有一个登记了各类食材与配方的中心站台当订单到来时厨师只需查阅中心站台按已登记的配方准备菜肴即可。这种方式让厨房能够高效地在不同菜品之间切换而每个厨师无需记住每道菜的配方细节——既灵活又一致。映射到代码层面中心站台就是 Factory Kit 的注册表每道菜谱就是注册的Supplier厨师就是调用create的客户端。与普通工厂的区别与传统的简单工厂/抽象工厂相比Factory Kit 的关键差异在于工厂能创建的对象类型不是在类内部硬编码的而是在实例化时通过配置从外部注入每个工厂实例是局部、独立的可以严格定义它能创建的对象类型集合而不是使用全局唯一的构建器构建器Builder接口与创建器Creator/Factory接口完全分离。这一点在 WeaponFactory.java 的 Javadoc 中表述得很清楚局部创建的实例有机会严格定义该工厂实例将能够创建哪些对象类型工厂是Builder的占位符通过create(WeaponType)方法初始化新对象。类图与结构总览Factory Kit 类图Factory Kit 时序图从仓库自带的 UML 图factory-kit.urm.puml与源码结构来看本模块的核心参与者包括角色类/接口职责产品抽象Weapon所有可创建对象的统一接口产品类型枚举WeaponType枚举可创建的对象类型SWORD / AXE / BOW / SPEAR具体产品Sword/Axe/Bow/Spear实现Weapon的具体类构建器接口Builder提供add(name, supplier)向工厂注册构建方式工厂接口WeaponFactory提供factory(consumer)配置工厂与create(name)创建对象适用场景中文版文档明确指出工厂套件模式适用于以下场景一个类无法预知它需要创建的对象的类别——对象类型在运行期或配置期才能确定你只是想要一个新的自定义构建器Builder的实例而非全局的构建器——每个实例可拥有独立的对象类型集合你明确地想要定义对象的类型而且工厂可以创建这些对象——创建能力需要在类外部显式声明你想要分离构建器Builder和创建器Creator接口——让注册构建逻辑与创建对象解耦。英文版文档在此基础上补充了更精确的使用时机工厂类无法预先知道它必须创建的对象类型且需要一个自定义构建器的新实例需要的是自定义构建器的新实例而不是全局构建器工厂能够构建的对象类型需要在类外部定义需要分离构建器与创建器接口游戏开发及其他包含用户自定义功能的应用这是 Factory Kit 最典型的落地场景——用户自定义装备、角色、插件等。值得注意的是中文文档特别强调内容不可变这一特性工厂在配置阶段factory方法执行时完成全部注册配置完成后其内部注册表不再改变因此创建行为是可预测、线程可复用的。编程示例魔法武器工厂实战下面我们完整还原英文版文档与仓库源码中的魔法武器工厂示例。整个示例位于com.iluwatar.factorykit包下共 9 个源码文件。第一步定义产品层次public interface Weapon { } public enum WeaponType { SWORD, AXE, BOW, SPEAR } public class Sword implements Weapon { Override public String toString() { return Sword; } } // Axe、Bow、Spear 的定义方式与 Sword 完全相同对应源码见 Weapon.java、WeaponType.java 与 Sword.java。其中Weapon是一个空的标记接口WeaponType枚举充当创建键——它既用于注册也用于create时按名查找。第二步定义构建器接口Builder是一个函数式接口允许向工厂注册某个类型名对应的对象供应器public interface Builder { void add(WeaponType name, SupplierWeapon supplier); }对应源码见 Builder.java。这里的SupplierWeapon就是延迟构造的配方它只在真正调用create时才被求值。第三步核心——WeaponFactory 工厂接口WeaponFactory是整个模式的肉meat of the example它同时具备配置工厂与创建对象两种能力public interface WeaponFactory { static WeaponFactory factory(ConsumerBuilder consumer) { var map new HashMapWeaponType, SupplierWeapon(); consumer.accept(map::put); return name - map.get(name).get(); } Weapon create(WeaponType name); }对应源码见 WeaponFactory.java。让我们拆解这三行代码背后的原理var map new HashMapWeaponType, SupplierWeapon()创建一个局部的注册表这是内容不可变工厂的存储基础consumer.accept(map::put)关键技巧在于map::put方法引用被当作Builder接口的实现——Builder.add(name, supplier)与HashMap.put(key, value)的签名完全兼容因此无需任何额外实现类ConsumerBuilder配置回调直接完成注册return name - map.get(name).get()返回的 Lambda 直接实现了create方法——按WeaponType从注册表取出对应的Supplier再调用get()实例化对象。这种工厂即 Lambda的设计正是 Remi Forax 在《Design Pattern Reloaded》演讲中演示的函数式工厂套件风格也是本仓库实现与经典面向对象版本的最大区别。第四步配置并使用工厂在 App.java 的main方法中演示了完整的配置与调用流程public static void main(String[] args) { var factory WeaponFactory.factory( builder - { builder.add(WeaponType.SWORD, Sword::new); builder.add(WeaponType.AXE, Axe::new); builder.add(WeaponType.SPEAR, Spear::new); builder.add(WeaponType.BOW, Bow::new); }); var list new ArrayListWeapon(); list.add(factory.create(WeaponType.AXE)); list.add(factory.create(WeaponType.SPEAR)); list.add(factory.create(WeaponType.SWORD)); list.add(factory.create(WeaponType.BOW)); list.forEach(weapon - LOGGER.info({}, weapon.toString())); }注意配置阶段的顺序无关性注册时顺序SWORD、AXE、SPEAR、BOW与创建时顺序AXE、SPEAR、SWORD、BOW可以不同因为create是基于HashMap按键查找的。运行输出使用 Maven 运行com.iluwatar.factorykit.App模块 pom.xml 已通过maven-assembly-plugin将主类配置为com.iluwatar.factorykit.App控制台输出如下06:32:23.026 [main] INFO com.iluwatar.factorykit.App -- Axe 06:32:23.029 [main] INFO com.iluwatar.factorykit.App -- Spear 06:32:23.029 [main] INFO com.iluwatar.factorykit.App -- Sword 06:32:23.029 [main] INFO com.iluwatar.factorykit.App -- Bow输出结果证明尽管注册与创建顺序不同每种武器都被正确实例化并打印出对应类型名。源码结构解析factory-kit 模块的完整源码结构如下factory-kit/src/main/java/com/iluwatar/factorykit/ ├── App.java # 程序入口演示配置与使用 ├── Axe.java # 具体产品斧 ├── Bow.java # 具体产品弓 ├── Builder.java # 构建器函数式接口 ├── Spear.java # 具体产品矛 ├── Sword.java # 具体产品剑 ├── Weapon.java # 产品抽象接口 ├── WeaponFactory.java # 工厂接口核心 └── WeaponType.java # 产品类型枚举从源码结构可以看出该实现把模式涉及的每个角色都独立成类/接口文件保持了构建器与创建器分离的清晰边界。测试验证模式行为可验证仓库提供了两层测试来验证模式正确性1. 功能层测试 FactoryKitTest.java该测试在BeforeEach中配置了一个只注册 SPEAR、AXE、SWORD 三种武器的工厂注意刻意不注册 BOW随后分别断言create返回的对象类型testSpearWeapon断言factory.create(WeaponType.SPEAR)是Spear的实例testAxeWeapon断言factory.create(WeaponType.AXE)是Axe的实例testWeapon断言factory.create(WeaponType.SWORD)是Sword的实例。公共的verifyWeapon方法使用clazz.isInstance(weapon)做类型校验。这个测试同时验证了一个隐含行为工厂只包含注册过的类型——未注册的 BOW 在调用create(WeaponType.BOW)时会因map.get返回null而抛出NullPointerException这正是内容不可变、类型集合由配置严格限定的体现。2. 应用层测试 AppTest.java该测试调用App.main(new String[] {})断言整个示例程序在无异常的情况下执行完毕验证了完整配置 → 创建 → 打印链路可运行。优点与权衡优点Benefits松散耦合消除了在业务代码中直接绑定具体类的需要对象创建逻辑被集中到工厂套件内部代码简化将实例化职责转移到工厂对象客户端只需按名取物按需扩展新增一种产品只需实现产品接口 在配置回调中加一行builder.add(...)无需修改工厂核心逻辑实例隔离每个工厂实例是独立的不同模块可以拥有各自的对象类型集合避免全局构建器带来的耦合。权衡Trade-offs引入额外复杂度需要新增 Builder、Factory 等接口与类对简单场景可能过度设计依赖管理风险若注册的Supplier引用了不正确的依赖或类型键与产品不匹配可能产生运行期错误如上述未注册类型导致的NullPointerException且这种错误无法在编译期捕获。与其他创建型模式的关系Factory Kit 与仓库中其他创建型模式可以组合使用抽象工厂Factory Kit 常与抽象工厂配合用来创建一族相关的对象——抽象工厂决定族Factory Kit 负责族内各对象类型的灵活注册建造者Builder两者思路相近Builder 模式用于分步构造复杂对象Factory Kit 则侧重于工厂的工厂——把构建逻辑注册化原型Prototype通过克隆原型实例创建对象时通常也需要一个工厂来管理原型的注册与分发Factory Kit 的注册表机制正好胜任。总结Factory Kit 是创建型模式中的配置化方案它以局部注册表 函数式接口为核心将工厂能创建什么从类内硬编码中解放出来交给调用方在实例化时通过一行行builder.add(...)灵活声明。在 java-design-patterns 仓库的 factory-kit 模块 中你可以通过 WeaponFactory.java 体会三行代码实现可配置工厂的优雅并通过 FactoryKitTest.java 验证其行为约束。对于游戏开发中大量用户自定义对象、插件系统、动态装备合成等场景Factory Kit 是值得优先考虑的实现方案。赞分享示例工程教程【免费下载链接】java-design-patternsDesign patterns implemented in Java项目地址https://gitcode.com/GitHub_Trending/ja/java-design-patterns点击查看免费下载相关推荐Factory Kit 工厂套件模式实战解析用 java-design-patterns 仓库打造可配置的对象工厂Factory Kit 工厂套件模式实战解析用 java design patterns 仓库打造可配置的对象工厂 Factory Kit工厂套件是一种创示例工程教程Java 设计模式之 Factory Kit工厂套件模式可配置对象构造器实战解析Java 设计模式之 Factory Kit工厂套件模式可配置对象构造器实战解析 Factory Kit 是 java design patterns 仓示例工程教程java-design-patterns 抽象工厂模式Abstract Factory深度实战指南以王国工厂为例掌握工厂的工厂java design patterns 抽象工厂模式Abstract Factory深度实战指南以王国工厂为例掌握工厂的工厂 抽象工厂Abstra示例工程教程上一篇生成式 AI 应用安全加固实战指南基于 generative-ai-for-beginners 的安全开发规范下一篇PostgREST Schema 隔离实践用私有 Schema 与视图函数构建安全稳定的 REST API创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考