Java中基本类型复用靠包装类+封装设计：支持泛型集合、DTO语义化、校验逻辑集中、工具方法抽象，而非简单装箱；需规避自动装箱引发的空指针与性能问题。
Java 中基本类型与包装类本身不是靠“封装”来提高复用的，而是通过合理使用包装类 + 封装设计原则，让涉及基本类型的代码更安全、更通用、更易被多处调用。关键不在于把 int “封装成 Integer”就自动复用了，而在于怎么组织逻辑、暴露接口、避免硬编码和重复校验。
用包装类替代基本类型，为泛型和集合铺路
基本类型不能直接放进 ArrayList、HashMap 等集合，也不能作为泛型参数（如 List<int></int> 语法非法）。必须用包装类才能写 List<integer></integer> 或 Map<string boolean></string>。这是复用的前提——一旦数据能统一进集合或工具方法，就能批量处理。
- 例如：写一个通用的“数值列表求和”工具方法，只能接收
List<number></number>，里面可放Integer、Double、BigDecimal，但绝不能是int[]或裸int - 再如：DTO 类中用
Integer age而非int age，既支持 JSON 反序列化时字段缺失为 null，也方便后续扩展（比如年龄可能未提供，用 null 表达比默认 0 更语义清晰）
在业务类中封装基本类型字段，配合校验逻辑
单纯把 int age 改成 private Integer age 不算有效封装。真正提升复用的是：把字段私有化 + 提供带约束的 setter + 统一的数据访问入口。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 把年龄校验（如 0–150）写死在每个新增用户的地方？不如封装进
setAge(Integer age)方法里，一处修改，全局生效 - 对布尔字段如
private Boolean isActive，可封装activate()和deactivate()方法，隐藏赋值细节，避免外部误设为 null 或 false 导致状态歧义 - 这种封装让同一个实体类（如
User）能在 Web 层、Service 层、测试 Mock 中反复使用，而不必到处复制校验代码
抽离共性操作，做成静态工具方法
包装类自带一些实用方法（如 Integer.parseInt()、Boolean.valueOf()），但更进一步的复用来自你写的工具类——它们把基本类型相关的转换、判空、默认值逻辑集中管理。
立即学习“Java免费学习笔记（深入）”；
- 例如：
NumberUtils.safeInt(Integer i, int defaultValue)：当传入 null 时返回默认值，避免每次调用都写三元判断 - 又如：
StringUtils.toBoolean(String s)：统一处理 "true"/"1"/"yes" 等多种真值字符串，比零散写"1".equals(s)更可靠、更易复用 - 这些方法不依赖具体业务对象，可在任意模块引入使用，天然具备高复用性
慎用自动装箱拆箱，避免隐蔽性能与空指针
看似方便的 int i = new Integer(10); 或 list.add(123);（自动装箱）会掩盖问题。若包装类变量为 null，拆箱时直接抛 NullPointerException，反而降低代码健壮性，影响复用稳定性。
- 对外接口尽量明确接收包装类（如
void processId(Integer id)），并在方法开头做 null 判断或抛有意义异常，而不是等拆箱时报错 - 循环中避免高频装箱（如
for (int i = 0; i ），改用原始类型集合库（如 Eclipse Collections）或预分配，否则复用该逻辑时性能骤降 - 复用性不只是“能抄代码”，更是“抄过去还能稳跑”。规避空指针和装箱开销，就是保障复用不踩坑
