示例工程教程【免费下载链接】java-design-patternsDesign patterns implemented in Java项目地址https://gitcode.com/GitHub_Trending/ja/java-design-patterns点击查看免费下载导读本文以 java-design-patterns 仓库中的 fluent-interface 模块为依托深入讲解 Fluent Interface流式接口又称 Fluent API / 方法链设计模式。该模式通过连续链式调用方法将复杂的对象构建与集合操作组织成近似自然语言的可读代码。读完本文你将掌握 Fluent Interface 的接口设计要点、急切求值Eager与惰性求值Lazy两种实现策略的底层原理与取舍并能在自己的项目中亲手实现一个高可读性的流式 API。模式概述又名 Fluent API 与 Method ChainingFluent Interface 模式还有两个广为人知的别名Fluent API强调该 API 的流畅设计风格Method Chaining方法链强调其实现手段——让每个方法返回一个可继续调用下一方法的对象通常是this或新实例。其核心思想是让方法调用的返回值继续参与下一次调用从而把一系列分散的语句串联成一条可读的流水线。模式意图IntentFluent Interface 模式的首要目标是提供一个易于阅读、行云流水般的 API通过方法链method chaining的形式呈现。这一做法非常适合分步构建复杂对象并能显著提升开发者的使用体验——调用代码几乎可以像阅读人类语言一样被理解因此常被用来构造内部领域特定语言Internal DSL。现实世界示例像点咖啡一样配置对象想象你在咖啡店逐步定制自己的订单先要一杯大杯咖啡再加两份浓缩不要糖最后换燕麦奶。你没有一次性把所有要求塞给咖啡师而是按顺序、一步步地把每个定制点说清楚——这种顺序化、自然流畅地描述的方式正是 Fluent Interface 在 Java 代码中的工作方式。每个链式方法调用都对应一个定制步骤最终构建并配置出完整的对象。用一句最通俗的话概括Fluent Interface 模式为代码提供了易于阅读、自然流畅的接口。维基百科对它的定义是在软件工程中流式接口fluent interface是一种面向对象 API其设计高度依赖方法链method chaining目标是通过创建领域特定语言DSL来提高代码的可读性。时序视角链式调用的执行流程下图为该模式在本仓库中的时序图展示了App通过SimpleFluentIterable进行过滤、截取并收集结果的调用流程图片见 fluent-interface/etc/fluent-interface-sequence-diagram.png程序示例从整数列表中筛选数据本仓库的演示场景是需要按不同条件从列表中筛选数字。这非常适合用 Fluent Interface 提供可读、易用的开发体验。示例给出了FluentIterable接口的两种实现——SimpleFluentIterable与LazyFluentIterable。核心接口 FluentIterable接口定义见 fluent-interface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java。它继承自IterableE并补充了过滤、截取、映射、收集等操作设计上受 Guava 的com.google.common.collect.FluentIterable启发public interface FluentIterableE extends IterableE { FluentIterableE filter(Predicate? super E predicate); OptionalE first(); FluentIterableE first(int count); OptionalE last(); FluentIterableE last(int count); T FluentIterableT map(Function? super E, T function); ListE asList(); static E ListE copyToList(IterableE iterable) { var copy new ArrayListE(); iterable.forEach(copy::add); return copy; } }各方法语义如下方法语义是否为终止操作filter(predicate)用谓词过滤元素仅保留满足条件的项否返回新 FluentIterablefirst()返回首个元素Optional包装是first(int count)只保留前 count 个元素否last()返回最后一个元素Optional包装是last(int count)只保留后 count 个元素否map(function)将 E 类型转换为 T 类型否asList()收集为ListE是copyToList(iterable)静态工具方法把 Iterable 复制为 List—接口的 Javadoc 同时指出见 FluentIterable.java这个接口只定义了常用操作并不追求完备——这正是 Fluent API 设计中的克制原则只暴露对调用方最有价值的链式入口。急切求值实现SimpleFluentIterableSimpleFluentIterable对所有链式操作进行急切Eager求值即每一步都在调用时立刻完成整个集合的处理因此对于真实应用而言代价过高源码注释原文即注明 would be costly to be utilized in real applications见 SimpleFluentIterable.java。public class SimpleFluentIterableE implements FluentIterableE { // ... }关键实现细节见 SimpleFluentIterable.javafilter就地删除遍历迭代器凡是predicate.test(nextElement)为假便调用iterator.remove()然后返回this实现同一实例上的连续修改first(count)就地截断遍历时一旦当前计数达到 count后续元素一律remove()last(count)需先计数先通过getRemainingElementsCount()求出剩余元素总数再删除从头到总数-count之间的元素map产生新集合将变换结果暂存到ArrayList再用from(temporaryList)包装成新的 FluentIterableasList通过静态方法toList(iterator)把迭代器剩余元素收集为 List见 SimpleFluentIterable.java#L209-L213。此外它还提供了两个工厂方法见 SimpleFluentIterable.java#L167-L174from(iterable)直接包装原 IterablefromCopyOf(iterable)先copyToList复制一份再包装避免就地修改污染原始数据源——示例程序大量使用该入口正是出于这一安全考虑。惰性求值实现LazyFluentIterableLazyFluentIterable把求值推迟到终止操作发生时才执行见 LazyFluentIterable.java更加贴近真实生产环境对性能的要求。public class LazyFluentIterableE implements FluentIterableE { // ... }它与急切实现的核心区别在于每个链式方法不修改任何现有集合而是返回一个匿名子类该子类通过自定义迭代器描述如何从上游迭代器中产出元素filter返回匿名LazyFluentIterable其迭代器在computeNext()中持续从上游取元素、跳过不满足谓词的候选直到找到满足条件的元素才返回见 LazyFluentIterable.java#L61-L80first(count)迭代器内部维护currentIndex只放行前 count 个元素见 LazyFluentIterable.java#L101-L120last(count)注释明确提醒这是一个内存密集操作——首次请求元素时会先把整个上游内容收集进ArrayList才能算出停止索引见 LazyFluentIterable.java#L133-L178map迭代器持有旧类型的IteratorE逐个function.apply(candidate)产出 T 类型结果见 LazyFluentIterable.java#L188-L207。DecoratingIterator是整套惰性机制的骨架见 DecoratingIterator.java它装饰给定的上游迭代器通过抽象方法computeNext()让子类实现自定义取元素逻辑hasNext()预计算并缓存下一个元素并把null视为数据结束标志。需要特别留意的是它的注释明确说明不支持连续调用hasNext()见 DecoratingIterator.java#L29-L34这是使用该实现时的已知约束。演示程序与运行输出完整演示见 fluent-interface/src/main/java/com/iluwatar/fluentinterface/app/App.java。程序对一组整数列表执行过滤、截取、映射与收集public static void main(String[] args) { var integerList List.of(1, -61, 14, -22, 18, -87, 6, 64, -82, 26, -98, 97, 45, 23, 2, -68); prettyPrint(The initial list contains: , integerList); var firstFiveNegatives SimpleFluentIterable .fromCopyOf(integerList) .filter(negatives()) .first(3) .asList(); prettyPrint(The first three negative values are: , firstFiveNegatives); var lastTwoPositives SimpleFluentIterable .fromCopyOf(integerList) .filter(positives()) .last(2) .asList(); prettyPrint(The last two positive values are: , lastTwoPositives); SimpleFluentIterable .fromCopyOf(integerList) .filter(number - number % 2 0) .first() .ifPresent(evenNumber - LOGGER.info(The first even number is: {}, evenNumber)); var transformedList SimpleFluentIterable .fromCopyOf(integerList) .filter(negatives()) .map(transformToString()) .asList(); prettyPrint(A string-mapped list of negative numbers contains: , transformedList); var lastTwoOfFirstFourStringMapped LazyFluentIterable .from(integerList) .filter(positives()) .first(4) .last(2) .map(number - String[ number ]) .asList(); prettyPrint(The lazy list contains the last two of the first four positive numbers mapped to Strings: , lastTwoOfFirstFourStringMapped); LazyFluentIterable .from(integerList) .filter(negatives()) .first(2) .last() .ifPresent(number - LOGGER.info(Last amongst first two negatives: {}, number)); }其中negatives()、positives()、transformToString()分别是integer - integer 0、integer - integer 0、integer - String[ integer ]三个谓词/函数见 App.java#L96-L106。程序输出08:50:08.260 [main] INFO com.iluwatar.fluentinterface.app.App -- The initial list contains: 1, -61, 14, -22, 18, -87, 6, 64, -82, 26, -98, 97, 45, 23, 2, -68. 08:50:08.265 [main] INFO com.iluwatar.fluentinterface.app.App -- The first three negative values are: -61, -22, -87. 08:50:08.265 [main] INFO com.iluwatar.fluentinterface.app.App -- The last two positive values are: 23, 2. 08:50:08.266 [main] INFO com.iluwatar.fluentinterface.app.App -- The first even number is: 14 08:50:08.267 [main] INFO com.iluwatar.fluentinterface.app.App -- A string-mapped list of negative numbers contains: String[-61], String[-22], String[-87], String[-82], String[-98], String[-68]. 08:50:08.270 [main] INFO com.iluwatar.fluentinterface.app.App -- The lazy list contains the last two of the first four positive numbers mapped to Strings: String[18], String[6]. 08:50:08.270 [main] INFO com.iluwatar.fluentinterface.app.App -- Last amongst first two negatives: -22注意最后一个例子LazyFluentIterable.from(...).filter(negatives()).first(2).last()在惰性链上叠加了多次中间操作最终得到的前两个负数中的最后一个是-22——这正是惰性求值只在终止操作时逐层计算的直观体现。如何运行与测试该模块是 Maven 多模块项目java-design-patterns的子模块artifactId 为fluent-interface见 fluent-interface/pom.xml入口类为com.iluwatar.fluentinterface.app.App由 maven-assembly-plugin 在 manifest 中指定。可以在仓库根目录执行./mvnw -pl fluent-interface -am compile exec:java或按项目既有方式构建运行演示程序。测试方面SimpleFluentIterableTest与LazyFluentIterableTest共享同一套抽象基类 FluentIterableTest.java分别以fromCopyOf和from构造被测试对象见 SimpleFluentIterableTest.java 与 LazyFluentIterableTest.java。基类覆盖了first()/last()含空集合返回Optional.empty()、first(count)/last(count)含请求数量超出实际元素时返回全部、filter、map、forEach、spliterator等场景——同一套断言同时验证两种实现的行为一致性也印证了两者在 API 语义上的等价性与性能策略上的差异。何时使用 Fluent Interface 模式在以下场景中优先考虑使用 Fluent Interface设计被高频使用的 API且客户端代码的可读性至关重要需要分步构建复杂对象希望让代码更直观、更不易出错希望增强代码清晰度、减少样板代码尤其是在配置组装与对象构建场景中。Fluent Interface 在真实世界中的应用Fluent Interface 已是业界普遍采用的 API 风格典型的实践包括Java 8 Stream APIfilter/map/limit/collect的无缝链式组合Google Guava 的 FluentIterable本仓库FluentIterable接口正是受其启发JOOQ用流式语法构建类型安全的 SQLMockitowhen(...).thenReturn(...)的测试桩风格Java HamcrestassertThat(x, is(...))的断言链Apache Camel 等集成框架中的 Builder面向集成工作流的分步构建。收益与权衡收益显著提升代码可读性与可维护性——调用代码几乎可当作 DSL 阅读鼓励构建不可变对象因为多数方法返回新实例而非修改原对象减少临时变量上下文状态由链本身携带代码更紧凑。权衡对不熟悉该模式的开发者链式代码可能不够直观调试困难问题可能出在链上任意一环堆栈信息分散过度使用会导致结构复杂、难以维护的代码。与仓库内其他模式的关联Builder 模式常借助 Fluent Interface 实现分步构造对象。Builder 关注如何分步构建复杂对象而 Fluent Interface 强调的是方法链这一机制本身Chain of Responsibility 模式Fluent Interface 可被视为责任链的一种具体运用——链上的每个方法处理任务的一部分再把控制权交给链中的下一方法。参考资料与延伸阅读《Domain-Driven Design: Tackling Complexity in the Heart of Software》《Domain Specific Languages》《Effective Java》《Java Design Pattern Essentials》Martin Fowler 关于 Fluent Interface 的经典博客文章《FluentInterface》以上书籍与文章均为该模式的理论源头与深度延伸可与本仓库 fluent-interface 模块的源码实现对照学习从接口设计—急切/惰性实现—测试验证三个层面完整掌握 Fluent Interface 模式。赞分享示例工程教程【免费下载链接】java-design-patternsDesign patterns implemented in Java项目地址https://gitcode.com/GitHub_Trending/ja/java-design-patterns点击查看免费下载相关推荐java-design-patterns 项目中的 Arrange/Act/AssertAAA测试模式以 Java 单元测试结构化提升可读性与可维护性java design patterns 项目中的 Arrange/Act/AssertAAA测试模式以 Java 单元测试结构化提升可读性与可维护性 A示例工程教程java-design-patterns 分层架构模式实战指南用蛋糕烘焙示例构建可维护的企业级 Java 应用java design patterns 分层架构模式实战指南用蛋糕烘焙示例构建可维护的企业级 Java 应用 分层架构Layered Architectu示例工程教程java-design-patterns 项目中的 Combinator 模式用函数组合构建灵活可复用的 Java 查询组件java design patterns 项目中的 Combinator 模式用函数组合构建灵活可复用的 Java 查询组件 Combinator组合子模示例工程教程上一篇3分钟学会如何在浏览器中零服务器依赖将HTML转为Word文档下一篇如何快速掌握Diablo Edit2暗黑破坏神2存档修改终极指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考