Java数组的length属性非API接口部分，但影响参数校验、DTO设计等；应避免暴露length为业务字段，优先用List替代数组，仅在必要时用length做O(1)边界检查。
Java 数组的 length 属性本身不是 API 接口的一部分，但它在设计和实现 API 时会直接影响参数校验、DTO 结构、序列化行为与调用方契约。关键在于：不暴露数组长度作为业务语义字段，也不依赖它做动态逻辑判断；而是用它支撑健壮、清晰、可维护的接口边界。
避免把 length 当作业务参数暴露
API 的请求体（如 JSON）中不应包含 “arrayLength” 这类冗余字段。数组长度由客户端提交的实际元素数量自然决定，服务端通过 arr.length 获取即可，无需额外约定或校验该值是否与元素数一致——这既增加传输开销，又引入不一致风险。
- ❌ 错误示例（REST 请求体）：
{"items": [1,2,3], "arrayLength": 3} - ✅ 正确做法：只传
{"items": [1,2,3]}，服务端用items.length得到 3 - 若需限制大小（如最多 100 条），应在参数校验层检查
items.length <= 100，而非让调用方提供 length 字段
在 DTO 中慎用数组，优先封装为集合或自定义对象
面向 API 的数据传输对象（DTO）中，直接使用数组（如 String[] tags）虽简洁，但缺乏扩展性与语义表达力。一旦后续需支持元信息（如每个 tag 的权重、来源、过期时间），数组就无法承载。
- 推荐用
List<TagDto>替代TagDto[]，即使当前仅需名称字段，也预留演进空间 - 若必须用数组（如高性能场景或兼容旧协议），确保其长度语义明确：是“必填项数量”还是“可选上限”？并在 Javadoc 中说明
- 注意：JSON 反序列化时，
String[]和List<String>行为不同，Jackson 默认都支持，但 null 处理策略需统一（如空数组 vs null）
利用 length 做轻量级边界校验，但不替代业务规则
length 是 O(1) 的高效属性，适合用于快速防御性检查，但不能替代领域级验证。
立即学习“Java免费学习笔记（深入）”；
- ✅ 合理使用：
if (ids == null || ids.length == 0) throw new IllegalArgumentException("ID list cannot be empty"); - ⚠️ 避免滥用：
if (data.length > 1000) { /* 粗暴截断 */ }—— 应抛出明确错误，由调用方重试或分页 - 多维数组要小心：
matrix.length只反映行数，matrix[0].length才是列数，且需先判空，否则 NPE
与集合 API 保持语义隔离，不混用 length 和 size()
在同一个接口中，不要对不同数据结构使用相似但含义不同的属性。这会造成调用方认知混淆和 SDK 封装困难。
- 数组用
.length，集合用.size()，这是 Java 的硬性区分，API 文档和示例代码必须严格体现 - DTO 字段命名应体现类型意图：用
userNames（List）而非userNameArray；若真用数组，字段名可加后缀如rolesArray，但更建议统一为集合 - 内部实现可转换（如将 List 转为数组调用底层 API），但对外契约应稳定：输入用 List，输出也尽量用 List，除非性能敏感且明确要求数组
