Пакет 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).