Setting `type` in @Schema has no effect

[sam-hieken]

Describe the bug

The type property of @Schema has no effect for objects in the "Schemas" section of the Swagger page.

To Reproduce
Can be reproduced by cloning this repository, running mvn spring-boot:run, and navigating to http://localhost:8081/swagger-ui.html.

The UserModel class is explicitly defined as type = "integer":

public class UserModel {
	...

	/** User's age */
	@Schema(type = "integer", format = "int8")
	private byte age;
}

yet the default type (string for bytes in Java) is not overriden:

I've tested this with type = "integer" on both Java Strings and bytes, both with the same result.

Expected behavior

The integer type being applied to the field in Swagger.

Screenshots
See above

Additional context
Using SpringDocs 2.8.9 and Spring Boot 3.5.4 (see POM of linked repo reproducing issue for other version info).

[jongmin-chung]

Hi @sam-hieken

I worked on your issue (#3052) and put PR on swagger-core.

If you want to solve it before it is resolved, you can solve it in the following way.

public class UserModel {
	...

	/** User's age */
	@Schema(implementation = Integer.class, format = "int8")
	private byte age;
}

[injae-kim]

Fix PR: swagger-api/swagger-core#4954 👍 PTAL~!

[sam-hieken]

Hey @jongmin-chung, thanks for looking into this! I was under the impression this was a springdoc issue though since the generated app yaml produces type: string for the age field:

components:
  schemas:
    UserModel:
      type: object
      description: Info about the user
      properties:
        userID:
          type: string
          description: User's ID
        name:
          type: string
          description: User's name
        age:
          type: string
          format: int8
          description: User's age

Sorry to bother you if it's a swagger issue

[jongmin-chung]

@sam-hieken

Initially, I also thought this was a springdoc issue, but after digging deeper into the swagger-core codebase, I found that the problem actually originates there. Let's wait for the PR to merged! 😀

No bother at all! Actually, this was a great opportunity for me to dive deeper into the swagger-core implementation, which was quite impressive.

[bnasslahsen]

Great analysis @jongmin-chung. This is not directly related to springdoc-openapi code.
As workaround, you can use types instead of type, until swagger-core fixes the this issue.