String with format byte (base64) is being an array of strings and not a string

[weesftw]

When I'm creating an object and it has an attribute of type String with the format: byte (base64), the documentation view (UI) converts this type to an array of strings and not just a string...

• spring-boot version 2.6.4
• Using springdoc-openapi-ui version 1.6.6

Source code for example and swagger.yaml.

[bnasslahsen]

@weesftw,

This is related to swagger-core enhancement. swagger-api/swagger-core#3944
And there is a related PR: swagger-api/swagger-core#3955

Once fixed, we can integrate it.
This the syntax to get your expected result.
And make sure you remove @Schema from the getter.

    @Schema(name = "message",  required = true, type = "string", format = "binary")
    @JsonProperty("message")
    @lombok.Builder.Default
    @NotNull
    private byte[] message = null;

[spulci]

@weesftw,

This is related to swagger-core enhancement. swagger-api/swagger-core#3944 And there is a related PR: swagger-api/swagger-core#3955

Once fixed, we can integrate it. This the syntax to get your expected result. And make sure you remove @Schema from the getter.

    @Schema(name = "message",  required = true, type = "string", format = "binary")
    @JsonProperty("message")
    @lombok.Builder.Default
    @NotNull
    private byte[] message = null;

PR has changed:

swagger-api/swagger-core#4659

it has been merged on their main branch a month ago. It has not been released yet! Hopefully they will release it soon

Thanks

Simone

[spulci]

A new version of Swagger Core has been released with the above bug FIXED.

https://github.com/swagger-api/swagger-core/releases/tag/v2.2.22

@bnasslahsen have you got an idea of the release date of Spring Doc based on this new swagger-core version?