Данный проект представляет собой интеграцию Spring-Boot и Swagger, где Swagger является эффективным и удобным встроенным плагином для документации. Внедрение этого проекта позволяет упростить процесс публикации API, ускорить модификацию и публикацию, а также повысить эффективность коммуникации в команде.

Особенности проекта:

1. Реализация Swagger через конфигурацию Spring-Boot обеспечивает идеальную и полную поддержку конфигурационных параметров Swagger-Spring.
2. Конфигурация проста и удобна в использовании.
3. Поддерживается конфигурация API по группам с использованием регулярных выражений.
4. Существует поддержка конфигурации для различных сред, что позволяет легко просматривать документацию API в разных окружениях (разработка, тестирование, предвыпускное и т. д.), исключая производственную среду.

Для быстрого старта рекомендуется обратиться к указанному ресурсу.

Проект будет синхронизироваться с открытыми ресурсами Китая и GitHub, приглашая всех к использованию и предлагая вносить свои идеи и предложения.

Также в проекте предусмотрена возможность генерации клиентского кода.

В качестве рекомендации предлагается рассмотреть использование Dubbo для распределённых систем и RPC-фреймворков, отмечая этот проект как оптимальный вход в мир Dubbo.

История обновлений:

• 1.1.2 — выпущено 17 июня 2019 года. Обновления включают повышение версии Spring-Boot до 2.1.5 и версии Swagger до 2.9.2.
• 1.1.0 — выпущено 11 апреля 2018 года. Включает обновление версии Spring-Boot до 2.0.1.
• 1.0.4 — выпущено 4 марта 2018 года. Содержит оптимизацию кода и обновление версии Spring-Boot до 1.5.10, а также обновление зависимости от Swagger до версии 2.8.0.
• 1.0.3 — выпущено 25 октября 2017 года. Включает понижение зависимости от JDK до версии 1.7 и обновление версии Spring-Boot до 1.5.8.
• 1.0.2 — выпущено 15 октября 2017 года. Внесены изменения в конфигурацию spring.swagger-group на spring.swagger.group и добавлен параметр spring.swagger.enabled для отображения включённой конфигурации Swagger.
• 1.0.1 — выпущено 17 сентября 2017 года. Исправлены ошибки, обнаруженные в версии 1.0.0.
• 1.0.0 — выпущено 16 сентября 2017 года. Завершена базовая функциональность.

Пример проекта:

1. Клонируйте пример кода с помощью команды git clone git@gitee.com:lei0719/spring-boot-starter-swagger-example.git.
2. Запустите сервис, перейдя в каталог примера кода и выполнив команду mvn spring-boot:run -Dspring.profiles.active=dev -Dserver.port=8080.
3. Просмотрите документацию, посетив адрес http://127.0.0.1:8080/swagger-ui.html.

Доступны различные конфигурационные параметры, которые можно настроить в файле YAML.