swagger-core

swagger-core copied to clipboard

Field with first letter lower case not recognized

1

According to java spec (http://download.oracle.com/otn-pub/jcp/7224-javabeans-1.01-fr-spec-oth-JSpec/beans.101.pdf p. 57) the getter for a field like **aField** (first character in lower case and second character in upper case) is **getaField** with first letter...

Danipiario

I'm having a hard time to generate a correct Openapi documentation using `swagger-maven-plugin-jakarta`. I've created a simple springboot application just to clarify: Environment: swagger-maven-plugin-jakarta: 2.2.28 swagger-core-jakarta: 2.2.28 swagger-annotations: 2.2.28 I...

tiagofvalerio

Forbid mutliple `@ApiResponse` annotations with the same response code

1

The response code it the key in a map, e.g. ```json { "responses": { "200": { "description": "Person loaded", "content": ... }, "404": { "description": "Person not found", "content": ......

jochenberger

If a controller method is annotated with `@Deprecated`, the respective operation gets a `deprecated: true` flag. However, if for example a DTO class is annotated with `@Deprecated`, that has no...

jochenberger

@ArraySchema is ignored in model property (array of abstract class)

2

I have the following class that returns an array of abstract classes that looks like this: ``` @JsonPropertyOrder({"answers"}) @Schema(name = QuestionAnswers, description = "") public final class QuestionAnswersJson extends AbstractJson...

AlexandrosG

Empty default values (`@Schema(defaultValue = "")`) are not included into generated OpenAPI yaml file. Related code: https://github.com/swagger-api/swagger-core/blob/55ef54df305c2fee98ca58cc91c85183478a9b3a/modules/swagger-core/src/main/java/io/swagger/v3/core/util/AnnotationsUtils.java#L751 Empty values are simply ignored, but many code generation tools are rely on...

westito

Missing oneOf sections for polymorphic schema

2

Using swagger core with java structures that have multiple polymorphism use cases. ## Current state Swagger core always require to specify oneOf when discriminator mapping is present ```java @Schema( discriminatorProperty...

wtrocki

Is it possible to convert from OAS 3.0 to OAS 3.1 using this lib?

anton-okolelov

Enum values missing in OpenAPI 3.1 schema

2

I'm using 2.2.28. I have the following classes: ```java class Question { @ArraySchema(schema = @Schema(description = "The answer to the question")) public Set answer; } enum Option { A, B,...

jochenberger

Classes / enums with same name but different package replace each other

1

If your project has two or more classes (also enums) with the same name (but different packages) they replace each other during model definition. ```java public class MyClass { private...

T3rm1