java-注解

生成帮助文档。这是最常见的，也是 Java 最早提供的注解。常用的有 @see、@param 和 @return 等；
跟踪代码依赖性，实现替代配置文件功能。比较常见的是 Spring 2.5 开始的基于注解配置。作用就是减少配置。现在的框架基本都使用了这种配置来减少配置文件的数量；
在编译时进行格式检查。如把 @Override 注解放在方法前，如果这个方法并不是重写了父类方法，则编译时就能检查出

/*
用来注解类、接口、成员方法和成员变量等，用于表示某个元素（类、方法等）已过时。当其他程序使用已过时的元素时，编译器将会给出警告。
@Deprecated 注解增加了以下两个属性：
forRemoval：该 boolean 类型的属性指定该 API 在将来是否会被删除。
since：该 String 类型的属性指定该 API 从哪个版本被标记为过时。
 */

@Deprecated
public class Demo1 {
    @Deprecated
    protected String name;
    private int age;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    @Override
    public String toString() {
        return "Demo1{" +
                "name=‘" + name + ‘\‘‘ +
                ", age=" + age +
                ‘}‘;
    }
}

要用在取消一些编译器产生的警告对代码左侧行列的遮挡，有时候这样会挡住我们断点调试时打的断点
果你确认程序中的警告没有问题，可以不用理会。通常情况下，如果程序中使用没有泛型限制的集合将会引起编译器警告，为了避免这种编译器警告，可以使用 @SuppressWarnings 注解消除这些警告。

注解的使用有以下三种：
抑制单类型的警告：@SuppressWarnings("unchecked")
抑制多类型的警告：@SuppressWarnings("unchecked","rawtypes")
抑制所有类型的警告：@SuppressWarnings("unchecked")

@SafeVarargs注解不适用于非 static 或非 final 声明的方法，对于未声明为 static 或
 final 的方法，如果要抑制 unchecked 警告，可以使用 @SuppressWarnings 注解。

SOURCE：在源文件中有效（即源文件保留）
CLASS：在 class 文件中有效（即 class 保留）
RUNTIME：在运行时有效（即运行时保留）


#############################
生命周期大小排序为 SOURCE < CLASS < RUNTIME，前者能使用的地方后者一定也能使用。
如果需要在运行时去动态获取注解信息，那只能用 RUNTIME 注解；如果要在编译时进行一些
预处理操作，比如生成一些辅助代码（如 ButterKnife），就用 CLASS 注解；如果只是做
一些检查性的操作，比如 @Override 和 @SuppressWarnings，则可选用 SOURCE 注解。

@Target(ElementType.TYPE)
@Inherited
@Retention(RetentionPolicy.RUNTIME)
public @interface MyInherited {
}

@MyInherited
public class UserDemo1 {
    public static void main(String[] args) {
        System.out.println(UserDemo1.class.getAnnotation(MyInherited.class));
        System.out.println(UserDemo2.class.getAnnotation(MyInherited.class));
        System.out.println(UserDemo3.class.getAnnotation(MyInherited.class));
    }
}
class UserDemo2 extends UserDemo1{ }
class UserDemo3 extends UserDemo1{ }

结果：
@annotations.MyInherited()
@annotations.MyInherited()
@annotations.MyInherited()

/*
注解前面访问修饰符有公有和默认
一个源程序可以生命多个注解，但是只能一个公有。且其文件名
和公有注解名字一致
1默认情况下，注解可以在程序的任何地方使用，通常用于修饰类、接口、方法和变量等
2成员变量以无形参的方法形式来声明
3成员变量也可以有访问权限修饰符，但是只能有公有权限和默认权限。
 */

public @interface MyInherited {
    String name();
    int age();
}

###没有默认值必须在使用的时候设置默认值

@interface  YouInherited{
    String name() default "huolala";
    int age() default  2014;
}

    @MyInherited(name="hao",age=90)
    public static void show(){

    }