Java中设计可复用类的核心是降低耦合、提高内聚、遵循开放封闭原则，优先用接口抽象、组合、泛型和不可变性，避免滥用继承，确保职责明确、类型安全且易于维护。
Java中设计可复用的类，核心在于降低耦合、提高内聚、遵循开放封闭原则，并通过组合、泛型、接口抽象和不变性等手段增强适应性。不是写得越“通用”越好，而是让类在明确职责的前提下，能自然适配多种使用场景。
用接口定义契约，而非继承实现
复用的基础是抽象，但滥用继承（尤其是类继承）会快速导致僵化。优先定义清晰的接口，把行为契约和实现分离。
- 例如：不直接写 FileProcessor 类，而是先定义 DataProcessor
接口，含 process(T input) 方法 - 不同数据源（文件、网络流、内存列表）各自实现该接口，调用方只依赖接口，无需关心具体类型
- 避免为“未来可能的需求”提前继承一个抽象基类；等两个以上子类出现共性逻辑时，再提取模板方法或默认实现
优先组合，谨慎继承
当需要复用已有功能时，把对象作为成员变量引入，比继承更灵活、更安全。
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- 比如要扩展 Logger 功能（加时间戳、过滤级别、输出到多个目标），不要继承 ConsoleLogger，而是封装它：class TimestampLogger implements Logger { private final Logger delegate; ... }
- 组合支持运行时替换（如通过构造函数传入不同 delegate），继承则在编译期绑定，难以切换
- 只有当子类确实是父类的“一种”（is-a 关系），且语义稳定（如 ArrayList 是 List），才考虑继承
善用泛型与类型参数化
泛型不是为了省写几个 Object 强转，而是让类在保持类型安全的同时，覆盖更广的数据形态。
立即学习“Java免费学习笔记（深入）”；
- 工具类如 Result
、Pair 、Retryer ，天然适合复用——一次编写，任意类型可用 - 避免泛型过度嵌套（如 Function
>>, CompletableFuture extends Serializable>> ），牺牲可读性换来的“通用”往往没人敢用 - 必要时提供静态工厂方法（如 Results.success(data)）简化泛型推断，降低使用者负担
封装可变状态，暴露不可变API
可复用的类应尽量减少外部对其内部状态的依赖和干扰。状态越稳定，越容易被多处共享和测试。
- 字段设为 private final，构造时初始化；需要修改时返回新实例（如 BigDecimal、LocalDateTime 的设计思路）
- 若必须支持配置，用构建器模式（Builder）集中初始化，而不是提供一堆 setXxx() 方法破坏一致性
- 返回集合时，用 Collections.unmodifiableList() 包装，防止调用方意外修改内部数据
