-
概述
1. jdk 5.0 新增的功能
2.Annotation 其实就是代码里的特殊标记, 这些标记可以在编译, 类加载, 运行时被读取, 并执行相应的处理。通过使用 Annotation,程序员可以在不改变原有逻辑的情况下, 在源文件中嵌入一些补充信息。
3.在JavaSE中,注解的使用目的比较简单,例如标记过时的功能,忽略警告等。在JavaEE/Android中注解占据了更重要的角色,例如用来配置应用程序的任何切面,代替JavaEE旧版中所遗留的繁冗代码和XML配置等。
-
Annocation的使用示例
示例一:生成文档相关的注解
@author
标明开发该类模块的作者,多个作者之间使用
,
分割
@version
标明该类模块的版本
@see
参考转向,也就是相关主题
@since
从哪个版本开始增加的
@param
对方法中某参数的说明,如果没有参数就不能写
@return
对方法返回值的说明,如果方法的返回值类型是
void
就不能写
@exception
对方法可能抛出的异常进行说明 ,如果方法没有用
throws
显式抛出的异常就不能写
其中
@param @return
和
@exception
这三个标记都是只用于方法的。
@param
的格式要求:
@param