java 接口如何设计

接口设计原则

接口设计需要遵循SOLID原则中的接口隔离原则（Interface Segregation Principle），即客户端不应被迫依赖其不使用的接口。设计时应保持简洁、职责单一。

明确接口职责

接口应当专注于单一功能或行为，避免定义过于宽泛的方法。例如，一个负责数据存储的接口不应包含数据转换的逻辑。

public interface DataStorage {
    void save(String data);
    String retrieve(String id);
}

使用默认方法增强扩展性

Java 8引入的默认方法可以在不破坏现有实现的情况下扩展接口功能。适合提供可选功能或通用实现。

public interface DataStorage {
    void save(String data);
    String retrieve(String id);

    default boolean isEncrypted() {
        return false;
    }
}

避免过度设计

优先设计小而精的接口，而非庞大复杂的接口。可以通过组合多个小接口来实现复杂功能，例如：

public interface Readable {
    String read();
}

public interface Writable {
    void write(String data);
}

public interface ReadWrite extends Readable, Writable {}

考虑泛型支持

对于需要处理多种数据类型的场景，使用泛型提高接口的灵活性和类型安全。

public interface Repository<T> {
    void save(T entity);
    T findById(String id);
}

命名规范

接口名称应使用形容词（描述能力）或名词（描述角色），遵循大驼峰命名法。常见前缀包括：

• 能力型：Runnable, Serializable
• 角色型：List, Repository

文档注释

为接口及其方法添加清晰的JavaDoc，说明契约行为、参数约束和返回值含义。例如：

/
 * 定义数据持久化的基本操作契约
 */
public interface DataStorage {
    /
     * @param data 非空字符串，长度不超过1024字符
     * @throws IllegalArgumentException 当数据不符合规范时抛出
     */
    void save(String data);
}

版本兼容性

通过@Deprecated和默认方法实现平滑升级。旧方法标记废弃后，提供默认方法转发到新逻辑：

public interface LegacyInterface {
    @Deprecated
    void oldMethod();

    default void newMethod() {
        oldMethod(); // 默认转发保持兼容
    }
}

异常设计

明确声明检查异常（checked exceptions），运行时异常（unchecked exceptions）应当谨慎使用。避免在接口中暴露实现细节相关的异常。

public interface FileOperations {
    void deleteFile(String path) throws IOException;
}