@Param注解的用法解析

@Param注解通常在方法的参数上使用，用于说明该参数的含义和作用。该注解可以用于生成API文档，并且可以提高代码的可读性和可维护性。在Java中，常见的@Param注解有以下两种用法：

1. 使用JSR 305标准中的@ParameterName注解

@ParameterName注解可以用于指定方法参数的名称，这样可以在生成API文档时使用该名称，而不是使用默认的arg0、arg1等名称。

例如：

public void foo(@ParameterName("name") String name, @ParameterName("age") int age) {
    // do something
}

2. 自定义@Param注解

自定义@Param注解可以用于指定方法参数的含义和作用。该注解可以包含一些属性，例如value属性用于指定参数的名称，description属性用于指定参数的描述等。

例如：

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.PARAMETER)
public @interface Param {
    String value() default "";
    String description() default "";
}

public void bar(@Param(value = "name", description = "用户名") String name, @Param(value = "age", description = "年龄") int age) {
    // do something
}

使用自定义@Param注解时，需要注意注解的Retention和Target属性，以及注解的属性名和属性类型。同时，也需要在生成API文档时解析该注解，并将注解的信息添加到文档中。