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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.