Краткий ответ

getDeclaredMethod ищет метод только среди методов, объявленных непосредственно указанным классом, независимо от их модификатора доступа. getMethod ищет только публичный метод, доступный через указанный тип, включая унаследованные методы суперклассов и публичные методы интерфейсов.

Эти методы выполняют поиск, а не обычный полиморфный вызов. Поэтому успешный результат поиска ещё не означает, что будет выбрана реализация из фактического класса объекта.

Исторический контекст

Reflection API появился для задач интроспекции: фреймворкам, контейнерам и инструментам нужно было исследовать классы во время выполнения, не имея заранее жёсткой зависимости от их исходного кода.

Для этого Java разделяет два сценария: просмотр собственного объявления класса и поиск публичного API, доступного пользователю типа. Разные методы поиска позволяют не смешивать внутреннюю структуру класса с его внешним контрактом.

Постановка проблемы

Если фреймворк использует getDeclaredMethod, он не найдёт метод, унаследованный от суперкласса, даже если этот метод публичный. Если он использует getMethod, то не сможет найти защищённый, пакетный или закрытый метод, объявленный непосредственно в классе.

Неверный выбор приводит к ошибкам вроде NoSuchMethodException. Дополнительный риск возникает при переопределении: найденный объект Method описывает найденное объявление, но вызов экземплярного метода обычно сохраняет динамическое диспетчеризование Java.

Подробное решение

getDeclaredMethod проверяет только список методов, записанных в декларации конкретного класса. Он учитывает имя и точные типы параметров, но не ищет метод по цепочке наследования; модификатор доступа для самого поиска значения не имеет.

getMethod предназначен для публичного API. Он ищет публичный метод в самом классе, его суперклассах и суперинтерфейсах. Непубличные методы этим способом не находятся, даже если они объявлены прямо в исследуемом классе.

Минимальный пример различия:

class Parent {
    public void inherited() {}
}

class Child extends Parent {
    private void own() {}
}

Child.class.getDeclaredMethod("own");
Child.class.getDeclaredMethod("inherited"); // ошибка
Child.class.getMethod("inherited");         // найден
Child.class.getMethod("own");               // ошибка

Для getDeclaredMethod вызов inherited завершается NoSuchMethodException, потому что метод объявлен в Parent. Для getMethod вызов inherited успешен, а own не найден из-за его закрытого доступа.

Если нужно получить унаследованный непубличный метод, обычно приходится самостоятельно подниматься по цепочке суперклассов и вызывать getDeclaredMethod для каждого класса. Однако доступ к найденному члену дополнительно ограничивается правилами доступа Java и механизмами сильной инкапсуляции модулей.

При вызове найденного экземплярного метода через Method.invoke реализация переопределения обычно выбирается динамически относительно объекта-приёмника. Это не превращает getDeclaredMethod в средство вызова именно тела метода, объявленного в найденном классе.

Ситуация из практики

В сериализаторе нужно найти публичный геттер объекта. Разработчик применяет getDeclaredMethod к классу-наследнику и получает ошибку, хотя геттер унаследован от базового класса.

Возможны два решения. Первое — пройти по всем суперклассам вручную: это позволяет учитывать непубличные методы, но усложняет код, требует собственной логики доступа и может конфликтовать с модульными ограничениями. Второе — использовать getMethod, если сериализатор работает только с публичным API.

Выбран второй вариант, потому что сериализация публичных свойств не должна зависеть от внутренней реализации классов. В результате унаследованные публичные геттеры находятся предсказуемо, а закрытые детали класса не становятся частью контракта фреймворка.

Что кандидаты часто упускают

Вопрос: Находит ли getDeclaredMethod метод, унаследованный от суперкласса?

Ответ: Нет. Он рассматривает только методы, объявленные непосредственно в указанном классе. Чтобы найти унаследованный метод этим способом, нужно отдельно повторить поиск в суперклассе и далее по цепочке наследования.
Вопрос: Найдёт ли getMethod защищённый или пакетный метод, объявленный в самом классе?

Ответ: Нет. getMethod ищет только публичные методы. Для непубличного метода нужен getDeclaredMethod, после чего всё равно может потребоваться проверка возможности доступа к нему.
Вопрос: Означает ли получение Method через базовый класс, что при вызове всегда выполнится тело базового класса?

Ответ: Нет. Для экземплярного переопределяемого метода выбор реализации остаётся динамическим и зависит от фактического объекта-приёмника. Рефлексия определяет найденное объявление и проверяет совместимость вызова, но не является аналогом вызова через super и не отменяет полиморфизм.