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::instanceMethodUma 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.