CKTIS / Java
java.lang.reflect.Method — inspecionar e invocar um método
Um objeto Method representa um método acedido através de reflexão. Permite inspecionar o nome e as anotações do método e invocá-lo durante a execução. A supressão das verificações de acesso com setAccessible continua sujeita aos limites dos módulos.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
Method m = Type.class.getDeclaredMethod("methodName", ParameterType.class);
String name = m.getName();
boolean annotated = m.isAnnotationPresent(Marker.class);
m.setAccessible(true);
Object result = m.invoke(receiver, argument);java.lang.reflect.Method representa um método de uma classe ou interface. Class.getDeclaredMethod procura um método declarado por esse tipo, incluindo métodos privados mas não herdados; Class.getMethod procura métodos públicos, incluindo os herdados. Os tipos dos parâmetros identificam a sobrecarga: int.class e Integer.class não são intercambiáveis durante a pesquisa.
Method.getName() devolve apenas o nome, não a assinatura. Method.isAnnotationPresent(Marker.class) verifica se existe uma anotação desse tipo; a anotação tem de ter retenção RetentionPolicy.RUNTIME. As anotações dos métodos não são herdadas pelos métodos que os substituem, mesmo quando se usa @Inherited.
Method.setAccessible(true) suprime, quando permitido, as verificações de acesso da linguagem Java para este objeto de reflexão; não altera a declaração para public. Não contorna os limites dos módulos: para aceder a um método privado noutro módulo, o respetivo pacote tem de estar aberto ao módulo que o invoca. Uma recusa pode causar InaccessibleObjectException ou SecurityException. trySetAccessible() permite obter false em vez da primeira destas exceções.
Method.invoke(receiver, arguments) invoca o método; se este for estático, o recetor é ignorado e pode ser null. O resultado é do tipo Object, os valores primitivos são convertidos para os respetivos objetos e void produz null. Argumentos inválidos causam IllegalArgumentException, o acesso recusado causa IllegalAccessException e uma exceção do método invocado é encapsulada em InvocationTargetException.
O exemplo usa uma classe autónoma de nível superior, Greeter, para demonstrar o acesso de Main a um método privado. Âmbito: Java SE 21; o ambiente de execução do repositório não está certificado, nem o ambiente de produção.
Exemplos
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Method;
class Greeter {
@Retention(RetentionPolicy.RUNTIME)
@interface Marker {}
@Marker
private String greet(String name) {
return "Hello, " + name;
}
}
public class Main {
public static void main(String[] args) throws ReflectiveOperationException {
Method m = Greeter.class.getDeclaredMethod("greet", String.class);
System.out.println(m.getName());
System.out.println(m.isAnnotationPresent(Greeter.Marker.class));
m.setAccessible(true);
System.out.println(m.invoke(new Greeter(), "Ada"));
}
}Resultado
greet true Hello, Ada
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.