详解Java进阶知识注解

时间:2021-11-26 10:21:02

一、注解的概念

1、注解官方解释

注解

叫元数据,一种代码级别的说明,它是JDK1.5及以后版本引入的一个特性,与类、接口、枚举在同一个层次,它可以声明在包、类、字段、局部变量、方法参数等的前面,用来对这些元素进行说明、注释。

注解的作用分类

  • 编写文档:通过代码里表示的元数据生成文档【生成doc文档】
  • 代码分析:通过代码里表示的元数据进行分析【使用反射】
  • 编译检查:通过代码里表示的元数据让编译器能够实现基本的编译检查【Override】

注解按照运行机制分类

  • 源码注解:注解只在源码中存在,编译成.class文件之后就不存在了
  • 编译时注解:注解在源码存在的基础上,也会在.class文件中存在,但是在运行阶段中就不存在了,例如:@Override
  • 运行时注解:注解在运行阶段依然存在,且能够影响程序的运行过程,例如:@Autowired

2、注解与注释的区别

(1)注解:用于描述代码,说明程序,主要目的是为了给计算机看,且能够影响程序的运行。

(2)注释:用于描述代码的作用和一些关键性的知识点,使用文字描述程序,是为了给程序员观看,以此来使程序员能够以最快的时间了解被注释的代码。


二、内置注解与元注解

1、常用的内置注解

  • @Override:检测该注解标记的方法是否继承自父类;
  • @Deprecated:说明被标记的内容已过时,暗示着在不久之后可能会被更新抹除;
  • @SuppressWarnings:压制警告,就是被标记的部分不会产生警告,常用的参数:@SuppressWarnings(“all”);
  • @SafeVarargs:参数安全类型注解,它的目的就是提醒开发者不要用参数做一些不安全的操作,它的存在会阻止编译器产生unchecked这样的警告;

2、常用的元注解

元注解:用于描述注解的注解,在创建注解时使用

1. @Target属性值:

  • ElementType.TYPE:能修饰类、接口或枚举类型
  • ElementType.METHOD:能修饰方法
  • ElementType.FIELD: 能修饰成员变量
  • ElementType.PARAMETER:能修饰参数
  • ElementType.CONSTRUCTOR:能够修饰构造器
  • ElementType.ANNOTATION_TYPE:能够修饰注解
  • ElementType.PACKAGE:能够修饰包
  • ElementType.LOCAL_VARIABLE:能够修饰局部变量

2.@Retention属性值:

  • RetentionPolicy.SOURCE:注解只在源码中存在,编译成class之后就没了
  • RetentionPolicy.CLASS:注解在源码和class中都存在,运行时就没了,这个是Retention的默认值
  • RetentionPolicy.RUNTIME: 注解在源码、class、运行时都存在,如果要使用反射一定要定义为这种类型

3.@Documented:该注解的作用就是表示此注解标记的注解可以包含到javadoc文件中去
4.@Inherited:描述注解是否能够被子类所继承

三、自定义注解

1、自定义注解基础知识

1.格式:

  1. @Inherited//元注解public @interface zhujie{}

2.注解本质:注解的本质上就是一个接口,该接口默认继承Annotation

  1. public interface MyAnno extends java.lang.annotation.Annotion

3.属性:接口中可以定义的内容(成员方法、抽象方法)

属性的返回值:

  • 八种基本数据类型
  • 字符串类、接口、枚举
  • 注解
  • 以上类型的数组

属性赋值注意事项

  • 如果定义属性时,使用default关键字给属性默认初始化值,则使用注解时,就可以不进行属性的赋值,否则都必须给属性赋值
  • 如果只有一个属性需要赋值的话,并且属性的名称是value,则使用注解给属性赋值时,value可以省略,直接定义值就可以了
  • 数组赋值时,值需要使用{}包裹,如果数组中只有一个值,则{}可以省略不写

2、演示自定义注解的使用

自定义注解annotation

  1. @Retention(value = RetentionPolicy.RUNTIME)
  2. @Target(value = ElementType.TYPE)
  3. public @interface annotation {
  4. String name() default "木鱼";
  5. int age();
  6. int[] score();
  7. }

使用以上注解的类TestAnnotation

  1. //name具有默认值,不需要必须为name赋值,但也可以重新赋值
  2. @annotation(age=20,score={99,100,100})
  3. public class TestAnnotation {
  4.  
  5. public static void main(String[] args) throws ClassNotFoundException {
  6. Class clazz = Class.forName("test.TestAnnotation");
  7. annotation annotation = (annotation) clazz.getAnnotation(annotation.class);
  8. System.out.println("姓名:"+annotation.name()+" 年龄:"+annotation.age());
  9. System.out.print("成绩为:");
  10. int[] score=annotation.score();
  11. for (int score1:score){
  12. System.out.print(score1+" ");
  13. }
  14. }
  15.  
  16. }

运行结果

详解Java进阶知识注解

3、演示注解在程序中的作用

两个方法:

  • 类对象调用 isAnnotationPresent(Class<? extends Annotation> annotationClass)判断是否应用了某个注解
  • 通过getAnnotation()方法获取Annotation对象,或者getAnnotations()方法获取所有应用在该类上的注解

1.创建自定义注解

  1. @Retention(value = RetentionPolicy.RUNTIME)
  2. @Target(value = ElementType.FIELD)
  3. public @interface StringNull {
  4.  
  5. }

2.创建实体类

  1. public class Student {
  2. @StringNull
  3. public String name=null;
  4.  
  5. @StringNull
  6. public String xuehao=null;
  7.  
  8. @StringNull
  9. public String sex=null;
  10.  
  11. public void setName(String name) {
  12. this.name = name;
  13. }
  14.  
  15. public void setXuehao(String xuehao) {
  16. this.xuehao = xuehao;
  17. }
  18.  
  19. public void setSex(String sex) {
  20. this.sex = sex;
  21. }
  22. }

3.创建测试类,测试注解

  1. public class TestAnnotation {
  2.  
  3. public static void main(String[] args) throws Exception{
  4. Class clazz = Class.forName("test.Student");
  5. Student student =(Student) clazz.newInstance();
  6. student.setName("小明");
  7. Field[] fields= clazz.getFields();
  8. for(Field f:fields){
  9. if(f.isAnnotationPresent(StringNull.class)){
  10. if(f.get(student)==null){
  11. System.out.println(f.getName()+":是空的字符串属性");
  12. }else{
  13. System.out.println(f.getName()+":"+f.get(student));
  14. }
  15. }
  16. }
  17. }
  18. }

4.运行结果

详解Java进阶知识注解

以上就是详解Java进阶知识注解的详细内容,更多关于Java注解的资料请关注服务器之家其它相关文章!

原文链接:https://blog.csdn.net/mydesss/article/details/115604708