Java中设计简洁函数输入结构的核心是恰到好处的封装：用不可变参数类、record、枚举和业务语义值对象替代长参数列表、Map或原始类型，分离必要与可选参数，提升可读性、类型安全与扩展性。
Java中设计简洁的函数输入结构，核心是减少参数数量、提升可读性、避免歧义，同时兼顾扩展性和类型安全。不靠重载堆砌，也不用万能Map硬扛——关键在“恰到好处的封装”。
用专用参数对象替代长参数列表
当函数需要3个以上相关参数（比如用户ID、姓名、邮箱、状态、创建时间），直接列在方法签名里既难读又易错位。此时应提取为不可变的参数类：
- 类名明确职责，如 UserRegistrationRequest
- 字段全用 final，构造器一次性赋值（推荐使用Builder或Lombok @Builder）
- 避免暴露 setter，防止中途篡改；必要时提供 withXxx() 返回新实例
- 重写 toString() 和 equals/hashCode（Lombok可自动生成）
善用枚举和记录类（Record）简化基础输入
Java 14+ 的 record 天然适合表达“数据载体”，语法极简且自带不可变、结构化语义：
- SearchQuery record String keyword, int page, int size, SortOrder order;
- 比普通 class 少写几十行模板代码，又比 Map
更类型安全、IDE友好 - 搭配枚举（如 SortOrder.ASC / DESC）替代 magic string 或 int，编译期防错
按场景分层：必要参数 + 可选配置分离
并非所有输入都同等重要。把“必须传”和“偶尔调”分开，能显著降低调用门槛：
立即学习“Java免费学习笔记（深入）”；
- 主方法只接收核心参数（如 id、content），返回 Builder 实例
- 通过链式调用设置可选字段：sendEmail(to).subject("Hi").priority(HIGH).send();
- 或用重载提供最简版本，再逐级增加可选参数对象（避免布尔标志位爆炸）
拒绝原始类型泛滥，封装业务语义
别让函数签名叫 process(String, String, int, boolean)。它到底在处理什么？
- 用 OrderId、Amount、PhoneNumber 等小值对象包装原始类型
- 它们可内置校验（如手机号格式）、转换逻辑（如金额单位统一为分）、甚至行为（amount.add(another)）
- 调用方一眼看懂意图，IDE 能精准跳转，重构时也更安全
基本上就这些——不复杂但容易忽略。简洁不是删减，而是把隐含规则显性化、把散落信息结构化、把变化点隔离出来。函数输入干净了，整条调用链才真正可控。
