注解与自定义注解

 

1 注解

注解可以增强java代码,同时利用反射技术可以扩充很多功能.他们被广泛应用与三大框架底层

现在最主流的开发都是基于注解方式开发,代码量少,框架可以根据注解去自动生成很多代码,程序更易读,例如最火爆的Spring  Boot 就完全基于注解去技术实现

2 注解的分类

1) JDK 自带注解(标识重写的 @Override )

2) 元注解

3) 自定义注解

2.1 JDK注解

JDK 注解的注解就 5个

@Override:用来标识重写方法

@Deprecated标记就表明这个方法已经过时了，但我就要用，别提示我过期
@SuppressWarnings(“deprecation”) 忽略警告
@SafeVarargs jdk1.7出现，堆污染，不常用
@FunctionallInterface jdk1.8出现，配合函数式编程拉姆达表达式，不常用

2.2 元注解

元注解:用来描述注解的注解 ,就5个

@Target 注解用到哪里:类上,方法上,属性上,等等

@Retention 注解的生命周期:源文件上.java , 字节码文件上.class , 运行中

@inherited 允许子注解继承

@Documented 生成Javadoc 时会包含注解

@ Repeatab 注解为可以重复类型注解,可以在同一地方多次使用

2.2.1 @target 注解属性

描述注解存在的位置

ElementType.TYPE   只能应用于类的元素

ElementType.TETHOD   只能应用于方法

ElementType.FIFLD   只能应用于字段或者属性(成员变量)

ElementType.ANNOTATION_TYPE  只能应用于注释类型

ElementType.CONSTRUCTOR   只能应用于构造函数

ElementType.LOCAL_VARIABLE   只能应用于局部变量

ElementType.PACKAGE   只能应用于包的声明

ElementType.PARAMETER   只能应用于方法的参数

 2.2.2 @Retention

SOURCE 在源文件中有效（即 .java 源文件保留）

CLASS 在class文件中有效（即.class保留）

RUNTIME 在运行时有效（即运行时保留）

3 自定义注解

package cn.tedu.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 本类用于实现自定义注解
 */
public class TestAnnotation {
}
/**
 * 1.2 通过@Target注解表示自定义注解@Text可以使用的位置
 * 注意@Target使用时需要导包
 * 我们通过“ElementTpye”的方式来指定自定义注解@Test的可用位置
 * 如果有多个值，可以使用“{，}”的格式来写
 * @Target({ElementType.METHOD,ElementType.TYPE})
 */
@Target({ElementType.METHOD,ElementType.TYPE,ElementType.FIELD})
/** 1.3 通过@Retention 元注解表示自定义注解@Test的生命周期
 *注意：@Retention使用时也要导包
 * 就是这个注解可以存在到什么时候
 * 源文件中SOURCE/字节码文件 中的class  /运行时的Runtime
 */
@Retention(RetentionPolicy.SOURCE)
  /**

 * 首先注意：自定义注解的语法与Java不同，不同套用Java的格式
 * 注解在定义时要使用”@interface“ 注解名的格式
 *
 */

@interface Text{//注解名Test是自定义的，可以随意更改
    /**
     * 自定义注解还可以添加功能--给注解添加属性
     * 注意 int age() 不是方法的定义，而是给自定义注解定义age属性
     * 如果为了使用注解时方便，还可以给属性指定 默认值，这样注解就不用赋值就直接使用了，格式：int age() default 0;
     */
//    int age();//自定义注解定义age属性
    int age() default 0;
    /**
     * 4 给自定义注解Test追加特殊属性value
     * 特殊属性的定义格式与普通属性一样，主要区别在于使用时
     *使用此注解给属性赋值时，可以不用学成“@Text(valuse = "apple")"
     * 格式可以简化为”@Test("apple")“ 但是自定义注解类中给特殊属性赋值时不能简写
     *
     */
    /**
     *测试6 给特殊数据value赋值时，可以简写，相当于(value = "apple")
     */
    /**
     *测试7 因为两个属性已经有默认值了，所以可以直接使用@Test
     */
      String value() default "lemon";
}
/**
 * 2 使用注解时，只要在指定的自定义注解名字前加@即可使用此注解
 *2.定义一个类来测试自定义注解
 */
@Text()
class TestAnno{
    /**
     * 分别给TextAnno类/name属性/eat()方法都添加了@test注解
     * 自定义注解能够加在什么位置，取决与@target注解的值
     */
    @Text()
    String name;


    /**
     * 测试3
     * 当我们添加注解的age属性时，@Test报错
     * 当注解没有定义属性时，可以使用，如果添加了属性，就必须给属性赋值
     * 测试4 给@Test的age属性赋值后，就不会报错了
     * 给属性赋值的格式："@Text(age = 10)"
     * 测试5 给age属性赋予默认值后，可以不加属性值。直接使用注解
     */
    @Text(age = 10)
    public void eat(){
        System.out.println("滴滴");
    }

}