База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Препратка към метод (::)

Синтаксисът :: адаптира съществуващ метод, конструктор или създаване на масив към функционален интерфейс. Той не извиква веднага посочената операция; целевият тип определя съвместимите параметри и резултата.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

Type::staticMethod
expression::instanceMethod
Type::instanceMethod
ClassType::new
ArrayType::new
super::instanceMethod
TypeName.super::instanceMethod

Израз с :: създава препратка към метод, съвместима с целеви функционален интерфейс. Функционалният интерфейс трябва да определя един-единствен контракт на функция, който може да бъде изразен чрез няколко съвместими декларации на абстрактни методи. При определяне дали интерфейсът е функционален не се вземат предвид декларациите, които съответстват на публични методи на класа Object. Този контракт определя съвместимостта на параметрите и резултата, както и избора между претоварени методи. Изразът не изпълнява посочената операция. var f = String::length е невалидно, защото не е зададен целеви тип.

Type::staticMethod препраща към статичен метод. expression::instanceMethod обвързва конкретен обект-получател, докато Type::instanceMethod получава получателя като първи аргумент при последващото извикване. Затова String::length съответства на ToIntFunction<String>: аргументът от тип String е получателят, а не параметър на length().

ClassType::new препраща към конструктор, а ArrayType::new създава масив с подадената дължина. super::instanceMethod и TypeName.super::instanceMethod препращат към реализация на супертип, когато езиковият контекст го позволява. Препратката може да замени ламбда, която предава аргументи към съществуваща операция.

Внимание: при expression::instanceMethod изразът на получателя се оценява и запазва незабавно; ако стойността е null, тогава възниква NullPointerException, а не чак при извикването. В примера Math::abs, String::length и String[]::new се изпълняват едва чрез методите на функционалните интерфейси.

Примери

import java.util.function.IntFunction;
import java.util.function.IntUnaryOperator;
import java.util.function.ToIntFunction;

public class Main {
    public static void main(String[] args) {
        IntUnaryOperator absolute = Math::abs;
        ToIntFunction<String> length = String::length;
        IntFunction<String[]> allocate = String[]::new;

        System.out.println(absolute.applyAsInt(-7));
        System.out.println(length.applyAsInt("Java"));
        System.out.println(allocate.apply(3).length);
    }
}

Резултат

7
4
3

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници