CKTIS / Java
Referencja do metody (::)
Zapis :: pozwala przekazać istniejącą metodę, konstruktor lub tworzenie tablicy jako implementację interfejsu funkcyjnego. Nie wywołuje wskazanej operacji od razu; typ docelowy określa zgodne parametry i wynik.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
Type::staticMethod
expression::instanceMethod
Type::instanceMethod
ClassType::new
ArrayType::new
super::instanceMethod
TypeName.super::instanceMethodWyrażenie z :: tworzy referencję do metody zgodną z docelowym interfejsem funkcyjnym. Interfejs funkcyjny musi określać jeden kontrakt funkcji, który może wynikać z kilku zgodnych deklaracji metod abstrakcyjnych. Przy ustalaniu, czy interfejs jest funkcyjny, pomija się deklaracje odpowiadające publicznym metodom klasy Object. Kontrakt ten wyznacza zasady dopasowania parametrów i wyniku oraz wyboru spośród przeciążeń. Sam zapis nie uruchamia wskazanej operacji. var f = String::length jest błędem: brakuje typu docelowego.
Type::staticMethod wskazuje metodę statyczną. expression::instanceMethod wiąże konkretny obiekt, a Type::instanceMethod otrzymuje obiekt jako pierwszy argument późniejszego wywołania. Dlatego String::length pasuje do ToIntFunction<String>: argument String jest odbiorcą, nie parametrem length().
ClassType::new wskazuje konstruktor, a ArrayType::new tworzenie tablicy o przekazanej długości. super::instanceMethod i TypeName.super::instanceMethod odwołują się do implementacji nadtypu, gdy kontekst języka na to pozwala. Referencja może zastąpić lambdę przekazującą argumenty do istniejącej operacji.
Uwaga: w expression::instanceMethod wyrażenie odbiorcy jest obliczane od razu i zapamiętywane; null powoduje wtedy NullPointerException, nie dopiero przy wywołaniu. W przykładzie Math::abs, String::length i String[]::new są wykonywane dopiero przez metody interfejsów funkcyjnych.
Przykłady
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);
}
}Wynik
7 4 3
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.