22 questions
0
votes
1
answer
109
views
autorest model generation fails when multipart/form-data has string enum
I am trying to generate C# models and client using openapi specification yaml
If I have a property of type enum in multipart/form-data as below :
requestBody:
required: true
...
0
votes
1
answer
156
views
How i can document inner collection constraints in spring auto restdocs
I'm trying to document inner constraint for Collections (NotBlank and Size) like:
@Valid
private List<@NotBlank @Size(min = 1, max = 100) String> someAnotherUsefulInformationList;
Can I do ...
0
votes
1
answer
545
views
Spring REST Docs + RequestBody + Prevent deep-level documentation of fields
i have problems with Spring REST Docs and preventing deep-level documentation of fields within a request body:
@Transactional
@RequestMapping(path = "/edit", method = RequestMethod.POST)
...
0
votes
0
answers
1k
views
Spring rest docs request url shows value for path parameter instead of the parameter name
I use spring rest docs to document my api.
Now I want to document my document my path in the form of
.../accounts/{userId}
but I get
.../accounts/123
The test part look as follows:
mockMvc.perform(...
0
votes
1
answer
379
views
Auto Section title level in Spring Auto Rest Docs
This is my first question on StackOverflow.
I am using Java 11, Spring Boot 2.4.0, JUnit 5, Auto Rest Docs 2.0.9.
I am getting the following warning when I am generating the document:
asciidoctor: ...
0
votes
1
answer
245
views
Spring Auto Rest Docs documents all Json subTypes
I have a Rest service with two operations /balance and /transactions to get the balance and transactions of a customer.
The return type of this operations is BalanceResponse and TransactionResponse ...
1
vote
2
answers
546
views
Customize Section title in Spring Auto Rest Docs
I want to customize Section "title" in auto-section.adoc[] file generated by Spring Auto Rest Docs. Spring Auto Rest Docs resolves section title using @title Javadoc tag on the method(if present) or ...
0
votes
1
answer
515
views
Spring REST Docs duplicates query parameter without value in curl and HTTP request snippets
I'm using Spring REST Docs (2.0.3.RELEASE) and Spring Auto Restdocs (2.0.6) to document a REST API.
When the request contains a query parameter that has no assigned value (empty string) the snippets ...
5
votes
1
answer
3k
views
jsonDoclet task: Javadoc generation failed
I am trying to setup spring-auto-restdocs in my project, which uses JDK 11, Gradle 5, JUnit5 and Spring Webflux with spring boot 2.1.1.
I've followed the normal spring-restdocs setup guide here: ...
0
votes
1
answer
275
views
No description found for classes with custom Jackson ObjectMapper
I am coming across an issue with Spring AutoRest Docs. It seems to stem from this code
.alwaysDo<DefaultMockMvcBuilder>(JacksonResultHandlers.prepareJackson(objectMapper))
Full configuration:
...
5
votes
2
answers
3k
views
Auto generate REST api documentation into RAML from Spring MVC controllers
I am new to Spring-Boot. I want to auto generate my REST api documentation into RAML from my Spring MVC controllers. Is there anything to do that? or any guide that I could use it for generating my ...
-1
votes
1
answer
1k
views
Spring Auto REST Docs - don't work properly
I use Java 8, Spring Boot 2.0, JUnit4. I try to make a proper documentation with Spring Auto REST Docs.
Here is my dto:
@Data
@NoArgsConstructor
public class ESLogRequestDTO {
/**
* Дата ...
3
votes
0
answers
296
views
Spring-auto-restdocs have response fields link to objects instead of flattening them
Currently, when using Spring Auto REST Docs to generate response fields, all objects are flattened out into the response. For example consider these two classes:
public class Foo {
private Bar ...
1
vote
1
answer
592
views
Is it possible to use spring-auto-restdocs with Swagger/SpringFox?
Is it possible to use spring-auto-restdocs with Swagger/SpringFox, swagger2markup?
I'd like to:
- Use Swagger/SpringFox to provide the test area
BUT then I want the examples in that UI to be similar ...
0
votes
0
answers
990
views
Not able to link my javadocs with spring auto rest docs
I am not getting how do you use JavaDocs, with Spring Auto Rest Docs. I can generate my java-docs locally by using STS, UI option. However,i am not sure how to generate java-docs using Spring Auto ...