Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

List.of y List.of() — listas no modificables

`List.of` crea una lista no modificable con los elementos indicados. Sin argumentos, `List.of()` devuelve una lista vacía. Ninguna sobrecarga admite elementos `null`.

Versión: Java SE 21

Sintaxis

import java.util.List;

List<E> empty = List.of();
List<E> values = List.of(e1, e2);

// Factory method signatures (E is the element type):
// static <E> List<E> of()
// static <E> List<E> of(E e1, ..., E eN)  [one overload for each N from 1 to 10]
// static <E> List<E> of(E... elements)

List.of es una familia de métodos fábrica estáticos de la interfaz java.util.List, disponible desde Java 9. List.of() es la sobrecarga sin argumentos: devuelve una lista vacía y no modificable que puedes pasar cuando se espera una lista pero no hay elementos que proporcionar. En List<String> empty = List.of();, Java infiere el tipo de los elementos a partir del tipo declarado de la variable.

Hay sobrecargas con un número fijo de parámetros para entre 1 y 10 elementos, y una sobrecarga de argumentos variables, of(E... elements), para cualquier cantidad de elementos. La lista conserva el orden de los argumentos y admite duplicados. Si algún elemento es null, la llamada lanza NullPointerException en lugar de devolver una lista.

Llamar a add, remove o set sobre la lista devuelta lanza UnsupportedOperationException, incluso si está vacía. Que la lista no se pueda modificar no vuelve inmutables los objetos que contiene. Si necesitas añadir, eliminar o reemplazar elementos, crea una copia superficial y modificable con new ArrayList<>(source).

Ejemplos

import java.util.ArrayList;
import java.util.List;

public class ListOfDemo {
    public static void main(String[] args) {
        List<String> empty = List.of();
        List<String> colors = List.of("red", "blue", "red");
        System.out.println("Empty size: " + empty.size());
        System.out.println("Colors: " + String.join(", ", colors));

        try {
            colors.set(0, "green");
        } catch (UnsupportedOperationException expected) {
            System.out.println("UnsupportedOperationException");
        }

        try {
            List.of("red", null);
        } catch (NullPointerException expected) {
            System.out.println("NullPointerException");
        }

        List<String> editable = new ArrayList<>(empty);
        editable.add("green");
        System.out.println("Mutable copy: " + editable.get(0));
        System.out.println("Original size: " + empty.size());
    }
}

Resultado

Empty size: 0
Colors: red, blue, red
UnsupportedOperationException
NullPointerException
Mutable copy: green
Original size: 0

El ejemplo muestra una lista vacía, la conservación del orden y de los duplicados, y dos excepciones distintas. Añadir un elemento a la copia modificable no cambia la lista vacía original.

Lecciones relacionadas

  • Java · Lección 67 · Básico · Versión: 2
  • Java · Lección 34 · Intermedio · Versión: 2
  • Java · Lección 43 · Intermedio · Versión: 2

Fuentes