@Tag annotation on Resource producer method

[gquintana]

I would like to place @Tag annotations from on a method producing a sub-resource:

@Path("/search")
public class SearchResource {

  @Path("profile1")
  @Tag(name="Profile 1 Resource")
  public SubSearchResource searchProfile1() {
    return new SubSearchResource(profile1Config);
  }

  @Path("profile2")
  @Tag(name="Profile 2 Resource")
  public SubSearchResource searchProfile2() {
    return new SubSearchResource(profile2Config);
  }

SearchResource is JAX-RS resource class containing several operations.

The generated OpenAPI contracts contains:

paths:
  /search/profile1/summary:
    get:
      tags:
      - Sub Search Resource
  /search/profile1/detail:
    get:
      tags:
      - Sub Search Resource
  /search/profile2/summary:
    get:
      tags:
      - Sub Search Resource
  /search/profile2/detail:
    get:
      tags:
      - Sub Search Resource

I expect tags to be Profile 1 Resource/Profile 2 Resource not Search Resource

@Tag annotations are OK when placed at Resource class level or at Operation method level (a method returning content).
But they are not OK when placed at Sub-resource producer method level (a method returning a sub-resource).

Is it possible to configure tags using annotations when using sub-resource producer methods?

I am using Quarkus 3.2 with quarkus-smallrye-openapi extension.

[gquintana]

Show case 5eefe45

[MikeEdgar]

@gquintana in the example you linked, is that the expected output or the actual output?

[gquintana]

It is the actual output. I would like to have:

paths:
  /search/profile1/summary:
    get:
      tags:
      - Profile 1 Resource
  /search/profile1/detail:
    get:
      tags:
      - Profile 1 Resource
  /search/profile2/summary:
    get:
      tags:
      - Profile 2 Resource
  /search/profile2/detail:
    get:
      tags:
      - Profile 2 Resource

The @Tags at the factory method level could be merge with those at sub resource class level.

See reproducer test case in above above comment.

[MikeEdgar]

See reproducer test case in above above comment.

Yeah, that's the one I mean. The JSON is the desired state? The tags there are the ones from the sub-resource producer method.

[gquintana]

In this branch, it's the expected result. I tried to fix my problem by myself but I didn't manage to go further than that.