CKTIS / Java
Odkaz na metodu (::)
Syntaxe :: přizpůsobí existující metodu, konstruktor nebo vytvoření pole funkčnímu rozhraní. Odkazovanou operaci nevolá okamžitě; cílový typ určuje kompatibilní parametry a výsledek.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
Type::staticMethod
expression::instanceMethod
Type::instanceMethod
ClassType::new
ArrayType::new
super::instanceMethod
TypeName.super::instanceMethodVýraz obsahující :: vytváří odkaz na metodu kompatibilní s cílovým funkčním rozhraním. Funkční rozhraní musí vymezovat jediný kontrakt funkce, který může být vyjádřen několika kompatibilními deklaracemi abstraktních metod. Při posuzování, zda je rozhraní funkční, se neberou v úvahu deklarace odpovídající veřejným metodám třídy Object. Tento kontrakt určuje kompatibilitu parametrů a výsledku i výběr přetížené metody. Výraz odkazovanou operaci neprovádí. var f = String::length je neplatné, protože není zadán cílový typ.
Type::staticMethod odkazuje na statickou metodu. expression::instanceMethod sváže konkrétní přijímající objekt, zatímco Type::instanceMethod získá přijímající objekt z prvního argumentu pozdějšího volání. Proto String::length odpovídá ToIntFunction<String>: argument typu String je přijímající objekt, nikoli parametr metody length().
ClassType::new odkazuje na konstruktor a ArrayType::new vytvoří pole o zadané délce. super::instanceMethod a TypeName.super::instanceMethod odkazují na implementaci nadtypu, pokud to kontext jazyka dovoluje. Odkaz může nahradit lambda výraz, který předává argumenty existující operaci.
Pozor: u expression::instanceMethod se výraz přijímajícího objektu vyhodnotí a uloží okamžitě; pokud je null, dojde k NullPointerException už tehdy, nikoli až při volání. V příkladu se Math::abs, String::length a String[]::new provedou až prostřednictvím metod funkčních rozhraní.
Příklady
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);
}
}Výsledek
7 4 3
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.