Описание тега swagger-maven-plugin

Плагин сборки maven, который позволяет создавать документы Swagger JSON и API.
0 ответов

Проблема генерации клиентских классов с кодексом Swagger

Я пытаюсь создать клиентские классы Api с swagger-codegen-maven-plugin, Я получаю следующее исключение: org.springframework.beans.factory.BeanDefinitionStoreException: Failed to process import candidates for configuration class [org.springframework.…
1 ответ

Как заставить Jaxrs-Analyzer генерировать документацию JSON Swagger 2 определения?

Когда я использую Jaxrs-Analyzer Version 0.9, он генерирует swagger 1.2 JSON Docs. Как я могу настроить jaxrs-analyzer чтобы убедиться, что он генерирует swagger 2 JSON определения? <plugin> <groupId>com.sebastian-daschner</groupId&gt…
18 май '16 в 05:54
0 ответов

В сгенерированном файле Swagger отсутствует содержимое ApiOperation. Плагин не анализирует содержимое Api по неизвестной причине.

Я хочу использовать плагин swagger и maven для генерации документации в json-from из моего спокойного приложения. Файл json создан, но отсутствуют данные из API со всеми описаниями моего кода. Это мой pom.xml <project xmlns="http://maven.apache.o…
11 сен '18 в 10:10
1 ответ

Swagger maven build - проблема NTLM при загрузке swagger-ui/archive/master.tar.gz

Я пытаюсь заполучить Swagger и попытался загрузить и запустить несколько образцов на моей машине, наткнулся на следующую ошибку и не смог продолжить. Любая помощь будет принята с благодарностью. Я клонировал GIT-код с https://github.com/swagger-api/…
19 июн '15 в 07:08
0 ответов

Форс-Maven-плагин. Я не могу найти swagger.json на mvn compile

Я не знаю, что я делаю не так. Ранее мы использовали swagger-core в нашем проекте JAX-RS на Джерси для генерации swagger.json. Это повлияло на нашу производительность, и затем мы нашли swagger-maven-plugin, который генерирует swagger.json только во …
02 апр '18 в 02:29
1 ответ

Порядок свойств в определениях чванства меняется от прогона к прогону

Я использую swagger-maven-plugin генерировать swagger.json. Однако я заметил, что порядок свойств меняется от запуска к запуску. Например, это может быть: { ... "definitions" : { "MyClass1" : { "type" : "object", "properties" : { "name" : { "type" :…
13 авг '18 в 15:53
2 ответа

Включение Spring Security делает текст Swagger выводимым / простым вместо HTML

Swagger работает! Я могу взаимодействовать с http://localhost:8090/sdoc.jsp и все в порядке. Я добавляю следующее в pom.xml... <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-security&…
3 ответа

Использование Javadocs для создания документа Swagger

Я хочу создать документацию Swagger для существующего набора API RESTful. У меня есть следующее требование: Генерация Swagger Doc в автономном режиме (я использовал http://kongchen.github.io/swagger-maven-plugin/). Этот плагин помогает мне генериров…
01 сен '15 в 20:54
1 ответ

swagger-maven-plugin не генерирует элементы paths для сопоставлений отдельных запросов

У меня есть простая конечная точка, которую я хотел бы обработать с помощью swagger-maven-plugin. Получающийся файл swagger.conf не отражает правильные "пути:" для отдельных @ApiOperations. Корень api - "/api", и я хочу добавить конечные точки для G…
11 апр '16 в 18:34
0 ответов

Плагин Maven, который генерирует OpenAPI3 JSON из аннотаций Swagger 2

Проект использует аннотации из Swagger 2, из этого пакета: <dependency> <groupId>io.swagger</groupId> <artifactId>swagger-annotations</artifactId> <version>1.5.13</version> </dependency> И тогда это дл…
2 ответа

Оффлайн-документация с использованием плагина maven

Я пытаюсь создать документацию swagger, для этого мне нужно запустить сервер. Я хочу генерировать документацию swagger в автономном режиме (без запуска сервера), я только что получил эту ссылку https://github.com/garethjevans/swagger-codegen-maven-p…
04 июн '15 в 09:26
0 ответов

Swagger не смог отсканировать динамическую природу создания url Джерси

Я работал над проектом, который использует следующий технический стек на своем сервере: Spring-Core (не MVC) Jax-RS (Джерси 1.19) Для документирования API нам посоветовали использовать Swagger2. Следуя одной из предыдущих версий документации, я смог…
1 ответ

Автоматическая генерация остальных конечных точек с использованием Swagger для Java

Передо мной была поставлена ​​задача найти лучший способ для большого API, разработанного с использованием jaxrs, документировать для третьих лиц. Код в настоящее время хорошо документирован с помощью Javadoc. Мой вопрос состоит в том, чтобы помочь …
5 ответов

Spring boot & Swagger 2 UI и пользовательское отображение запросов handlermapping - проблема отображения

У меня есть собственный RequestMappingHandlerMapping, и я использую Springfox-Swagger-UI. После добавления своего пользовательского сопоставления я не могу получить пользовательский интерфейс swagger по адресу http://localhost:8080/swagger-ui.html. …
1 ответ

Создать статический API-документ

Мне нужно хранить статичные сгенерированные файлы api json в нашем git-репозитории, чтобы легко отслеживать изменения API. Подобно этому http://petstore.swagger.wordnik.com/api/api-docs/user Я подключил плагин Maven https://github.com/kongchen/swagg…
08 дек '14 в 15:25
1 ответ

Swagger includePatterns()

Конфигурация Swagger: @EnableSwagger @Configuration public class SwaggerConfig { private SpringSwaggerConfig springSwaggerConfig; @Autowired public void setSpringSwaggerConfig(SpringSwaggerConfig springSwaggerConfig) { this.springSwaggerConfig = spr…
0 ответов

Генерация только тех параметров, которые мне действительно нужны, с помощью swagger-maven-plugin в Java

Я хотел бы аннотировать свои методы запроса для плагина swagger maven, чтобы в схеме параметров запроса swagger отображались только те свойства, которые мне действительно нужны, а не все свойства класса. Например, если у меня есть личный класс с эле…
21 фев '17 в 09:31
1 ответ

Swagger 2.0.3 с Spring MVC выдает HttpMediaTypeNotAcceptableException: не удалось найти приемлемое представление

Я использую следующие зависимости Maven и плагины <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.0.3-SNAPSHOT</version> </dependency> <dependency…
0 ответов

Документация Swagger, созданная с помощью плагина, содержит неверные модели

Недавно я начал документировать свой проект с помощью Swagger и настроил его так, чтобы документация генерировалась во время сборки. Для этого я использую swagger-maven-plugin 3.1.5, а также swagger-core 1.5.16 и swagger-jaxs 1.5.16. Генерация докум…
30 июл '18 в 08:50
1 ответ

Почему swagger-maven-plugin изменил мой вывод на "application/xhtml+xml"?

Я новичок в Swagger-Maven-плагин, и я добавил его в pom.xml, Swagger.json был создан, но все мои REST API больше не работает Я обнаружил, что в заголовке ответа "тип контента" был изменен на application/xhtml+xml, и все прежние возвращенные данные j…
20 мар '17 в 10:33