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