java注解

java注解和反射--1

所有框架的一个底层

注解：java.Annotation

1.1 什么是注解

• JDK5.0引入的新技术
• Annotation的作用：
  • 不是程序本身，可以对程序做出解释
  • 可以被其他程序读取
• 格式：@注释名
• 使用范围：可以附加在package , class , method , field等上面﹐相当于给他们添加了额外的辅助信息,我们可以通过反射机制编程实现对这些元数据的访问。

package com.ssl.demo01;

//什么是注解
public class Test01 extends Object{

    //@Override  重写的注解
    @Override
    public String toString() {
        return super.toString();
    }
}

1.2 内置注解

• @Override ：定义在java.lang.Override中，此注释只适用于修辞方法，表示一个方法声明打算重写父类中的另一个方法声明。
• @Deprecated：定义在java.lang.Deprecated中，此注释可以用于修饰方法，属性，类。表示不鼓励程序员使用这样的元素，通常是因为他们很危险或者存在更好的选择。
• @SuppressWarnings:定义在java.lang.SuppressWarnings中，用来抑制编译时的警告信息。需要参数
  • @SuppressWarnings("all")
  • @SuppressWarnings("unchecked")
  • @SuppressWarnings(value={"unchecked","deprecation"})
  • 等等.....

package com.ssl.demo01;

import java.util.ArrayList;
import java.util.List;

//什么是注解
public class Test01 extends Object{

    //@Override  重写的注解
    @Override
    public String toString() {
        return super.toString();
    }

    //Deprecated 不推荐程序员使用，但是可以使用;或者存在更好的方式
    @Deprecated
    public static void test(){
        System.out.println("Deprecated");
    }

    //suppressWarnings 镇压警告
    @SuppressWarnings("all")
    public  void test02(){
        List list = new ArrayList();
    }
    public static void main(String[] args) {
        test();
    }

}

1.3 元注解

元注解的作用是负责注解其他注解。在java.lang.annotation包中。定义了4个标准的meta-annotation。

• @Target：用于描述注解的使用范围(被描述的注解可以用在什么地方)。
• @Retention：表示需要在什么级别保存该注释信息，用于描述注解的生命周期。
  • (SOURCE<CLASS<RUNTIME)
• @Document:说明该注解将被包含在javadoc中。
• @Inherited：说明子类可以继承父类中的该注解。

package com.ssl.demo01;

import java.lang.annotation.*;

//测试元注解
public class Test02 {

    @Myannatation
    public void test(){}

}

//定义一个注解
//Target 表示我们的注解可以用在哪些地方
@Target(value= ElementType.METHOD)
//Retention 表示我们的注解在什么地方还有效
//runtime>class>source
@Retention(value= RetentionPolicy.RUNTIME)
//Documented 表示是否将我们的注解生成在JAVAdoc中
@Documented
//Inherited 子类可以继承父类的注解
@Inherited
@interface  Myannatation{

}

1.4 自定义注解

• 使用@interface 自定义注解时，自动继承了java.lang.annotation.Annotation接口。
• 分析：
  • @interface用来声明一个注释，格式：public @interface 注解名
  • 其中的每一个方法实际上是声明了一个配置参数
  • 方法的名称就是参数的名称
  • 返回值类型就是参数的类型(返回值只能是基本类型，Class，String，enum)
  • 可以通过dafault来声明参数的默认值
  • 如果只有一个参数成员，一般参数名为value
  • 注解元素必须要有值，我们定义注解元素时，经常使用空字符串，0作为默认值

package com.ssl.demo01;

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

//自定义注解
public class Test03 {
    //注解可以显式赋值，如果没有默认值，我们就必须给注解赋值
    @MyAnnotation2(name="ssl")
    public  void test(){}

    //用value可以省略
    @MyAnnotation3("ssl")
    public  void test2(){}

}
@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface  MyAnnotation2{
    //注解的参数；参数类型+参数名（）;
    String name() default "";
    int age() default 0;
    int id() default -1;   //默认值为-1 代表不存在

    String[] schools() default {"xx"};
}

//如果只有一个值，建议用value命名,在使用的时候，可以省略写。
@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface  MyAnnotation3{
    String value();
}