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

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

• Существует несколько основных форм функций, включая 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).