Java : IllegalArgumentException con ejemplos

IllegalArgumentException (Java SE 21 & JDK 21) en Java con ejemplos.
Encontrará ejemplos de código en la mayoría de los métodos de IllegalArgumentException.

Nota :

Este artículo puede utilizar software de traducción para su comodidad. Consulte también la versión original en inglés.

Summary

Se lanza para indicar que a un método se le ha pasado un argumento ilegal o inapropiado. (Traducción automática)

Class diagram

public void func(String str) {
    if (str == null) {
        throw new IllegalArgumentException("str is null!");
    }
    if (str.isEmpty()) {
        throw new IllegalArgumentException("str is empty!");
    }

    System.out.println(str);
}

func("abcd"); // abcd

func(null); // java.lang.IllegalArgumentException: str is null!

func(""); // java.lang.IllegalArgumentException: str is empty!

If you only check for null or not, it is recommended to use the Objects.requireNonNull method instead.

public void func(String str) {
    Objects.requireNonNull(str, "str is null!");

    System.out.println(str);
}

func("abcd"); // abcd

func(null); // java.lang.NullPointerException: str is null!

Constructors

IllegalArgumentException ()

Construye una IllegalArgumentException sin mensaje detallado. (Traducción automática)

final var e = new IllegalArgumentException();
System.out.println(e); // java.lang.IllegalArgumentException

IllegalArgumentException (String s)

Construye una IllegalArgumentException con el mensaje detallado especificado. (Traducción automática)

final var e = new IllegalArgumentException("abcde");
System.out.println(e); // java.lang.IllegalArgumentException: abcde
System.out.println(e.getMessage()); // abcde

IllegalArgumentException (String message, Throwable cause)

Construye una nueva excepción con el mensaje detallado y la causa especificados. (Traducción automática)

final var cause = new IllegalArgumentException("XYZ");
final var e = new IllegalArgumentException("abcde", cause);

System.out.println(e); // java.lang.IllegalArgumentException: abcde
System.out.println(e.getMessage()); // abcde

System.out.println(e.getCause()); // java.lang.IllegalArgumentException: XYZ
System.out.println(e.getCause().getMessage()); // XYZ

IllegalArgumentException (Throwable cause)

Construye una nueva excepción con la causa especificada y un mensaje detallado de (cause==null ? null : cause.toString()) (que normalmente contiene la clase y el mensaje detallado de la causa). (Traducción automática)

final var cause = new IllegalArgumentException("XYZ");
final var e = new IllegalArgumentException(cause);

System.out.println(e); // java.lang.IllegalArgumentException: java.lang.IllegalArgumentException: XYZ
System.out.println(e.getMessage()); // java.lang.IllegalArgumentException: XYZ

System.out.println(e.getCause()); // java.lang.IllegalArgumentException: XYZ
System.out.println(e.getCause().getMessage()); // XYZ

Methods declared in Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Consulte el siguiente enlace.

Throwable con ejemplos

Ejemplos de API