java 原生 arraylist 不支持强制限制容量上限；new arraylist(3) 仅设置初始容量，不阻止后续添加元素。要实现真正固定大小（如最多 3 个元素），需借助不可变包装、自定义封装类或 apache commons collections 的 fixedsizelist。
java 原生 arraylist 不支持强制限制容量上限；new arraylist(3) 仅设置初始容量，不阻止后续添加元素。要实现真正固定大小（如最多 3 个元素），需借助不可变包装、自定义封装类或 apache commons collections 的 fixedsizelist。
ArrayList<Integer> list = new ArrayList<>(3); 这行代码常被误解为“创建一个最多容纳 3 个元素的列表”，但实际上它只是预分配内部数组空间为 3，后续调用 add() 仍可无限扩容（例如添加第 4 个元素时自动扩容为 10）。ensureCapacity(3) 和 trimToSize() 同样无效：前者仅确保最小容量，后者仅收缩至当前 size，均无法拦截超出容量的插入操作。
✅ 正确实现固定容量的三种方式
1. 使用 Apache Commons Collections（推荐）
引入依赖（Maven）：
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-collections4</artifactId>
<version>4.4</version>
</dependency>创建固定大小为 3 的列表：
import org.apache.commons.collections4.list.FixedSizeList; import java.util.*; List<Integer> fixedList = FixedSizeList.fixedSizeList(new ArrayList<>(Collections.nCopies(3, null))); // 或更安全地：先初始化含 3 个默认值的列表 List<Integer> base = new ArrayList<>(Arrays.asList(0, 0, 0)); List<Integer> fixed = FixedSizeList.fixedSizeList(base); fixed.set(0, 10); // ✅ 允许 set（替换） fixed.set(2, 30); // fixed.add(40); // ❌ UnsupportedOperationException // fixed.remove(0); // ❌ UnsupportedOperationException
⚠️ 注意：FixedSizeList 不允许 add/remove，仅支持 set(index, value) —— 它本质是“固定长度的可写数组式列表”，适用于预分配结构且仅需更新值的场景。
deep-java-review下载Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
立即学习“Java免费学习笔记（深入）”；
2. 自定义封装类（完全可控）
若需支持 add() 但拒绝超限，可封装逻辑：
public class BoundedArrayList<T> extends ArrayList<T> {
private final int maxSize;
public BoundedArrayList(int maxSize) {
this.maxSize = maxSize;
}
@Override
public boolean add(T e) {
if (size() >= maxSize) {
throw new IllegalStateException("Cannot add element: maximum size " + maxSize + " reached");
}
return super.add(e);
}
@Override
public void add(int index, T element) {
if (size() >= maxSize) {
throw new IllegalStateException("Cannot add at index " + index + ": maximum size " + maxSize + " reached");
}
super.add(index, element);
}
}
// 使用示例：
BoundedArrayList<Integer> bounded = new BoundedArrayList<>(3);
bounded.add(1); // ✅
bounded.add(2); // ✅
bounded.add(3); // ✅
// bounded.add(4); // ❌ 抛出 IllegalStateException3. 不可变列表（只读场景）
若只需初始化后禁止任何修改（包括添加、删除、更新），使用标准库：
List<Integer> init = new ArrayList<>(Arrays.asList(1, 2, 3)); List<Integer> unmodifiable = Collections.unmodifiableList(init); // unmodifiable.add(4); // ❌ UnsupportedOperationException // unmodifiable.set(0, 99); // ❌ UnsupportedOperationException
✅ 优点：零依赖、线程安全（内容不可变）；❌ 缺点：完全不可写，不满足“可更新但不可扩容”的需求。
总结建议
- 若需可写但不可扩容（如配置项容器、状态寄存器），优先选择 FixedSizeList；
- 若需自定义拒绝策略（如抛异常、静默丢弃、覆盖最早元素等），应实现 自定义 BoundedArrayList；
- 若仅需初始化后锁定数据，Collections.unmodifiableList() 最轻量；
- 切勿依赖 new ArrayList(capacity) 实现容量限制——它仅影响性能，不提供语义约束。
