java的注解学习

学习路线: 1. 什么是注解 2. 内置注解 3.元注解 4.自定义注解

1.什么是注解(Annotation):

　　Annotation的作用: 不是程序本身,但可以对程序作出解释,(这一点和注释(comment)没什么区别).

　　可以被其他程序(比如:编译器等)读取.--->配合反射使用.

　　Annotation的格式: 注解以"@注解名"在代码中存在,还可以添加一些参数值,如:@SuppressWarnings(value="unchecked").

　　Annotation在哪里使用? 可以附加在package,class,method,field等上面,相当于给他们添加额外的辅助信息,我们可以通过反射机制编程实现对这些元数据的访问.

2.内置注解

　　@Override: 定义在 java.lang.Override中,此注解只适用于修辞方式,表示一个方法声明打算重写超类的另一个方法.

　　@Deprecated:定义在java.lang.Deprecated中,此注解用于修辞方法,属性,类,表示不鼓励程序员使用,通常因为有危险或更好的选择.

　　@SuppressWarnings:定义在lava.lang.SuppressWarnings中,用来抑制表意识的警告信息. (需要带参数)

　　　　@SuppressWarnings("all") , @SuppressWarnings("unchecked") , @SuppressWarnings(value={"unchecked","deprecation"})

3.元注解

　　元注解的作用是负责解释其他注解,java定义了4个标准的meta-annotation类型,他们被用来提供对其他annotation类型的说明.

　　这些类型和他们所支持的类在java.lang.annotation包中可以找到(@Target , @Retention , @ Documented , @ Inherited)

　　@Target : 用于描述注解的使用范围(被标书的注解可以在什么地方使用, 类,方法 ,或字段上)

　　@Retention: 表示需要在什么级别保存该注释信息,用于描述注解的生命周期.(SOURCE<CLASS<RUNRIME)

　　@Document: 说明该注解将被包含在javadoc中

　　@Inherited: 说明子类可以继承父类中的该注解

4.自定义注解

//注解参数赋值没有顺序 (只有一个参数建议用value命令参数变量)

package com.cc8w.test;

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;

//@Target表示注解在什么地方使用(下面例子限制在 类和方法上)
@Target(value= {ElementType.METHOD,ElementType.TYPE})

//@Retention 表示我们的注解在什么地方有效 (runtime>class>source)
@Retention(value = RetentionPolicy.RUNTIME)

//@Documented 表示是否将注解上传到javadoc 文档中
@Documented

//@Inherited 子类可以继承父类的注解
@Inherited
public @interface Myannnotation {
    //注解的参数: 参数类型 + 参数名();
    String value() default ""; //有默认值
    int age (); //没有默认值
    int id() default -1;//如果默认值-1表示不存在
    String [] school();//数组
}