CKTIS / Java
Referenca na metodu (::)
Sintaksa :: prilagođava postojeću metodu, konstruktor ili stvaranje polja funkcijskom sučelju. Ne poziva odmah referenciranu operaciju; ciljni tip određuje kompatibilne parametre i rezultat.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Type::staticMethod
expression::instanceMethod
Type::instanceMethod
ClassType::new
ArrayType::new
super::instanceMethod
TypeName.super::instanceMethodIzraz koji sadrži :: stvara referencu na metodu kompatibilnu s ciljanim funkcijskim sučeljem. Funkcijsko sučelje mora definirati jedan ugovor funkcije, koji se može izraziti s više kompatibilnih deklaracija apstraktnih metoda. Pri utvrđivanju je li sučelje funkcijsko ne uzimaju se u obzir deklaracije koje odgovaraju javnim metodama klase Object. Taj ugovor određuje kompatibilnost parametara i rezultata te odabir među preopterećenim metodama. Izraz ne izvršava referenciranu operaciju. var f = String::length nije valjan jer nije naveden ciljni tip.
Type::staticMethod referencira statičku metodu. expression::instanceMethod veže određeni objekt-primatelj, dok Type::instanceMethod prima objekt-primatelj kao prvi argument kasnijeg poziva. Zato String::length odgovara sučelju ToIntFunction<String>: argument tipa String objekt je primatelj, a ne parametar metode length().
ClassType::new referencira konstruktor, a ArrayType::new stvara polje zadane duljine. super::instanceMethod i TypeName.super::instanceMethod referenciraju implementaciju nadtipa kada je to dopušteno u jezičnom kontekstu. Referenca može zamijeniti lambdu koja prosljeđuje argumente postojećoj operaciji.
Oprez: u izrazu expression::instanceMethod izraz objekta-primatelja izračunava se i pohranjuje odmah; ako je null, tada nastaje NullPointerException, a ne tek pri pozivu. U primjeru se Math::abs, String::length i String[]::new izvršavaju tek putem metoda funkcijskih sučelja.
Primjeri
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);
}
}Rezultat
7 4 3
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.