CKTIS / Java
Referencia a método (::)
La sintaxis :: adapta un método existente, un constructor o la creación de un array a una interfaz funcional. No invoca inmediatamente la operación referenciada; el tipo destino determina los parámetros compatibles y el resultado.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
Type::staticMethod
expression::instanceMethod
Type::instanceMethod
ClassType::new
ArrayType::new
super::instanceMethod
TypeName.super::instanceMethodUna expresión que contiene :: crea una referencia a método compatible con una interfaz funcional destino. Una interfaz funcional debe definir un único contrato de función, que puede expresarse mediante varias declaraciones compatibles de métodos abstractos. Para determinar si la interfaz es funcional, no se tienen en cuenta las declaraciones que coinciden con métodos públicos de Object. El contrato guía la compatibilidad de los parámetros y del resultado, así como la selección entre sobrecargas. La expresión no ejecuta la operación referenciada. var f = String::length no es válido porque no proporciona un tipo destino.
Type::staticMethod referencia un método estático. expression::instanceMethod vincula un receptor concreto, mientras que Type::instanceMethod obtiene el receptor del primer argumento de la invocación posterior. Por tanto, String::length encaja con ToIntFunction<String>: el argumento String es el receptor, no un parámetro de length().
ClassType::new referencia un constructor, y ArrayType::new crea un array con la longitud indicada. super::instanceMethod y TypeName.super::instanceMethod hacen referencia a una implementación de un supertipo cuando el contexto del lenguaje lo permite. Una referencia puede sustituir a una lambda que reenvía argumentos a una operación existente.
Atención: en expression::instanceMethod, la expresión del receptor se evalúa y captura inmediatamente; si es null, se produce entonces una NullPointerException, no solo al invocar. En el ejemplo, Math::abs, String::length y String[]::new solo se ejecutan mediante los métodos de las interfaces funcionales.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.