html注释大神,为什么在注释前面加@param？

如图：

为什么在注释前面加@param，有没有能细说一下的大神？

回答

这是jsdoc之类的文档语法，可以自动生成相应文档。在一些工具中也会自动提示。

它一般用于函数声明注释。

这是 JSDoc 注释，@param说明后面的 sheet 是一个参数，参见 JSDoc:@param。

注明参数之后 IDE 可以在调用函数的时候智能地提示所需参数，参数还可以标注类型和参数说明，给 IDE 更多更准确的提示信息。

@param 是用于标注参数的，参数名、参数类型、参数说明

官方介绍：如果你的映射方法接受多个参数，就可以使用这个注解自定义每个参数的名字。否则在默认情况下，除RowBounds以外的参数会以 "param" 加参数位置被命名。例如 #{param1}, #{param2}。如果使用了 @Param("person")，参数就会被命名为 #{person}。(你可以传递多个参数给一个映射器方法。在多个参数的情况下，默认它们将会以 param 加上它们在参数列表中的位置来命名，比如：#{param1}、#{param2}等。如果你想(在有多个参数时)自定义参数的名称，那么你可以在参数上使用 @Param("paramName") 注解)。

翻译：@Param(该注解属于MyBatis)作为Dao层的注解，作用是用于传递参数，从而可以与SQL中的的字段名相对应，一般在2=

使用方式：

传递参数是指：mapper接口中方法定义的参数 与 mapper.xml(SQL语句)中SQL语句中的参数进行传递(匹配)的过程。

1.传递单个参数时，不需要使用@Param，因为传进去一个值，也只有一个参数与之匹配(当然也可以用@Param)。

2.传递多个参数时，使用@Param可以进行参数的绑定(当然也可以不用，可以封装JavaBean或者使用Map传值)