New configuration property mp.openapi.extensions.smallrye.merge-schema-examples = false does not always work

[dhoffer]

If I set mp.openapi.extensions.smallrye.merge-schema-examples = false I get some strange results.

With this as my Pojo

@JsonView(Views.Abridged.class)
@Schema(description = "An array of date-time in ISO8601 UTC format with millisecond precision.", example = "[\"2021-10-25T16:00:00.234Z\", \"2021-10-26T16:00:00.234Z\"]")
private List<LocalDateTime> rcvyTime;

I get this generated OpenAPI.

"rcvyTime": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "date-time",
              "examples": [
                "2022-03-10T12:15:50"
              ]
            },
            "description": "An array of date-time in ISO8601 UTC format with millisecond precision.",
            "example": [
              "2021-10-25T16:00:00.234Z",
              "2021-10-26T16:00:00.234Z"
            ]
          }

Where did this come from? It should not exist.

 "examples": [
                "2022-03-10T12:15:50"
              ]

And that appears to be a default value as all arrays that do this have the same value.

Note I am using 4.0.6-SNAPSHOT

[MikeEdgar]

That's the default example for date-time strings:

smallrye-open-api/core/src/main/java/io/smallrye/openapi/runtime/util/TypeUtil.java

Lines 82 to 84 in 1f49df8

	private static final TypeWithFormat LOCAL_DATE_TIME_FORMAT = TypeWithFormat.of(SchemaType.STRING)
	.format(DataFormat.DATE_TIME)
	.example("2022-03-10T12:15:50").build();

You should be able to suppress it by overriding the schema for LocalDateTime:

mp.openapi.schema.java.time.LocalDateTime={ "type": "string", "format": "date-time" }

[dhoffer]

So, in yaml would that be this? It did not work.

mp: openapi: schema: java: time: LocalDateTime: type: "string" format: "date-time"

[MikeEdgar]

Try this. The value should be a string.

mp:
  openapi:
    schema:
      java:
        time:
          LocalDateTime: '{ "type": "string", "format": "date-time" }'

[dhoffer]

Yes that does work, thank you.

[MikeEdgar]

Closing this one as there is a way to suppress the built-in examples. Although related, it's this one is not due to the mp.openapi.extensions.smallrye.merge-schema-examples property.