swagger-core

swagger-core copied to clipboard

I am experiencing an issue while trying to add a Custom ModelResolver to the Model Resolving Process. As described in https://github.com/swagger-api/swagger-core/wiki/Swagger-2.X---Extensions#extending-core-resolver I extend the ModelResolver Class and override the "resolveDescription"...

alaturoz

The example value of the request body in swagger has a "string" value

1

The example value of the request body in swagger has a "string" value. looks like https://private-user-images.githubusercontent.com/78956054/253351022-15d7b5a8-1068-405c-b997-bccb3a8e4aa0.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NDExNTc3ODksIm5iZiI6MTc0MTE1NzQ4OSwicGF0aCI6Ii83ODk1NjA1NC8yNTMzNTEwMjItMTVkN2I1YTgtMTA2OC00MDVjLWI5OTctYmNjYjNhOGU0YWEwLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNTAzMDUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjUwMzA1VDA2NTEyOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTcxYjMzN2U0OTFiZWQxZjVjNzM1NzlhMjA1ZDZmY2U3Mjg4N2NiNGY0ZjJiM2VlNGZmMmE1MjNlNDAwNDE0MTUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.sAR2C33d1St_mqW4E46-0Vci6HDVaIQs6mIudessriw For some controllers, the Example value is correct, these controllers are at the top...

ignat233

Override description for items in array schema

6

I'm using OpenAPI 3.1. I have the following classes: ```java class Street { @ArraySchema(schema = @Schema(implementation = House.class, description = "A house in a street")) public List houses; } @Schema(description...

jochenberger

Description for array schema is being ignored when generating OpenAPI 3.1

2

I have the following Java code: ```java class Street { @ArraySchema(schema = @Schema(implementation = House.class, description = "A house in the street"), arraySchema = @Schema(description = "The houses in the...

jochenberger

https://github.com/swagger-api/swagger-core/blame/f728c95fd8d6d9153cdcc18043a15bd6ae0612e3/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Schema.java#L1211 For documentation readability it would be very convenient if the `required` properties of schema are the same of the order of properties in the schema itself. Unfortunately this is...

marceloverdijk

ModelResolver#resolve ignores TYPE_USE annotations on property types

3

We're using the [JSpecify](https://jspecify.dev/) annotations (which will become the [default nullability annotations](https://github.com/spring-projects/spring-framework/issues/28797) in Spring Framework 7) and we encountered an issue with Swagger-core capabilities. These nullability annotations are **properly** targeting...

olsavmic

We are using the following to define our own custom validation annotations in a spring boot project. ### Validation annotation ```Java @Min(0) @Max(999) @Target({ElementType.FIELD, ElementType.PARAMETER}) @Retention(RetentionPolicy.RUNTIME) @Constraint(validatedBy = {}) public...

RafTacker

I have two classes that implement the same operation defined with Swagger annotations in a Java interface. I define two tags using the @Operation annotation. The problem is that the...

anadal-fundaciobit

Bill of material

2

I propose to release Bill of Material, together with other artifacts. I use springdoc, which depends on 3 artifacts: ``` io.swagger.core.v3:swagger-core-jakarta io.swagger.core.v3:swagger-annotations-jakarta io.swagger.core.v3:swagger-models-jakarta ``` Unfortunately, third party poor designed libraries...

michaldo

@ApiResponse cannot infer parametrised type with Java Generics

4

I have the following code snippet ``` public class ApiStandardResponse { T data; } ``` and use that to annotate my endpoint ``` @Operation( ... responses = { @ApiResponse( responseCode...

kliarist