注解概述
定义:
注解(Annotation),也叫元数据。一种代码级别的说明。它是JDK1.5及以后版本引入的一个特性,与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面,用来对这些元素进行说明,注释。
注解的作用:
编写文档:通过代码里标识的元数据生成文档【生成文档doc文档】
代码分析:通过代码里标识的元数据对代码进行分析【使用反射】
编译检查:通过代码里标识的元数据让编译器能够实现基本的编译检查【Override】
一、为什么要学习注解呢?
在实际的项目中我们会使用大量的框架,很多框架就会使用大量的注解。学习注解能够使我们读懂别人的代码。我们也可以使用注解,自定义注解使我们的代码更清晰更整洁。
二、JDK注解。
1、@Override代表实现和覆盖父类的方法
2、@Deprecated代表这个方法已经过时
3、@SuppressWarnings()意思是忽略,这里是忽略这个deprecation过时的警告
package note.demo;
public interface People {
public String name();
public String age();
//代表这个方法已经过时
@Deprecated
public void song();
}
package note.demo;
public class ChilePeople implements People{
//@Override代表实现和覆盖父类的方法
@Override
public String name() {
// TODO Auto-generated method stub
return null;
}
@Override
public String age() {
// TODO Auto-generated method stub
return null;
}
//@SuppressWarnings()意思是忽略,这里是忽略这个deprecation过时的警告
@SuppressWarnings("deprecation")
@Override
public void song() {
// TODO Auto-generated method stub
People people = new ChilePeople();
//化了横线代表此方法已经过时
people.song();
}
}
三、注解的分类。
1,按照运行机制划分
源码注解:注解只在源码中存在,编译成Class文件就不存在。
编译时注解:注解在源码和Class文件中都会存在注解信息。
运行时注解:在运行阶段还会起作用,甚至会影响运行逻辑的注解。比如很多第三方类库的自定义注解。
2、按照来源划分
JDK注解、第三方注解、自定义的注解
3、元注解
就是注解的注解
四、自定义注解
1、使用@interface关键字定义注解
2、成员的基本类型包括所有的基本类型和String,Class,Annotation,Enumeration
3、如果注解只有一个成员,成员名必须取名为value().
4、注解类可以没有成员,没有成员的注解类成为标识注解
5、@Target({ElementType.METHOD,ElementType.TYPE})表示注解的作用域(元注解)
6、@Retention(RetentionPolicy.RUNTIME) 注解的生命周期(元注解)
7、@Inherited 标识允许子注解来继承这个注解 (注意这里只能是继承不能是接口上使用,而且只能继承类上的注解,不能继承方法上的注解)(元注解)
8、@Documented 生成javadoc时会包含注解 (元注解)
package note.demo;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
//表示注解的作用域METHOD方法上,TYPE类或接口
@Target({ElementType.METHOD,ElementType.TYPE})
//生命周期,运行时
@Retention(RetentionPolicy.RUNTIME)
//表示子注解可以继承
@Inherited
//生成doc文档依然存在
@Documented
//使用@interface关键字定义注解
public @interface CustomNoto {
/**
* 成员的基本类型包括所有的基本类型和String,Class,Annotation,Enumeration
* */
String desc(); //这个表示注解的成员,不是方法。成员必须是无参数,无异常
String author();
int age() default 18; //可以用default给成员制定一个默认的值
}
五、解析注解
通过反射来获取类,方法,接口,或成员上的运行时注解信息,从而实现动态控制程序运行时的逻辑。
反射是在运行时的,所以我们使用反射时解析,必须注解的生命周期是运行时。
package note.demo;
import java.lang.reflect.Method;
//解析注解
public class ParseNoto {
public static void main(String[] args) {
// TODO Auto-generated method stub
//第一步拿到类类型
try {
Class class1 = Class.forName("note.demo.ChilePeople");
//判断这个类型是否存在这个注解
boolean is = class1.isAnnotationPresent(CustomNoto.class);
if (is == true) {
CustomNoto noto = (CustomNoto) class1.getAnnotation(CustomNoto.class);
System.out.println(noto.desc());
}
//解析方法上的注解
Method[] methods = class1.getMethods();
for (Method method : methods) {
boolean isx = method.isAnnotationPresent(CustomNoto.class);
if (isx) {
CustomNoto cNoto = (CustomNoto)method.getAnnotation(CustomNoto.class);
System.out.println(cNoto.age()+"");
}
}
} catch (ClassNotFoundException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
希望以上对大家的理解有所帮助!
我的官方群点击此处。加入群聊【java学习交流群】,一起学习,相互讨论。
群内已经有管理将知识体系整理好(源码,学习视频等资料),欢迎加群免费领取。
JAVA高薪就业(视频,学习路线资料,免费领取)
对于正在学习java的小伙伴们,相信这些对你们还是有帮助的,希望在学java的路上少走弯路,多吸取一些前辈的经验,欢迎攻城狮,程序猿们加入学习交流群1022322005,不管你是领取资料也好,还是交流心得,询问问题,吸取经验,欢迎前来交流。