1 常用Java注释标签(Java comment tags)
@author 作者
@param 输入参数的名称 说明
@return 输出参数说明
@since JDK版本
@version 版本号
@see 链接目标
@throws 异常
@deprecated 解释
@link 链接地址
2 Java注释的使用顺序
3 简单常见的HTML嵌入
4 HTML嵌入注释范例
5 参考文档
1 常用Java注释标签(Java comment tags)
适用范围：文件、类、方法
([email protected]，java doc中显示按输入时间顺序罗列。)
例：* @author Leo. Yao
@param输入参数的名称 说明
适用范围：方法
例：* @param str the String用来存放输出信息。
@Param：用来在DAO层中声明参数，如：List selectByUserIdAndOffset(@Param("userId") int userId, @Param("offset") int offset, @Param("limit") int limit);
[email protected]，如果使用 #{} 或 ${} 的方式都可以。
@Select("select entity from table where userId = ${userId} ") public int selectEntity(@Param("userId") int userId);
如果使用 ${} 的方式，会报错：
而#{}拿到值之后，拼装sql，会自动对值添加引号${}则把拿到的值直接拼装进sql，如果需要加单引号，必须手动添加，一般用于动态传入表名或字段名使用，#{}传参能防止sql注入
适用范围：方法
例： * @return true执行成功;
* false执行失败.
用于标识编译该文件所需要的JDK环境。
适用范围：文件、类
例： * @since JDK1.6
用于标识注释对象的版本号
适用范围：文件、类、方法
例： * @version 1.0
@see链接目标
表示参考。会在java 文档中生成一个超链接，[email protected]��径，对我这种懒人比较喜欢，[email protected] }这种既要加大括号，有需要包路径，我还是选择偷懒，当然你要是不介意使用import导入要link的类，[email protected]，所以总体来说，[email protected]，当然两个在特殊场合下还是用法不一样的
用法：
@see #field
@see #Constructor(Type, Type...)
@see #Constructor(Type id, Type id...)
@see #method(Type, Type,...)
@see #method(Type id, Type, id...)
@see Class
@see Class#field
@see Class#Constructor(Type, Type...)
@see Class#Constructor(Type id, Type id)
@see Class#method(Type, Type,...)
@see Class#method(Type id, Type id,...)
@see package.Class
@see package.Class#field
@see package.Class#Constructor(Type, Type...)
@see package.Class#Constructor(Type id, Type id)
@see package.Class#method(Type, Type,...)
@see package.Class#method(Type id, Type, id)
@see package
标识出方法可能抛出的异常
适用范围：方法
例： * @throws IOException If an input or output exception occurred
标识对象过期
适用范围：文件、类、方法
例：
/**
* @deprecated As of JDK 1.1, replaced by
* [email protected] #setBounds(int,int,int,int)}
*/
2 Java注释的使用顺序
* @author (classes and interfaces only, required)
* @version (classes and interfaces only, required. See footnote 1)
* @param (methods and constructors only)
* @return (methods only)
* @exception (@throws is a synonym added in Javadoc 1.2)
* @see
* @since
* @serial (or @serialField or @serialData)
* @deprecated (see How and When To Deprecate APIs)
3简单常见的HTML嵌入用于分段
标签用于表示计算机源代码或者其他机器可以阅读的文本内容。 标签就是为软件代码的编写者设计的。包含在该标签内的文本将用等宽、类似电传打字机样式的字体(Courier)显示出来只应该在表示计算机程序源代码或者其他机器可以阅读的文本内容上使用 标签。虽然 标签通常只是把文本变成等宽字体，但它暗示着这段文本是源程序代码。将来的浏览器有可能会加入其他显示效果。例如，程序员的浏览器可能会寻找 片段，并执行某些额外的文本格式化处理，如循环和条件判断语句的特殊缩进等。
