Java中利用反射打印方法名及其返回值

// FooClass.java
public class FooClass {

    // 这是一个包私有（default）方法，模拟不能修改的场景
    String barMethod() {
        return "baz";
    }

    // 示例：一个带参数的公共方法
    public String greet(String name) {
        return "Hello, " + name + "!";
    }
}

// MethodNamePrinter.java
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;

public class MethodNamePrinter {

    /**
     * 动态打印指定对象上某个方法的名称及其返回值。
     * 该方法通过Java反射API实现，不要求修改目标类或方法。
     *
     * @param instance   目标对象实例，方法将在此实例上被调用。
     * @param methodName 目标方法的名称（字符串形式）。
     */
    public static void customPrint(Object instance, String methodName) {
        try {
            // 1. 获取目标对象的Class对象
            Class<?> clazz = instance.getClass();

            // 2. 获取目标Method对象
            // 使用 getDeclaredMethod() 可以获取所有声明的方法，包括 private, protected, default。
            // 如果方法是 public 的，也可以使用 getMethod()。
            // 注意：如果方法有参数，需要提供参数类型的Class数组，例如：
            // Method method = clazz.getDeclaredMethod(methodName, String.class);
            Method method = clazz.getDeclaredMethod(methodName);

            // 3. 设置方法可访问性
            // 如果方法是非 public 的（如本例中的 barMethod() 是包私有），
            // 或者方法是 private/protected 的，需要设置其可访问性，否则会抛出 IllegalAccessException。
            // 对于同一个包内的包私有方法，如果调用方也在同一个包，理论上不需要setAccessible(true)，
            // 但为了通用性和处理其他访问修饰符的情况，加上它更为稳妥。
            method.setAccessible(true);

            // 4. 调用方法并获取返回值
            // invoke() 方法的第一个参数是调用方法的对象实例，后续参数是方法的实际参数。
            Object returnValue = method.invoke(instance);

            // 5. 获取方法名称
            String name = method.getName();

            // 6. 构建并打印输出
            System.out.println(name + " = " + returnValue);

        } catch (NoSuchMethodException e) {
            // 如果指定名称的方法不存在，或参数列表不匹配，则捕获此异常。
            System.err.println("错误：未找到指定方法 '" + methodName + "'。请检查方法名是否正确或参数列表是否匹配。");
            e.printStackTrace();
        } catch (IllegalAccessException e) {
            // 如果无法访问方法（例如，未设置 setAccessible(true) 且方法为 private/protected），则捕获此异常。
            System.err.println("错误：无法访问方法 '" + methodName + "'。请检查方法的访问修饰符或确保已设置 setAccessible(true)。");
            e.printStackTrace();
        } catch (InvocationTargetException e) {
            // 如果被调用的方法内部抛出了异常，则捕获此异常。
            // 原始异常会被包装在 InvocationTargetException 中。
            System.err.println("错误：方法 '" + methodName + "' 执行时抛出了异常。");
            e.printStackTrace();
            // 打印被调用方法内部抛出的原始异常
            if (e.getTargetException() != null) {
                System.err.println("原始异常: " + e.getTargetException().getClass().getName() + ": " + e.getTargetException().getMessage());
                e.getTargetException().printStackTrace();
            }
        } catch (Exception e) {
            // 捕获其他可能的运行时异常。
            System.err.println("发生未知错误: " + e.getMessage());
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        FooClass foo = new FooClass();

        // 调用 customPrint 方法，传入 FooClass 实例和方法名字符串
        customPrint(foo, "barMethod"); // 预期输出: barMethod = baz

        // 示例：调用带参数的公共方法
        customPrint(foo, "greet"); // 预期输出: greet = Hello, null! (因为greet方法需要一个String参数，但我们没有提供)
                                   // 这演示了如果方法需要参数，getDeclaredMethod() 和 invoke() 的调用方式需要调整。
                                   // 正确调用带参数方法需要：
                                   // Method method = clazz.getDeclaredMethod(methodName, String.class);
                                   // Object returnValue = method.invoke(instance, "Java");
        System.out.println("--- 尝试调用带参数的方法 ---");
        try {
            Method greetMethod = foo.getClass().getDeclaredMethod("greet", String.class);
            greetMethod.setAccessible(true);
            Object greetResult = greetMethod.invoke(foo, "World");
            System.out.println(greetMethod.getName() + " = " + greetResult); // 预期输出: greet = Hello, World!
        } catch (Exception e) {
            e.printStackTrace();
        }


        // 示例：尝试调用一个不存在的方法
        // customPrint(foo, "nonExistentMethod"); // 预期输出错误信息
    }
}

barMethod = baz
--- 尝试调用带参数的方法 ---
greet = Hello, World!