swagger-core
swagger-core copied to clipboard
Examples and server integrations for generating the Swagger API Specification, which enables easy access to your REST API
https://github.com/swagger-api/swagger-core/blob/0bafd5b227b606f2819ddcf893c29c08010c207d/modules/swagger-core/src/main/java/io/swagger/v3/core/util/ParameterProcessor.java#L195 Whether [javax. Validation. Constraints] can be added to determine whether the parameter is needed, and whether the parameter needs to be changed for different methods can be distinguished by...
@Override public ObjectSchema example(Object example) { if (example != null) { super.setExample(example.toString()); } else { super.setExample(example); } return this; } you see, this method in ObjectSchema use example.toString(), so when...
Hi guys, I'm able to DRY @ApiResponses annotation like so: ``` @ApiResponses(value = { @ApiResponse( responseCode = "4XX", description = "Client Error", content = @Content(mediaType = MediaType.APPLICATION_JSON, schema = @Schema(implementation...
We have a project that implements two different OpenAPI specs and these are done in two separate resource packages. When we run the swagger-maven-plugin we want it to generate two...
When Jackson's [`@JsonValue`](http://fasterxml.github.io/jackson-annotations/javadoc/2.12/com/fasterxml/jackson/annotation/JsonValue.html) is used on a public enum method, the Swagger enum list properly uses this value (thanks to #3553). However, when it is used on an enum field...
In addition to the hard coded `Optional` reference types the type information from jackson is used to unwrap additional reference types (e.g. `AtomicReference`) Fixes #4103 for master branch (swagger 2.X)
In addition to the hard coded `Optional` reference types the type information from jackson is used to unwrap additional reference types (e.g. `AtomicReference`) Fixes #4103 for 1.5 branch (swagger 1.6.X)
I have one abstract class and three other subclass. I would like that this three subclasses showed as example on the OpenAPI UI. It's possible? The OpenApi UI show only...
It's not possible to define a reference with `@SecurityScheme` without also defining a type. ```java @SecurityScheme(ref = "another.yaml#/components/securitySchemes/blagh") //
[Pull Request 3470](https://github.com/swagger-api/swagger-core/pull/3740) added the ability to configure API spec generation to have deterministic order. From what I can tell, that change was made only on the 2.x branch. It...