当前位置：首页 > news >正文

Fluent Interface 流畅接口

news 2026/5/11 23:59:58

Fluent Interface（流畅接口）：让代码说人话的设计艺术

📚 什么是Fluent Interface？

Fluent Interface 是一种面向对象的API设计风格，通过方法的链式调用让代码读起来像自然语言一样流畅。它不是具体的框架或技术，而是一种设计思想。

简单说：就是让你的代码从"命令式"变成"声明式"。

🎯 核心理念：让代码更易读

改造前（传统写法）：

Query query = new Query();
query.setSelect("*");
query.setFrom("users");
query.setWhere("age > 18");
query.setOrderBy("name");

改造后（Fluent Interface）：

Query query = new Query().select("*").from("users").where("age > 18").orderBy("name");

看！是不是更像在说一句话："查询，选择所有，从用户表，条件是年龄大于18，按名字排序"？

🔧 两种实现方式及完整实现示例

方式1：返回 `this`（修改自身）- 构建器模式

// SQL查询构建器完整实现
import java.util.ArrayList;
import java.util.List;public class SQLQuery {private String table;private List<String> selects = new ArrayList<>();private List<String> wheres = new ArrayList<>();private List<String> orderBys = new ArrayList<>();private Integer limit;private Integer offset;// 私有构造器private SQLQuery() {}// 创建查询的入口点public static SQLQuery create() {return new SQLQuery();}// FROM 子句public SQLQuery from(String table) {this.table = table;return this;  // ← 返回this实现链式调用}// SELECT 子句public SQLQuery select(String... columns) {for (String column : columns) {this.selects.add(column);}return this;}// WHERE 子句public SQLQuery where(String condition) {this.wheres.add(condition);return this;}// AND 条件public SQLQuery and(String condition) {if (!wheres.isEmpty()) {this.wheres.add("AND " + condition);}return this;}// OR 条件public SQLQuery or(String condition) {if (!wheres.isEmpty()) {this.wheres.add("OR " + condition);}return this;}// ORDER BY 子句public SQLQuery orderBy(String column) {this.orderBys.add(column);return this;}// 降序排序public SQLQuery orderByDesc(String column) {this.orderBys.add(column + " DESC");return this;}// LIMIT 子句public SQLQuery limit(int limit) {this.limit = limit;return this;}// OFFSET 子句public SQLQuery offset(int offset) {this.offset = offset;return this;}// 分组条件public SQLQuery groupBy(String... columns) {// 实现略...return this;}// 构建SQL字符串public String build() {if (table == null) {throw new IllegalStateException("必须指定FROM子句");}StringBuilder sql = new StringBuilder();// SELECT子句if (selects.isEmpty()) {sql.append("SELECT *");} else {sql.append("SELECT ").append(String.join(", ", selects));}// FROM子句sql.append(" FROM ").append(table);// WHERE子句if (!wheres.isEmpty()) {sql.append(" WHERE ");// 第一个条件不加AND/OR前缀sql.append(wheres.get(0));// 后续条件已有前缀for (int i = 1; i < wheres.size(); i++) {sql.append(" ").append(wheres.get(i));}}// ORDER BY子句if (!orderBys.isEmpty()) {sql.append(" ORDER BY ").append(String.join(", ", orderBys));}// LIMIT子句if (limit != null) {sql.append(" LIMIT ").append(limit);}// OFFSET子句if (offset != null) {sql.append(" OFFSET ").append(offset);}return sql.toString();}
}// 使用示例
public class SQLExample {public static void main(String[] args) {// 构建复杂的SQL查询String sql = SQLQuery.create().from("users").select("id", "name", "email", "age").where("age >= 18").and("status = 'ACTIVE'").or("is_vip = true").orderBy("created_at").orderByDesc("last_login").limit(20).offset(10).build();System.out.println("生成的SQL:");System.out.println(sql);// 输出结果:// SELECT id, name, email, age // FROM users // WHERE age >= 18 AND status = 'ACTIVE' OR is_vip = true // ORDER BY created_at, last_login DESC // LIMIT 20 OFFSET 10}
}

方式2：返回 `new 对象`（不可变）- 值对象

// 金额计算完整实现
import java.math.BigDecimal;
import java.math.RoundingMode;
import java.util.Currency;public class Money {private final BigDecimal amount;private final Currency currency;// 私有构造器private Money(BigDecimal amount, Currency currency) {this.amount = amount.setScale(currency.getDefaultFractionDigits(), RoundingMode.HALF_EVEN);this.currency = currency;}// 工厂方法public static Money of(BigDecimal amount, Currency currency) {return new Money(amount, currency);}// 加法 - 返回新对象public Money add(Money other) {checkSameCurrency(other);return new Money(  // ← 返回新对象this.amount.add(other.amount),this.currency);}// 乘法 - 返回新对象public Money multiply(BigDecimal factor) {return new Money(this.amount.multiply(factor),this.currency);}// 减法 - 返回新对象public Money subtract(Money other) {checkSameCurrency(other);return new Money(this.amount.subtract(other.amount),this.currency);}// 百分比计算 - 返回新对象public Money percentage(BigDecimal percent) {return multiply(percent.divide(BigDecimal.valueOf(100)));}private void checkSameCurrency(Money other) {if (!this.currency.equals(other.currency)) {throw new IllegalArgumentException("币种不匹配");}}@Overridepublic String toString() {return String.format("%s %.2f", currency.getSymbol(), amount);}
}// 使用示例
public class MoneyExample {public static void main(String[] args) {Currency usd = Currency.getInstance("USD");Money salary = Money.of(new BigDecimal("5000"), usd);Money bonus = Money.of(new BigDecimal("1000"), usd);// 链式计算Money total = salary.add(bonus)                     // 新对象: $6000.multiply(new BigDecimal("1.1")) // 新对象: $6600.percentage(new BigDecimal("15")); // 新对象: $990 (6600的15%)System.out.println("月薪: " + salary);     // $5000.00System.out.println("奖金: " + bonus);      // $1000.00System.out.println("总收入: " + total);    // $990.00// 验证原对象不变System.out.println("月薪仍为: " + salary); // 仍为 $5000.00}
}

📊 两种实现方式对比

特性	返回 `this`（可变）	返回 `new 对象`（不可变）
内存使用	只创建一个对象	每个操作创建新对象
性能	高（无对象创建）	相对较低
线程安全	不安全	安全
调试难度	状态变化难追踪	对象状态清晰
典型应用	Builder模式、配置	值对象、数学计算
关键代码	`return this;`	`return new Class(...);`

🏆 何时使用哪种？

选择返回 `this` 的情况：

构建复杂对象：Builder模式（如SQL查询构建器）
配置对象：一次构建，多次使用
性能敏感场景：避免对象创建开销
中间状态不重要：只关心最终结果

选择返回 `new 对象` 的情况：

值对象：金额、坐标、日期等
数学/物理运算：向量、矩阵运算
需要线程安全：多线程环境
函数式编程：符合无副作用原则

🚀 更多实际应用示例

1. HTTP客户端配置

HttpClient client = new HttpClient().url("https://api.example.com").timeout(5000).retry(3).header("Content-Type", "application/json").header("Authorization", "Bearer token");

2. 测试断言框架

assertThat(user).hasName("张三").isAdult().hasValidEmail().isActive().hasRole("ADMIN");

3. 文件处理流水线

FileProcessor.process("input.txt").readLines().filter(line -> !line.startsWith("#")).map(String::trim).writeTo("output.txt").compress().uploadTo("s3://bucket/output.zip");