java - 当用户试图添加到一个完整的容器时抛出哪个异常

Question

我正在尝试为通用类型元素编写一个固定大小的队列。用户可以调用构造函数，提供一个大小并为该大小创建一个内部数组。(见下文)

class FixedSizeQ<E>{
    private E[] q;
    private int N;

    public FixedSizeQ(int max) {
        super();
        q = (E[]) new Object[max];
        N = 0;
    }
..
}

我想为上面定义一个 isEmpty() 和 isFull() 方法以及一个 insert() 方法。如果客户端试图向已经满的数组添加一个元素，我想抛出一个异常。通过javadocs，我认为 IllegalStateException 将是抛出的正确异常。

public boolean isFull(){
    return N == q.length;
}
public void insert(Item item){
    if(isFull()){
        throw new IllegalStateException("queue full");
    }
    ...     
}

我想知道我的理解是否正确..有人建议 IllegalArgumentException 更合适。有人可以建议吗？

Answer 1

我认为您应该让插入方法返回 boolean 值，如果对象已插入则返回 true，如果队列已满则返回 false。将对象添加到完整队列对我来说似乎不是异常情况。

无论如何，如果 Java API 中没有预定义的异常是很好的匹配，您可以创建自己的异常类型以最适合这种情况:

public class QueueFullException extends RuntimeException {
    // or "extends Exception" if you want it checked
    ...
}