通用接口：
- 适用于多种场景
- 灵活但复杂
- 例：Java 的 Collections.sort(list, comparator)

专用接口：
- 适用于特定场景
- 简单但局限
- 例：sortByName(list), sortByAge(list)

选择原则：
- 如果有明确的多种使用场景 → 通用
- 如果只有一种使用场景 → 专用
- 如果不确定 → 先专用，需要时再通用化

原则1：接口应该易于做正确的事

// 不好的设计：容易出错
public void transfer(String from, String to, int amount) {
    // 参数顺序容易搞混
}

// 好的设计：难以出错
public void transfer(Account from, Account to, Money amount) {
    // 类型系统防止错误
}

原则2：接口应该隐藏实现细节

// 不好的设计：暴露实现
public void save(User user, boolean useCache, int retryCount) {
    // 用户需要知道缓存和重试策略
}

// 好的设计：隐藏细节
public void save(User user) {
    // 内部决定缓存和重试策略
}

原则3：接口应该完整

// 不好的设计：不完整
public class HttpClient {
    public Response get(String url) { ... }
    // 没有 post, put, delete...
}

// 好的设计：完整
public class HttpClient {
    public Response get(String url) { ... }
    public Response post(String url, Body body) { ... }
    public Response put(String url, Body body) { ... }
    public Response delete(String url) { ... }
}

配置参数过多的问题：

public class Server(
    host: String,
    port: Int,
    maxConnections: Int,
    timeout: Int,
    retryCount: Int,
    enableCache: Boolean,
    cacheSize: Int,
    logLevel: String,
    // ... 20 个参数
)

问题：
1. 认知负荷：用户需要理解每个参数
2. 错误配置：参数组合可能产生意外行为
3. 测试困难：参数组合爆炸

解决方案：
1. 提供合理的默认值
2. 使用 Builder 模式
3. 将相关参数分组
4. 只暴露必要的参数

// 好的设计
public class Server {
    private Server(Builder builder) { ... }
    
    public static Builder builder() {
        return new Builder()
            .host("localhost")      // 合理默认值
            .port(8080)
            .maxConnections(100);
    }
}

"somewhat general" 的设计：
- 不是完全通用
- 不是完全专用
- 覆盖当前需求和可预见的未来需求

例：排序方法
// 太专用
sortByName(List<User> users)

// 太通用（过度设计）
sort(List<T> items, Comparator<T> comparator, SortOrder order, boolean stable)

// Somewhat general（恰到好处）
sort(List<T> items, Comparator<T> comparator)
// 覆盖了大多数排序需求
// 接口简单
// 可以扩展（stable sort 等）

// 太专用
public class Logger {
    public void logInfo(String message) { ... }
    public void logError(String message) { ... }
    public void logDebug(String message) { ... }
    // 每种级别一个方法
}

// 太通用
public class Logger {
    public void log(Level level, String format, Object... args) {
        // 太多灵活性
    }
}

// Somewhat general
public class Logger {
    public void info(String message) { ... }
    public void error(String message, Throwable t) { ... }
    public void debug(String message) { ... }
    // 简单、完整、覆盖常用场景
}