如何移除JAX-RS/RESTEasy子资源方法的@PathParam参数（OpenApi场景）

针对你遇到的子资源ParentItemResource中create方法冗余@PathParam("parentIdentifier")参数的问题，有以下几种可行方案：

方案1：调整OpenAPI接口定义（推荐） #

如果ParentItemResourceDocumentation接口是为生成OpenAPI文档而定义的，可直接修改该接口，移除create方法中的parentIdentifier参数。

由于父资源ParentResource已通过@Path("/{parentIdentifier}/items")将parentIdentifier作为路径的一部分，子资源的接口文档会自动继承这个路径参数，无需在方法参数中重复声明。修改后ParentItemResource的create方法可直接去掉冗余参数：

@Override
public Response create(final @Valid CreateParentItemRequest createParentItemRequest) {
    final var result = createParentItemFunction.apply(parent, createParentItemRequest);
    return Response.ok(result).build();
}

方案2：用OpenAPI注解补充参数文档（无需修改接口） #

若无法修改ParentItemResourceDocumentation接口，可在ParentItemResource的create方法上使用OpenAPI注解直接声明路径参数，替代方法参数的作用。

以OpenAPI 3.x为例，使用@Parameter注解：

@Override
@Parameter(name = "parentIdentifier", in = ParameterIn.PATH, required = true)
public Response create(final @Valid CreateParentItemRequest createParentItemRequest) {
    final var result = createParentItemFunction.apply(parent, createParentItemRequest);
    return Response.ok(result).build();
}

这种方式既满足OpenAPI文档对路径参数的要求，又能移除冗余的方法参数，需确保你的OpenAPI生成工具支持类/方法级别的参数声明。

方案3：接口适配委托（兼容旧接口的兜底方案） #

如果必须保留接口的方法签名，可引入委托类分离接口实现与业务逻辑：

// 仅处理文档要求参数的适配类
@RequestScoped
public class ParentItemResourceAdapter implements ParentItemResourceDocumentation {
    private final ParentItemResource parentItemResource;

    public ParentItemResourceAdapter(ParentItemResource parentItemResource) {
        this.parentItemResource = parentItemResource;
    }

    @Override
    public Response create(@PathParam("parentIdentifier") UUID parentIdentifier, final @Valid CreateParentItemRequest createParentItemRequest) {
        // 忽略冗余参数，直接调用业务逻辑
        return parentItemResource.create(createParentItemRequest);
    }
}

// 修改ParentResource中子资源的获取逻辑
@Path("/{parentIdentifier}/items")
public ParentItemResourceDocumentation handleParentItems(@PathParam("parentIdentifier") UUID parentIdentifier, @Context ResourceContext resourceContext) {
    final var parent = parentResolver.resolve(parentIdentifier);
    ParentItemResource resource = resourceContext.getResource(ParentItemResource.class).setParent(parent);
    return new ParentItemResourceAdapter(resource);
}

冗余参数仅在适配层存在，业务类可保持干净的逻辑结构。

内容的提问来源于stack exchange，提问作者Nikita Prokhorov