OpenAPI Extension Misses Jackson Annotations on Methods that Return a Parameterized Type

[gilday]

Describe the bug

Quarkus Smallrye OpenAPI extension doesn't respect Jackson JsonProperty annotation when that annotation is added to a method that returns a parameterized type.

package org.acme;

import com.fasterxml.jackson.annotation.JsonProperty;

public interface Named<T> {
  @JsonProperty("nombre")
  T name();
}

Unexpectedly, replacing the type parameter with a concrete type resolves the issue.

Expected behavior

OpenAPI extension respects Jackson JsonProperty despite being on a method that returns a type parameter.

Actual behavior

No response

How to Reproduce?

Run the Quarkus dev server with the attached reproducer. Note the OpenAPI schema displayed by the Swagger UI.

The name property should be "nombre".

Output of uname -a or ver

Darwin MacBookPro 24.1.0 Darwin Kernel Version 24.1.0: Thu Oct 10 21:03:15 PDT 2024; root:xnu-11215.41.3~2/RELEASE_ARM64_T6000 arm64

Output of java -version

openjdk version "21.0.3" 2024-04-16 LTS OpenJDK Runtime Environment Temurin-21.0.3+9 (build 21.0.3+9-LTS) OpenJDK 64-Bit Server VM Temurin-21.0.3+9 (build 21.0.3+9-LTS, mixed mode)

Quarkus version or git rev

3.17.4

Build tool (ie. output of mvnw --version or gradlew --version)

Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937) Maven home: /Users/jgilday/.m2/wrapper/dists/apache-maven-3.9.9-bin/33b4b2b4/apache-maven-3.9.9 Java version: 21.0.3, vendor: Eclipse Adoptium, runtime: /Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home Default locale: en_US, platform encoding: UTF-8 OS name: "mac os x", version: "15.1.1", arch: "aarch64", family: "mac"

Additional information

No response

[quarkus-bot]

/cc @EricWittmann (openapi), @MikeEdgar (openapi), @geoand (jackson), @gsmet (jackson), @mariofusco (jackson), @phillip-kruger (openapi)

[MikeEdgar]

Can you share a reproducer project? I did a simple test with a generic return type and it seems to be ok in this case.

abstract class Named<T> {
    @JsonProperty("nombre")
    public abstract T name();
}

@Schema(name = "Widget")
class Widget extends Named<String> {
    public String name() {
        return "";
    }
}

{
  "openapi" : "3.1.0",
  "components" : {
    "schemas" : {
      "Widget" : {
        "type" : "object",
        "properties" : {
          "nombre" : {
            "type" : "string"
          }
        }
      }
    }
  }
}

[gilday]

quarkus-openapi-schema-interface.zip

Sorry, I thought I already had attached the reproducer. It should be attached to this comment.

[MikeEdgar]

Thanks for the reproducer. It looks like it works with a class but not a record. I'll keep debugging.