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

CKTIS / Java

Function.identity(): función identidad y finalizador de un colector

`Function.identity()` proporciona una función que devuelve la misma referencia. Como finalizador de un colector, devuelve el contenedor de acumulación sin transformarlo.

Versión: Java SE 21

Sintaxis

import java.util.function.Function;

// Static method declaration in java.util.function.Function:
static <T> Function<T, T> identity()

// Typical use:
Function<String, String> same = Function.identity();

Function.identity() es un método genérico estático de la interfaz java.util.function.Function, disponible desde Java 8. La llamada no recibe argumentos y devuelve una Function<T, T>, con el mismo tipo de entrada y de resultado. Su apply(x) se comporta como x -> x: devuelve la misma referencia sin copiar ni modificar el objeto, y devuelve null si recibe null.

En Collector<T, A, R>, T es el tipo de los elementos de entrada, A el del contenedor de acumulación y R el del resultado final. finisher() proporciona una Function<A, R>. Si A y R son del mismo tipo y el contenedor debe convertirse en el resultado sin cambios, pasa Function.identity() a la sobrecarga de Collector.of con finalizador explícito. Si el resultado debe ser una copia o no debe poder modificarse, usa un finalizador que realice esa transformación.

Pasar Function.identity() como finalizador no establece automáticamente IDENTITY_FINISH. Esta característica permite que la reducción omita la llamada al finalizador. Declárala solo si el finalizador es una función identidad y una conversión de tipo no comprobada de A a R tendrá éxito. La sobrecarga de Collector.of sin argumento de finalizador establece esta característica por sí sola.

Si una API requiere un UnaryOperator<T>, usa UnaryOperator.identity(): el comportamiento es el mismo, pero el tipo de retorno declarado es UnaryOperator<T>, no Function<T, T>.

Ejemplos

import java.util.ArrayList;
import java.util.List;
import java.util.function.Function;
import java.util.stream.Collector;

public class IdentityFinisherDemo {
    public static void main(String[] args) {
        Collector<String, List<String>, List<String>> collector = Collector.of(
                ArrayList::new,
                List::add,
                (left, right) -> {
                    left.addAll(right);
                    return left;
                },
                Function.identity(),
                Collector.Characteristics.IDENTITY_FINISH);

        List<String> input = List.of("Ada", "Lin");
        List<String> buffer = collector.supplier().get();
        input.forEach(name -> collector.accumulator().accept(buffer, name));
        List<String> result = collector.finisher().apply(buffer);

        System.out.println(result == buffer);
        System.out.println(input.stream().collect(collector));
    }
}

Resultado

true
[Ada, Lin]

La primera línea, `true`, muestra que `==` confirma que es la misma referencia tras llamar directamente al finalizador. La segunda, `[Ada, Lin]`, muestra el contenido recogido del flujo, no si el flujo llamó al finalizador.

Lecciones relacionadas

  • Java · Lección 24 · Avanzado · Versión: 2

Fuentes