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