Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Referência a método (::)

A sintaxe :: adapta um método existente, um construtor ou a criação de um array a uma interface funcional. Não invoca imediatamente a operação referenciada; o tipo de destino determina os parâmetros compatíveis e o resultado.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

Uma expressão que contém :: cria uma referência a método compatível com uma interface funcional de destino. Uma interface funcional tem de definir um único contrato de função, que pode ser expresso por várias declarações compatíveis de métodos abstratos. As declarações que correspondem a métodos públicos de Object não são tidas em conta ao determinar se a interface é funcional. O contrato orienta a compatibilidade dos parâmetros e do resultado, bem como a escolha entre métodos sobrecarregados. A expressão não executa a operação referenciada. var f = String::length é inválido porque não indica um tipo de destino.

Type::staticMethod referencia um método estático. expression::instanceMethod associa um recetor específico, enquanto Type::instanceMethod recebe o recetor como primeiro argumento da invocação posterior. Assim, String::length é compatível com ToIntFunction<String>: o argumento String é o recetor, não um parâmetro de length().

ClassType::new referencia um construtor e ArrayType::new cria um array com o comprimento indicado. super::instanceMethod e TypeName.super::instanceMethod referenciam uma implementação de um supertipo quando o contexto da linguagem o permite. Uma referência pode substituir uma lambda que encaminha argumentos para uma operação existente.

Atenção: em expression::instanceMethod, a expressão do recetor é avaliada e guardada de imediato; se for null, ocorre então uma NullPointerException, e não apenas no momento da invocação. No exemplo, Math::abs, String::length e String[]::new só são executados através dos métodos das interfaces funcionais.

Exemplos

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

Resultado

7
4
3

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes