CKTIS / Java
Methodeverwijzing (::)
De syntaxis :: past een bestaande methode, constructor of arraycreatie aan een functionele interface aan. De verwijzing voert de bewerking niet meteen uit; het doeltype bepaalt welke parameters en welk resultaat passen.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
Type::staticMethod
expression::instanceMethod
Type::instanceMethod
ClassType::new
ArrayType::new
super::instanceMethod
TypeName.super::instanceMethodEen expressie met :: maakt een methodeverwijzing die past bij de functionele doelinterface. Een functionele interface moet één functiecontract vastleggen. Dat contract kan worden uitgedrukt door meerdere compatibele abstracte methodedeclaraties. Declaraties die overeenkomen met openbare methoden van Object tellen niet mee bij de beoordeling of een interface functioneel is. Het contract bepaalt welke parameters en welk resultaat compatibel zijn en helpt bij de keuze tussen overloaded methoden. De expressie voert de bewerking waarnaar ze verwijst niet uit. var f = String::length is ongeldig, omdat er geen doeltype is opgegeven.
Type::staticMethod verwijst naar een statische methode. expression::instanceMethod bindt een specifieke ontvanger, terwijl Type::instanceMethod de ontvanger als eerste argument van de latere aanroep krijgt. Daarom past String::length bij ToIntFunction<String>: het argument van het type String is de ontvanger, niet een parameter van length().
ClassType::new verwijst naar een constructor en ArrayType::new maakt een array met de opgegeven lengte. super::instanceMethod en TypeName.super::instanceMethod verwijzen naar een implementatie van een supertype waar de taalcontext dat toestaat. Een verwijzing kan een lambda vervangen die argumenten doorgeeft aan een bestaande bewerking.
Let op: bij expression::instanceMethod wordt de ontvangersexpressie meteen geëvalueerd en vastgelegd; als deze null is, ontstaat dan een NullPointerException, niet pas bij de aanroep. In het voorbeeld worden Math::abs, String::length en String[]::new pas uitgevoerd via de methoden van de functionele interfaces.
Voorbeelden
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);
}
}Resultaat
7 4 3
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.