Spring自定义注解简化@ApiResponse：如何实现复杂属性转换？

一、能否实现处理器填充content属性？ #

可以实现，但Spring的@AliasFor仅支持简单属性的别名映射，不直接支持嵌套属性的自动转换。要完成自定义注解到@ApiResponse的完整转换，需要自行编写注解处理器，或借助Spring的注解元数据解析机制手动生成嵌套属性。

可行实现思路： #

• 自定义注解元数据解析：通过Spring的AnnotationMetadata或AnnotatedElementUtils获取@MyApiResponse的属性值，手动构建@ApiResponse包含的嵌套@Content和@Schema结构。
• 适配Swagger解析逻辑：如果用于生成Swagger接口文档，可扩展Swagger的注解处理器，在解析接口方法时，将@MyApiResponse转换为对应的ApiResponse对象。

二、处理@AliasFor的核心类 #

Spring中负责解析@AliasFor的核心工具类是org.springframework.core.annotation.AnnotatedElementUtils，它提供了getMergedAnnotation()等方法，可获取合并了别名属性的注解实例。内部处理别名的后置处理器是AliasForAnnotationPostProcessor，但日常开发中直接使用AnnotatedElementUtils即可满足需求。

三、示例实现（基于Spring注解解析） #

以下是手动解析@MyApiResponse并生成ApiResponse实例的代码示例：

import org.springframework.core.annotation.AnnotatedElementUtils;
import io.swagger.v3.oas.annotations.responses.ApiResponse;
import io.swagger.v3.oas.annotations.media.Content;
import io.swagger.v3.oas.annotations.media.Schema;
import java.lang.reflect.Method;

public class MyApiResponseProcessor {
    public static ApiResponse convert(MyApiResponse myAnnotation) {
        // 获取注解属性
        String description = myAnnotation.description();
        Class<?> type = myAnnotation.type();
        
        // 构建嵌套的Schema
        Schema schema = new Schema() {
            @Override
            public Class<?> contains() {
                return type;
            }
        };
        
        // 构建嵌套的Content
        Content content = new Content() {
            @Override
            public String mediaType() {
                return "application/json";
            }
            
            @Override
            public Schema[] schema() {
                return new Schema[]{schema};
            }
        };
        
        // 构建完整的ApiResponse
        return new ApiResponse() {
            @Override
            public String description() {
                return description;
            }
            
            @Override
            public String responseCode() {
                return "200";
            }
            
            @Override
            public Content[] content() {
                return new Content[]{content};
            }
        };
    }
    
    // 从目标方法中提取并转换注解
    public static ApiResponse fromMethod(Method method) {
        MyApiResponse myAnnotation = AnnotatedElementUtils.findMergedAnnotation(method, MyApiResponse.class);
        return myAnnotation != null ? convert(myAnnotation) : null;
    }
}

如果是集成Swagger生成接口文档，可通过实现OperationCustomizer扩展逻辑，在自定义器中将@MyApiResponse转换为Swagger的ApiResponse对象，添加到接口的响应定义中。

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