Пакет 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 на объект, реализующий соответствующий функциональный интерфейс, если явным образом не указана потенциальная возможность 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).