База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Function.identity(): тъждествена функция и финализатор на колектор

`Function.identity()` връща функция, която връща същата референция. Като финализатор на колектор тя връща контейнера за натрупване без преобразуване.

Версия: Java SE 21

Синтаксис

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() е статичен обобщен метод на интерфейса java.util.function.Function, достъпен от Java 8. Извикването не приема аргументи и връща Function<T, T>, при която входът и резултатът са от един и същ тип. Нейният apply(x) работи като x -> x: връща същата референция, без да копира или променя обекта, а при null връща null.

В Collector<T, A, R> T е типът на входните елементи, A е типът на контейнера за натрупване, а R е типът на крайния резултат. finisher() предоставя функция Function<A, R>. Ако A и R са от един и същ тип и контейнерът трябва да стане резултат без промяна, подай Function.identity() на претоварения вариант на Collector.of с изрично указан финализатор. Ако резултатът трябва да е копие или да не може да се променя, използвай финализатор, който извършва това преобразуване.

Подаването на Function.identity() като финализатор не задава автоматично IDENTITY_FINISH. Тази характеристика позволява на редукцията да пропусне извикването на финализатора. Указвай я само ако финализаторът е тъждествена функция и непроверено привеждане от A към R ще успее. Вариантът на Collector.of без аргумент за финализатор сам задава тази характеристика.

Ако даден API изисква UnaryOperator<T>, използвай UnaryOperator.identity(): поведението е същото, но декларираният тип на връщаната стойност е UnaryOperator<T>, а не Function<T, T>.

Примери

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));
    }
}

Резултат

true
[Ada, Lin]

Първият ред, `true`, показва, че след пряко извикване на финализатора `==` потвърждава, че референцията е същата. Вторият, `[Ada, Lin]`, показва съдържанието, събрано от потока, а не дали потокът е извикал финализатора.

Свързани уроци

  • Java · Урок 24 · Напреднало · Версия: 2

Източници