注解
文章目录 注解 注解定义 文档注释 在编译时进行格式检查(基本注解) 事务注解(后续更新)
注解定义
从 JDK 5.0 开始, Java 增加了对元数据(MetaData) 的支持, 也就是Annotation(注解) 。 java注解 (Annotation ),又称java标注 ,也被称为元数据 (关于数据的数据,描述数据的数据),可用于修饰或者解释包、类、方法、属性、构造器,局部变量等数据信息 。 Annotation 其实就是代码里的特殊标记, 这些标记可以在编译, 类加载, 运行时被读取, 并执行相应的处理。通过使用 Annotation, 程序员可以在不改变原有逻辑的情况下, 在源文件中嵌入一些补充信息。代码分析工具、开发工具和部署工具可以通过这些补充信息进行验证或者进行部署。 Annotation 可以像修饰符一样被使用, 可用于修饰包,类, 构造器, 方法, 成员变量, 参数, 局部变量的声明, 这些信息被保存在 Annotation 的 “name=value” 对中。 在一定程度上我们可以理解为:框架:注解 + 反射 + 设计模式。 (SpringBoot) 使用 Annotation 时要在其前面增加 @ 符号, 并把该 Annotation 当成一个修饰符使用。用于修饰它支持的程序元素。
文档注释
@author 标明开发该类模块的作者,多个作者之间使用,分割。 @version 标明该类模块的版本。 @see 参考转向,也就是相关主题。 @since 从哪个版本开始增加的。 @param 对方法中某参数的说明,如果没有参数就不能写。 @return 对方法返回值的说明,如果方法的返回值类型是void就不能写。 @exception 对方法可能抛出的异常进行说明 ,如果方法没有用throws显式抛出的异常就不能写。 其中,@param,@return 和 @exception 这三个标记都是只用于方法的。 @param的格式要求:@param 形参名 形参类型 形参说明。 @return 的格式要求:@return 返回值类型 返回值说明。 @exception的格式要求:@exception 异常类型 异常说明 @param和@exception可以并列多个。
在编译时进行格式检查(基本注解)
@Override: 限定重写父类方法, 该注解只能用于方法。 @Deprecated: 用于表示所修饰的元素(类, 方法等)已过时。通常是因为 所修饰的结构危险或存在更好的选择 @SuppressWarnings: 抑制编译器警告。
class checkAnnotation{ public static void main ( String [ ] args) { @SuppressWarnings ( "unused" ) int a = 10 ; } @Deprecated public void print ( ) { System . out. println ( "过时的方法" ) ; } @Override public String toString ( ) { return "" ; }
}
事务注解(后续更新)