CKTIS / Java
Methodenreferenz (::)
Die Syntax :: passt eine vorhandene Methode, einen Konstruktor oder eine Array-Erzeugung an ein funktionales Interface an. Sie ruft die referenzierte Operation nicht sofort auf; der Zieltyp bestimmt kompatible Parameter und das Ergebnis.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
Type::staticMethod
expression::instanceMethod
Type::instanceMethod
ClassType::new
ArrayType::new
super::instanceMethod
TypeName.super::instanceMethodEin Ausdruck mit :: erstellt eine Methodenreferenz, die mit einem Ziel-Funktionsinterface kompatibel ist. Ein funktionales Interface muss einen einzigen Funktionsvertrag festlegen, der sich auch aus mehreren kompatiblen abstrakten Methodendeklarationen ergeben kann. Deklarationen, die öffentlichen Methoden von Object entsprechen, bleiben bei der Prüfung unberücksichtigt, ob das Interface funktional ist. Der Vertrag bestimmt die Kompatibilität der Parameter und des Ergebnisses sowie die Auswahl überladener Methoden. Der Ausdruck führt die referenzierte Operation nicht aus. var f = String::length ist ungültig, weil kein Zieltyp angegeben ist.
Type::staticMethod verweist auf eine statische Methode. expression::instanceMethod bindet einen bestimmten Empfänger, während Type::instanceMethod den Empfänger aus dem ersten Argument des späteren Aufrufs bezieht. Daher passt String::length zu ToIntFunction<String>: Das Argument vom Typ String ist der Empfänger und kein Parameter von length().
ClassType::new verweist auf einen Konstruktor, und ArrayType::new erstellt ein Array mit der angegebenen Länge. super::instanceMethod und TypeName.super::instanceMethod verweisen auf eine Implementierung eines Supertyps, sofern der Sprachkontext dies zulässt. Eine Referenz kann eine Lambda-Expression ersetzen, die Argumente an eine vorhandene Operation weiterleitet.
Achtung: Bei expression::instanceMethod wird der Empfängerausdruck sofort ausgewertet und gespeichert; ist er null, tritt dann eine NullPointerException auf und nicht erst beim Aufruf. Im Beispiel werden Math::abs, String::length und String[]::new erst durch die Methoden der funktionalen Interfaces ausgeführt.
Beispiele
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);
}
}Ergebnis
7 4 3
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.