Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Riferimento a metodo (::)

La sintassi :: adatta un metodo esistente, un costruttore o la creazione di un array a un’interfaccia funzionale. Non invoca subito l’operazione referenziata; il tipo di destinazione determina i parametri compatibili e il risultato.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

Type::staticMethod
expression::instanceMethod
Type::instanceMethod
ClassType::new
ArrayType::new
super::instanceMethod
TypeName.super::instanceMethod

Un’espressione che contiene :: crea un riferimento a metodo compatibile con un’interfaccia funzionale di destinazione. Un’interfaccia funzionale deve definire un unico contratto di funzione, che può essere espresso da più dichiarazioni compatibili di metodi astratti. Per stabilire se l’interfaccia è funzionale, non si considerano le dichiarazioni che corrispondono a metodi pubblici di Object. Il contratto guida la compatibilità dei parametri e del risultato, oltre alla scelta tra metodi sovraccaricati. L’espressione non esegue l’operazione referenziata. var f = String::length non è valido perché non specifica un tipo di destinazione.

Type::staticMethod fa riferimento a un metodo statico. expression::instanceMethod associa un ricevitore specifico, mentre Type::instanceMethod riceve il proprio ricevitore dal primo argomento dell’invocazione successiva. Perciò String::length è adatto a ToIntFunction<String>: l’argomento String è il ricevitore, non un parametro di length().

ClassType::new fa riferimento a un costruttore e ArrayType::new crea un array della lunghezza indicata. super::instanceMethod e TypeName.super::instanceMethod fanno riferimento a un’implementazione di un supertipo quando il contesto del linguaggio lo consente. Un riferimento può sostituire una lambda che inoltra gli argomenti a un’operazione esistente.

Attenzione: in expression::instanceMethod, l’espressione del ricevitore viene valutata e memorizzata subito; se è null, si verifica allora una NullPointerException, non soltanto al momento dell’invocazione. Nell’esempio, Math::abs, String::length e String[]::new vengono eseguiti solo attraverso i metodi delle interfacce funzionali.

Esempi

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);
    }
}

Risultato

7
4
3

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti