如何在 Java 中实现固定容量的 ArrayList（限制最大长度为 3）-java教程-PHP中文网

如何在 Java 中实现固定容量的 ArrayList（限制最大长度为 3）

java 原生 arraylist 不支持强制限制容量上限；new arraylist(3) 仅设置初始容量，不阻止后续添加元素。要实现真正固定大小（如最多 3 个元素），需借助不可变包装、自定义封装类或 apache commons collections 的 fixedsizelist。

java 原生 arraylist 不支持强制限制容量上限；new arraylist(3) 仅设置初始容量，不阻止后续添加元素。要实现真正固定大小（如最多 3 个元素），需借助不可变包装、自定义封装类或 apache commons collections 的 fixedsizelist。

ArrayList 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</integer></integer></integer>

⚠️ 注意：FixedSizeList 不允许 add/remove，仅支持 set(index, value) —— 它本质是“固定长度的可写数组式列表”，适用于预分配结构且仅需更新值的场景。

deep-java-review
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

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); // ❌ 抛出 IllegalStateException</integer></t></t>

3. 不可变列表（只读场景）

若只需初始化后禁止任何修改（包括添加、删除、更新），使用标准库：

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</integer></integer>