1、三种基本的Annotaton
@Override : 限定某个方法，是重写父类方法 , 该注解只能用于方法
@Deprecated : 用于表示某个程序元素 ( 类 , 方法等 ) 已过时
@SuppressWarnings : 抑制编译器警告
@Override
class father{
public void fly(){}
}
class son extends father{
@Override
public void fly() {
super.fly();
}
}
解读
@Override表示son重写了fly方法
细节
- 如果没有@Override还是会重写fly方法
class father{
public void fly(){}
}
class son extends father{
public void fly() {
super.fly();
}
}
-
写了@Override注解，编译器就会去检查方法是否重写了父类方法，如果重写了，则编译通过。若没有重写，则编译错误。
-
@Override只能修饰方法，不能修饰其他类，包，属性等等
//@Override底层代码
@Target(ElementType.METHOD)//ElementType.METHOD说明@Override只能修饰方法
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}
@Deprecated
public class Deprecatedtext {
public static void main(String[] args) {
father father1 = new father();
father1.fly();
}
}
@Deprecated
class father{
@Deprecated
public void fly(){}
}
解读
@Deprecated表示某个程序元素（类，方法等）已过时，会通过单词中间的横线提醒。表示不建议使用。
效果
细节
- 可以修饰方法，类，包，参数等等
//@Deprecated底层代码
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})//说明Deprecated能修饰方法，类，包，参数等等
public @interface Deprecated {
}
- @Deprecated的作用可以起到做新旧版本的兼容过渡
@SuppressWarnings
@SuppressWarnings("all")
class father{
public void fly(){}
}
解读
@SuppressWarnings注解可以用来抑制警告信息{""}写入你希望抑制的警告信息
效果
细节
1.@SuppressWarnings作用范围和你放置的位置相关
public class Enumtext {
@SuppressWarnings("all")//作用范围在main方法
public static void main(String[] args) {
father father1 = new father();
father1.fly();
}
}
@SuppressWarnings("all")//作用范围在father类
class father{
public void fly(){}
}
-
指定警告类型有
all，抑制所有警告
boxing，抑制与封装/拆装作业相关的警告
cast，抑制与强制转型作业相关的警告
dep-ann，抑制与淘汰注释相关的警告
deprecation，抑制与淘汰的相关警告
fallthrough，抑制与switch陈述式中遗漏break相关的警告
finally，抑制与未传回finally区块相关的警告
hiding，抑制与隐藏变数的区域变数相关的警告
incomplete-switch，抑制与switch陈述式(enum case)中遗漏项目相关的警告
javadoc，抑制与javadoc相关的警告
nls，抑制与非nls字串文字相关的警告
null，抑制与空值分析相关的警告
rawtypes，抑制与使用raw类型相关的警告
resource，抑制与使用Closeable类型的资源相关的警告
restriction，抑制与使用不建议或禁止参照相关的警告
serial，抑制与可序列化的类别遗漏serialVersionUID栏位相关的警告
static-access，抑制与静态存取不正确相关的警告
static-method，抑制与可能宣告为static的方法相关的警告
super，抑制与置换方法相关但不含super呼叫的警告
synthetic-access，抑制与内部类别的存取未最佳化相关的警告
sync-override，抑制因为置换同步方法而遗漏同步化的警告
unchecked，抑制与未检查的作业相关的警告
unqualified-field-access，抑制与栏位存取不合格相关的警告
unused，抑制与未用的程式码及停用的程式码相关的警告
元注解
- Retention 指定注解的作用范围，三种SOURCE,CLASS,RUNTIME
- Target 指定注解可以在哪些地方使用
- Documented 指定该注解是否会在javadoc体现
- Inherited 子类会继承父类注解
Retention
Retention的三种值
- RetentionPolicy.SOURCE :编译器使用后，直接丢弃注释
- RetentionPolicy.CLASS: 编译器把注解记录在class文件中，当运行java时JVM不会保留注释
- RetentionPolicy.PUNTIME：编译器把注解记录在class文件中，当运行java时JVM保留注释
Retention案例
@Override底层（IDEA进入底层的快捷键为Ctrl+B）
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)//表示@Override在编译器使用后，直接丢弃注释
public @interface Override {
}
Target
Target的值
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
// 1.CONSTRUCTOR:用于描述构造器
2.FIELD:用于描述域
3.LOCAL_VARIABLE:用于描述局部变量
4.METHOD:用于描述方法
5.PACKAGE:用于描述包
6.PARAMETER:用于描述参数
7.TYPE:用于描述类、接口(包括注解类型) 或enum声明
Target案例
@Deprecated底层
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})//表示@Documented在这些地方可以写注解
public @interface Deprecated {
}
Documented
Documented案例
@Deprecated底层
@Documented//@Deprecated代码会被保存到生产的文档中
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
public @interface Deprecated {
}
Inherited
被它修饰的Annotation将具有继承性，如果某个类使用了被@Inherited修饰的Annotation,则其子类将自动具有该注解
__EOF__
