LianjiaTech/retrofit-spring-boot-starter

Что это?

Ключевые возможности

• 01Описывайте HTTP-клиенты как Java-интерфейсы с помощью встроенных аннотаций Retrofit.
• 02Автоматическая регистрация клиентов через сканирование компонентов Spring или @RetrofitScan.
• 03Настройка таймаутов, повторов запросов и circuit breaking на уровне методов.
• 04Пользовательские конвертеры, интерцепторы и декодеры ошибок.
• 05Метрики Micrometer и эндпоинты Spring Boot Actuator.
• 06Поддержка GraalVM Native Image и AOT-сборок.

Сценарии использования

• Вызов сторонних REST API из сервиса Spring Boot с повторами запросов и таймаутами.
• Создание типизированных клиентов внутренних микросервисов в приложении Spring Boot.
• Добавление логирования, метрик и circuit breaking для исходящих HTTP-запросов без написания всей необходимой обвязки вручную.

Быстрый старт

1. 1

   Добавьте зависимость starter (retrofit-spring-boot-starter 4.2.1) в pom.xml

2. 2

   Определите интерфейс с аннотацией @RetrofitClient и HTTP-аннотациями Retrofit

3. 3

   Внедрите интерфейс в сервис Spring с помощью @Autowired и вызовите его

Что важно знать

• !Требуется JDK 17 или новее.
• !В проектах со Spring Boot 1.x и 2.x необходимо использовать отдельную ветку starter версии 2.x.

В подборках

Темы

Частые вопросы

Что такое retrofit-spring-boot-starter?

Стартер Spring Boot, который превращает HTTP-интерфейсы Retrofit в управляемые Spring бины и добавляет повторы запросов, логирование, circuit breaking и другие возможности. retrofit-spring-boot-starter позволяет описывать HTTP API обычными Java-интерфейсами с аннотацией @RetrofitClient, а затем внедрять их в Spring-сервисы, как и любые другие бины. Стартер использует встроенные аннотации Retrofit для запросов, поэтому знакомые @GET, @POST, @Query, @Body и другие работают так же, как в самом Retrofit.

retrofit-spring-boot-starter можно использовать бесплатно? Какая у него лицензия?

retrofit-spring-boot-starter распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

retrofit-spring-boot-starter всё ещё поддерживается?

Обновлялся за последние 6 месяцев. Последний коммит в retrofit-spring-boot-starter — 14 сент. 2026 г..

Для чего можно использовать retrofit-spring-boot-starter?

Вызов сторонних REST API из сервиса Spring Boot с повторами запросов и таймаутами. Создание типизированных клиентов внутренних микросервисов в приложении Spring Boot. Добавление логирования, метрик и circuit breaking для исходящих HTTP-запросов без написания всей необходимой обвязки вручную.

Как установить retrofit-spring-boot-starter?

Добавьте зависимость starter (retrofit-spring-boot-starter 4.2.1) в pom.xml Определите интерфейс с аннотацией @RetrofitClient и HTTP-аннотациями Retrofit Внедрите интерфейс в сервис Spring с помощью @Autowired и вызовите его

Где скачать retrofit-spring-boot-starter?

Исходный код и инструкции по установке — на GitHub: https://github.com/LianjiaTech/retrofit-spring-boot-starter