IllegalStateException in Java with Example

🎓 Top 15 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare — All my Udemy courses are real-time and project oriented courses.

▶️ Subscribe to My YouTube Channel (178K+ subscribers): Java Guides on YouTube

▶️ For AI, ChatGPT, Web, Tech, and Generative AI, subscribe to another channel: Ramesh Fadatare on YouTube

This Java example demonstrates the usage of java.lang.IllegalStateException class and when does this exception occurs with a simple example.
IllegalStateException class signals that a method has been invoked at an illegal or inappropriate time. In other words, the Java environment or Java application is not in an appropriate state for the requested operation.

What is IllegalStateException? 

The IllegalStateException is a runtime exception thrown to indicate that a method has been invoked at an inappropriate time, or the Java environment or Java application is not in an appropriate state for the requested operation. 

Common Scenarios 

Modifying Collections: Iterating over a collection while simultaneously trying to modify it (without using an iterator's remove method). 

Threads: Calling certain methods before or after a thread has started. 

Java EE: Invoking certain methods when a session has been invalidated or a request has been completed. 

Frameworks and Libraries: Many libraries use IllegalStateException to indicate misuse or incorrect lifecycle operations.

IllegalStateException Class Diagram

Java IllegalStateException Example

In this example, the Iterator.remove() method throws an IllegalStateException - if the next method has not yet been called, or the remove method has already been called after the last call to the next method.

package com.javaguides.corejava;

import java.util.ArrayList;

import java.util.Iterator;
import java.util.List;

public class IllegalStateExceptionExample {

    public static void main(String[] args) {

        List < Integer > intList = new ArrayList < > ();

        for (int i = 0; i < 10; i++) {
            intList.add(i);
        }

        Iterator < Integer > intListIterator = intList.iterator(); // Initialized with index at -1

        try {
            intListIterator.remove(); // IllegalStateException
        } catch (IllegalStateException e) {
            System.err.println("IllegalStateException caught!");
            e.printStackTrace();
        }
    }
}

Output:

IllegalStateException caught!
java.lang.IllegalStateException
 at java.util.ArrayList$Itr.remove(ArrayList.java:872)
 at com.javaguides.corejava.IllegalStateExceptionExample.main(IllegalStateExceptionExample.java:21)

Handling IllegalStateException 

Anticipation: Understanding the state model of the objects you're working with can help anticipate potential issues. 

Check Before You Act: Check the state before performing operations. For example, ensure a thread hasn't started before invoking certain methods on it. 

Use Atomic Operations: In concurrent scenarios, ensure that state-changing operations are atomic to prevent inconsistent states. 

Exception Handling: Employ try-catch blocks judiciously to catch and deal with unexpected state violations. 

Best Practices 

• Be aware of the lifecycle of objects, especially when working with frameworks and libraries. 
• Clearly document the expected state and constraints for your methods when creating APIs. 
• Familiarize yourself with Java's concurrency utilities when dealing with multi-threaded applications to avoid state-related issues.

Related Exceptions Posts

Java built-in checked exceptions:

• FileNotFoundException
• EOFException
• ClassNotFoundException
• SQLException
• NoSuchMethodException
• InterruptedException

Java built-in unchecked exceptions:

• NullPointerException
• ArrayIndexOutOfBoundsException
• StringIndexOutOfBoundsException
• ArithmeticException
• IllegalArgumentException
• NumberFormatException
• IllegalStateException
• ClassCastException

Java built-in errors:

• OutOfMemoryError
• StackOverflowError
• NoClassDefFoundError

My Top and Bestseller Udemy Courses. The sale is going on with a 70 - 80% discount. The discount coupon has been added to each course below:

Build REST APIs with Spring Boot 4, Spring Security 7, and JWT

🆕 High-Demand 80–90% OFF

[NEW] Learn Apache Maven with IntelliJ IDEA and Java 25

🆕 High-Demand 80–90% OFF

ChatGPT + Generative AI + Prompt Engineering for Beginners

🚀 Trending Now 80–90% OFF

Spring 7 and Spring Boot 4 for Beginners (Includes 8 Projects)

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Real-Time REST APIs with Spring Boot - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Microservices with Spring Boot and Spring Cloud

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Java Full-Stack Developer Course with Spring Boot and React JS

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Build 5 Spring Boot Projects with Java: Line-by-Line Coding

🌟 Top Rated 80–90% OFF

Testing Spring Boot Application with JUnit and Mockito

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot Thymeleaf Real-Time Web Application - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Master Spring Data JPA with Hibernate

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot + Apache Kafka Course - The Practical Guide

🎓 Student Favorite 80–90% OFF
Available in Udemy for Business

Java Testing: Mastering JUnit 5 Framework

🆕 New 80–90% OFF

Reactive Programming in Java: Spring WebFlux and Testing

🌟 Top Rated 80–90% OFF

Spring Boot + RabbitMQ Course - The Practical Guide

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Functional Programming in Java (Includes Java Collections)

🎓 Student Favorite 80–90% OFF

ChatGPT for Java Developers: Boost Your Productivity with AI

🚀 Trending Now 80–90% OFF