Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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::instanceMethod

Wyraż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.

Źródła