Class IllegalStateException
Note that the detail message associated with cause is not automatically incorporated in this exception’s detail message.
IllegalStateException
Report a bug or suggest an enhancement
For further API reference and developer documentation see the Java SE Documentation, which contains more detailed, developer-targeted descriptions with conceptual overviews, definitions of terms, workarounds, and working code examples.
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 1993, 2021, Oracle and/or its affiliates, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
All rights reserved. Use is subject to license terms and the documentation redistribution policy.
Для чего предназначено IllegalStateException?
Javadocs для Java IllegalStateException утверждают, что он:
Сигналы о том, что метод был вызван в незаконное или ненадлежащее время. Другими словами, среда Java или приложение Java не находятся в соответствующем состоянии для запрошенной операции.
И эффективная Java говорит (Пункт 60, страница 248):
Другим обычно используемым исключением является IllegalStateException. Это, как правило, исключение для броска, если вызов является незаконным из-за состояния принимающего объекта. Например, это было бы исключение для броска, если вызывающий пытался использовать какой-либо объект, прежде чем он был правильно инициализирован.
Кажется, здесь немного расхождения. Во втором предложении javadocs звучит так, что исключение может описывать очень широкое условие состояния выполнения Java, но описание в Effective Java делает его похожим на условия, связанные конкретно с состоянием состояния объекта, метод был вызван.
Устройства, которые я видел в JDK (например, коллекции, Matcher ) и в Guava, определенно, похоже, относятся к категории, о которой говорит Effective Java ( «Этот объект находится в состоянии, когда этот метод не может быть называется» ). Это также похоже на IllegalStateException sibling IllegalArgumentException .
Существуют ли в JDK законные IllegalStateException -услуги, которые относятся к «среде Java» или «Java-приложению»? Или какие-либо рекомендации по лучшей практике пропагандируют его использование для более широкого состояния исполнения? Если нет, то почему это так называемые javadocs?;)
What is IllegalStateException?
Exception in thread «main» java.lang.IllegalStateException: Sample failed.
[ODBC Teradata Driver] Invalid precision: cbColDef value out of range
Here is my table that I am trying to upload. It is a .csv format and when I open it via notepad it look like this
Why do I get this exception? How can I improve it? As far as I understand the problem is pstmtFld.setAsciiStream(1, dataStream, -1); does not accept the dataset somehow and throw an exception
4 Answers 4
Usually, IllegalStateException is used to indicate that «a method has been invoked at an illegal or inappropriate time.» However, this doesn’t look like a particularly typical use of it.
The code you’ve linked to shows that it can be thrown within that code at line 259 — but only after dumping a SQLException to standard output.
We can’t tell what’s wrong just from that exception — and better code would have used the original SQLException as a «cause» exception (or just let the original exception propagate up the stack) — but you should be able to see more details on standard output. Look at that information, and you should be able to see what caused the exception, and fix it.
How to Fix The IllegalStateException in Java
An IllegalStateException is a runtime exception in Java that is thrown to indicate that a method has been invoked at the wrong time. This exception is used to signal that a method is called at an illegal or inappropriate time.
For example, once a thread has been started, it is not allowed to restart the same thread again. If such an operation is performed, the IllegalStateException is thrown.
Since the IllegalStateException is an unchecked exception, it does not need to be declared in the throws clause of a method or constructor.
What Causes IllegalStateException
The IllegalStateException is thrown when the Java environment or application is not in an appropriate state for the requested operation. This can occur when dealing with threads or the Collections framework of the java.util package under specific conditions. Here are examples of some situations where this exception can occur:
- When the Thread.start() method is called on a thread that has already been started.
- When the remove() method of the Iterator interface is called on a List without calling the next() method. This leaves the List collection in an unstable state, causing an IllegalStateException .
- If an element is attempted to be added to a Queue that is full. Adding elements beyond the size of the queue will cause an IllegalStateException .
IllegalStateException Example
Here’s an example of an IllegalMonitorStateException thrown when the Iterator.remove() method is called to remove an element from an ArrayList before calling the next() method:
Since the remove() method is used to remove the previous element being referred to by the Iterator , the next() method should be called before an element is attempted to be removed. In this case, the next() method was never called, so the Iterator attempts to remove the element before the first element.
Since this action is illegal, running the above code throws an IllegalStateException :
How to Fix IllegalStateException
To avoid the IllegalStateException in Java, it should be ensured that any method in code is not called at an illegal or inappropriate time.
In the above example, calling the Iterator.next() method on the ArrayList before using the remove() method to remove an element from it will help fix the issue:
Calling the next() method moves the Iterator position to the next element. Calling the remove() method afterwards will remove the first element in the ArrayList , which is a legal operation and helps fix the exception.
Running the above code produces the correct output as expected:
Track, Analyze and Manage Errors With Rollbar
Managing Java errors and exceptions in your code is challenging. It can make deploying production code an unnerving experience. Being able to track, analyze, and manage errors in real-time can help you to proceed with more confidence. Rollbar automates error monitoring and triaging, making fixing Java errors easier than ever. Sign Up Today!