Описание тега spring-restdocs

Вопросы с тегом
Spring REST Docs использует тестовый подход к документированию RESTful API. Он использует Spring MVC Test, Spring WebFlux's WebTestClient или REST Assured для создания точных, протестированных фрагментов документации, которые затем могут быть включены в документацию, написанную на Asciidoctor или Markdown. Используйте этот тег, чтобы задать вопросы о Spring REST Docs и его взаимодействии с одной из тестовых платформ и языков разметки.
1 ответ

Генерация клиента Swagger с помощью Spring REST Docs

Я видел эту весну REST Docs - видео Мы делаем загрузочные проекты Spring и используем библиотеку springfox для генерации документации Swagger-ui и swagger, как описано здесь Нам нравится то, что документы Spring Rest могут сделать для создания докум…
15 мар '17 в 15:38
1 ответ

Spring Rest Doc - URL сгенерированной документации

Я использую Spring Rest Doc, и я вижу, что мои.adoc файлы генерируются правильно по пути, который я указал внутри public JUnitRestDocumentation restDocumentation = new JUnitRestDocumentation("target/generated-snippets"); Теперь я хотел бы видеть это…
27 июл '17 в 12:41
1 ответ

RestAPI.exchange для возврата JSON

В нашем приложении мы делаем вызов ниже и получаем ответ в виде строки. Позже мы манипулируем строкой в ​​JSON и конвертируем JSON в HashMap. (мы получили очень большой кусок ответа JSON и Преобразование строки в JSON и JSON в HashMap. Это действие …
14 июн '16 в 13:56
1 ответ

Расширения Spring Asciidoctor не в правильном репо?

Добрый день, ребята, Я пытался заставить Spring-asciidoctor-extensions работать с моей документацией, но по какой-то причине maven не может найти зависимость. Ошибка, которую я получил после попытки сборки: Failed to execute goal org.asciidoctor:asc…
29 авг '17 в 19:34
1 ответ

restdocs SnippetException из-за элементов HAL "_links" из spring-data-rest

Мое приложение использует spring-data-rest а также spring-restdocs, Моя установка действительно стандартная; почти полностью скопированы из документации, но я включил приведенные ниже примеры на случай, если что-то упущу. Когда мой тест mvc выполняе…
12 дек '16 в 18:51
1 ответ

Тест Spring MockMvc: исключение нулевого указателя

Я следую учебным пособиям по интеграции документов Spring в свой проект, но при запуске теста я сталкиваюсь с nullpointerexception. Ошибки исчезают, когда я вынимаю все биты документа. Поэтому, когда я удаляю переменную restDocumentation, бит докуме…
26 авг '16 в 10:39
0 ответов

Создание заглушек с использованием документов REST, не работающих с multipart/form-data

Я хотел бы автоматически генерировать заглушки WireMock с помощью REST Docs. Я хочу соответствовать multipart/form-data запрос более точно с помощью WireMockRestDocs.verify()но я всегда получаю исключение [wiremock did not match request], В моем API…
29 ноя '18 в 09:10
1 ответ

Spring REST Docs генерирует пустой индексный файл

Я новичок в Spring REST Docs и использую последнюю версию 1.2.1. У меня есть рабочие контроллеры RESTful, и у меня есть куча рабочих тестов. Теперь я представляю аспект документации, чтобы документально оформить их для новых разработчиков. У меня po…
16 авг '17 в 18:17
1 ответ

Невозможно создать документы Spring Rest с помощью Gradle. Хотя работает с Maven

Мне нужна помощь в создании остальных документов с помощью Gradle. Maven работает, но не Gradle. У меня есть простой проект, чтобы помочь с решением -> https://github.com/tekpartner/learn-rest-docs Когда я бегу, используя Maven mvn clean package Я в…
12 дек '17 в 06:47
0 ответов

Spring-auto-restdocs имеет поля ответа, ссылающиеся на объекты, а не на их выравнивание

В настоящее время при использовании Spring Auto REST Docs для генерации полей ответов все объекты распределяются в ответ. Например, рассмотрим эти два класса: public class Foo { private Bar bar; /** Returns the bar. */ public Bar getBar() { return b…
09 июл '18 в 14:06
1 ответ

Исключение документации pathParameters (шаблон urlTemplate не найден)

Когда используешь pathParameters документировать параметры пути URI, как показано ниже @Test public void documentGetRouteById() throws Exception { this.mockMvc.perform(get("/route/{id}", "FooBar")).andExpect(status().isOk()) .andDo(document("api-get…
01 окт '15 в 13:38
1 ответ

Как сделать параметр запроса необязательным в Spring REST Docs

Я знаю fieldWithPath() имеет optional() но не нашел как сделать parameterWithName() необязательный.
01 ноя '15 в 00:16
1 ответ

Может ли Spring Restdocs генерировать живую документацию, как чванство?

Как разработчик, я предпочитаю весенние restdocs. Но, как потребитель документации, я считаю, что живая документация чванства очень привлекательна. Вот вездесущий пример: http://petstore.swagger.io/ Есть ли способ документировать мой apis по отдыху …
22 апр '16 в 16:26
2 ответа

Автоматическая генерация документации REST API в RAML из контроллеров Spring MVC

Я новичок в Spring-Boot. Я хочу автоматически сгенерировать документацию по REST API в RAML с моих контроллеров Spring MVC. Есть что-нибудь для этого? или какое-либо руководство, что я мог бы использовать его для создания моего API для отдыха в RAML?
08 сен '18 в 16:02
1 ответ

Повторное использование атрибутов Spring Boot ErrorAttributes при использовании документов MockMvc и Spring REST

Я пишу тесты для контроллера, который выдает пользовательское исключение (AuthenticationException в моем случае), который аннотируется @ResponseStatus(value = HttpStatus.BAD_REQUEST) Вызов конечной точки, которая выдает исключение, с помощью ie curl…
07 май '17 в 20:16
1 ответ

RestAssuredRestDocumentationConfigurer, вызывающий исключение NullPointerException

Я использую Spring Boot и Rest Docs + Rest Assured для тестирования моего API. Вот мой пом <properties> <spring-restdocs.version>1.2.2.RELEASE</spring-restdocs.version> </properties> <dependency> <groupId>org.spri…
28 ноя '17 в 17:10
1 ответ

Генерируйте документ с асцидоктором с документами по весеннему отдыху, используя Maven (не Gradle)

С Gradle для создания документации asciidoctor вам нужно gradle asciidoctor в командной строке и документация генерируется этой задачей. С Maven я могу генерировать документацию asciidoctor с mvn package, Но это упаковывает весь проект. Есть ли спос…
13 авг '17 в 07:55
1 ответ

Restdoc генерирует org.springframework.restdocs.snippet.SnippetException при попытке документировать дочерние объекты

У меня есть класс OrderInfo: @ApiModel(description = "object needed to make an order") public class OrderInfo implements Serializable { private static final long serialVersionUID = 1L; @JsonProperty("purchase") private PurchaseInfo purchase = null; …
25 фев '19 в 16:39
1 ответ

Конечные точки входящего шлюза http в Document Spring Integration

В рамках своей деятельности по разработке, включающей создание REST API с использованием Spring Integration, я пытаюсь изучить возможность документирования API. После чтения в Интернете у меня возникла пара вопросов: 1) Можно ли использовать модуль …
12 фев '19 в 20:59
0 ответов

Конечная точка прослушивания печати, которой управляет Mockito

Я хочу создать тест JUnit для Rest api и сгенерировать api doc. Я хочу проверить этот код: Контроллер отдыха @RestController @RequestMapping("/transactions") public class PaymentTransactionsController { @Autowired private PaymentTransactionRepositor…
23 дек '18 в 21:03