Пакет java.util.function

Функциональные интерфейсы предоставляют целевые типы для лямбда-выражений и ссылок на методы. Каждый функциональный интерфейс имеет один абстрактный метод, называемый функциональным методом для этого функционального интерфейса, к которому подбираются или адаптируются параметр и тип возвращаемого значения лямбда-выражения. Функциональные интерфейсы могут предоставлять целевой тип в нескольких контекстах, таких как контекст присваивания, вызов метода или контекст приведения типа:

// Assignment context
     Predicate<String> p = String::isEmpty;

     // Method invocation context
     stream.filter(e -> e.getSize() > 10)...

     // Cast context
     stream.map((ToIntFunction) e -> e.getSize())...

Интерфейсы в этом пакете являются универсальными функциональными интерфейсами, используемыми JDK, и также доступны для использования кодом пользователя. Хотя они не определяют полный набор форм функций, к которым могут быть адаптированы лямбда-выражения, они предоставляют достаточно для удовлетворения общих требований. Другие функциональные интерфейсы, предоставляемые для определенных целей, такие как FileFilter, определены в пакетах, где они используются.

Интерфейсы в этом пакете аннотированы с помощью FunctionalInterface. Эта аннотация не является требованием для компилятора, чтобы распознать интерфейс как функциональный, но просто помогает зафиксировать намерение разработчика и заручиться помощью компилятора в выявлении случайных нарушений намерения.

Функциональные интерфейсы часто представляют абстрактные понятия, такие как функции, действия или предикаты. При документировании функциональных интерфейсов или при ссылке на переменные, типизированные как функциональные интерфейсы, обычно ссылаются непосредственно на эти абстрактные понятия, например, используя «эта функция» вместо «функция, представленная этим объектом». Когда метод API говорится, что он принимает или возвращает функциональный интерфейс таким образом, например, «применяет предоставленную функцию к…», это означает ссылку не равную null на объект, реализующий соответствующий функциональный интерфейс, если потенциальная нулевость не указана явно.

Функциональные интерфейсы в этом пакете следуют расширяемой схеме именования следующим образом:

• Существует несколько основных форм функций, включая Function (унарная функция от T к R), Consumer (унарная функция от T к void), Predicate (унарная функция от T к boolean), и Supplier (нульарная функция к R).
• Формы функций имеют естественную арность, основанную на том, как они наиболее часто используются. Основные формы могут быть изменены префиксом арности, чтобы указать другую арность, например, BiFunction (бинарная функция от T и U к R).
• Существуют дополнительные производные формы функций, которые расширяют основные формы функций, включая UnaryOperator (расширяет Function) и BinaryOperator (расширяет BiFunction).
• Параметры типа функциональных интерфейсов могут быть специализированы для примитивов с дополнительными префиксами типа. Для специализации типа возвращаемого значения для типа, имеющего как обобщенный тип возвращаемого значения, так и обобщенные аргументы, мы используем префикс ToXxx, как в ToIntFunction. В противном случае аргументы типа специализируются слева направо, как в DoubleConsumer или ObjIntConsumer. (Префикс типа Obj используется для указания того, что мы не хотим специализировать этот параметр, а хотим перейти к следующему параметру, как в ObjIntConsumer.) Эти схемы могут быть объединены, как в IntToDoubleFunction.
• Если для всех аргументов есть префиксы специализации, префикс арности можно опустить (как в ObjIntConsumer).