什么是打算使用的IllegalStateExcture？

Question

这是在今天与一位同事的讨论中提出的。

Javadocs for Java的IllegalStateExc0019声明它：

表示方法已在非法或不适当的时间被调用。换句话说，Java环境或Java应用程序不处于用于所请求操作的适当状态。

有效Java表示（第248页第60项）：

另一个经常重用的异常是IllegalStateExcema。如果由于接收对象的状态，调用是非法的，这通常是抛出的异常。例如，如果调用方试图在正确初始化某个对象之前使用该对象，则会引发异常。

这里似乎有点不一致。javadocs的第二句话听起来像是异常可以描述关于Java执行状态的一个非常广泛的条件，但是在有效Java中的描述听起来像是用于专门与方法被调用的对象的状态相关的条件。

我在JDK（例如，collections，Matcher）和Guava中看到的用法显然属于有效Java所谈论的类别（“此对象处于无法调用此方法的状态”）。这似乎也与IllegalStateException的同级IllegalArgumentException一致。

JDK中是否有任何合法的IllegalStateExcture用法与Java环境或Java应用程序相关？或者任何最佳实践指南都提倡将其用于更广泛的执行状态？如果不是，为什么javadocs会这样措辞？；）

Answer 1

我想如果你看到IllegalStateException的用法，如果更合适的话，我会说第二个。此异常在许多包中使用

• 爪哇。net

指定一个示例ArrayBlockingQueue。如果队列已满，add将引发此异常。现在，full是对象的状态，它在不适当或非法的时间被调用

我想两者意思相同，但措辞不同。

Answer 2

下面是JDK中的一个例子。有一个包私有类称为java.lang.关闭。如果系统正在关闭，并且您试图添加一个新的钩子，它会抛出IllegalStateExcure。有人可能会说，这符合“javadoc”指南的标准——因为Java环境处于错误的状态。

class Shutdown {    
...

   /* Add a new shutdown hook.  Checks the shutdown state and the hook itself,
    * but does not do any security checks.
    */
    static void add(int slot, Runnable hook) {
        synchronized (lock) {
            if (state > RUNNING)
                throw new IllegalStateException("Shutdown in progress");

            if (hooks[slot] != null)
                throw new InternalError("Shutdown hook at slot " + slot + " already registered");

            hooks[slot] = hook;
        }
    }

然而，它也说明了“javadoc”指南和“有效Java”指南之间实际上没有区别。由于实现关闭的方式，JVM的关闭状态存储在一个名为state的字段中。因此，它还满足何时使用IllegalStateExcema的有效Java指南，因为“状态”字段是接收对象状态的一部分。由于接收对象（Shutdown）处于错误的状态，它会抛出IllegalStateExcture。

在我看来，关于何时使用IllegalStateExcema的两种描述是一致的。有效Java描述更实用一点，仅此而已。对我们大多数人来说，整个Java环境中最重要的部分是我们现在正在写的类，所以这就是作者所关注的。

Answer 3

以下是此异常在JDK中的一个特别合法的用法（参见：URLConnection.setIfModifiedSince（long），以及它的300种其他用法：

public void setIfModifiedSince(long ifmodifiedsince) {
    if (connected)
        throw new IllegalStateException("Already connected");
    ifModifiedSince = ifmodifiedsince;
}

我认为这个例子很清楚。如果对象处于特定状态（“已连接”），则不应调用某些操作。在这种情况下，当建立连接时，无法设置某些属性。

当类具有某种状态（状态机？）时，此异常特别有用这会随着时间的推移而改变，使得某些方法变得无关紧要或不可能。考虑一个Car类，它有start（）、stop（）和fuel（）方法。调用start（）两次，一次又一次，可能没什么错，但给启动的汽车加油肯定是个坏主意。也就是说，汽车处于错误的状态。

可以说，好的API不应该允许我们调用处于错误状态的方法，从而在编译时而不是运行时发现类似的问题。在这个特定的例子中，连接到一个URL应该返回一个带有子集方法的不同对象，所有这些方法在连接后都是有效的。