黑马程序员——Java中的注解

——Java培训、Android培训、iOS培训、.Net培训、期待与您交流！ ——-

注解

注解是代码的附属信息，它遵循一个基本原则：注解不能直接干扰程序代码的运行，无论增加或删除注解，代码都能够正常运行。Java语言解释器会忽略这些注解 我们可以自定义这些标签，并通过Java语言的反射机制中获取类中标注的注解，完成特定的功能。
注解的语法比较简单，除了@符号的使用以外，它基本上与java的固有语法一致，java内置了三种注解，定义在java.lang包中。

@Override：只能用在方法之上的，用来告诉别人这一个方法是改写父类的。

@Deprecated：建议别人不要使用旧的API的时候用的,编译的时候会用产生警告信息,可以设定在程序里的所有的元素上。

@SuppressWarnings：表示关闭一些不当的编译器警告信息。

我们分别用三个例子说明：

@Override

/*
 * 注解的应用：@Override
 */

public class AnnotationTest {


    public static void main(String[] args) {

         new Parent().show();
         new Son().show();
    }

}
class Parent
{
  public void show()
  {
      System.out.println("I am Patent");
  }

}
class Son extends Parent
{ 
    /*
     * 
     * 加上@Override说明是重写父类方法 
     * 如果该方法不是重写，或重写出错都不能编译通过，把错误放再编译期
     *  
     */
    @Override
   public void show()
   {
       System.out.println("I am Son");
   }
}

@Deprecated

/*
 * 注解的应用：@Deprecated
 * 加解析前
 */

public class AnnotationTest {


    public static void main(String[] args) {

         new Parent().show();

    }

}
class Parent
{

  public void show()
  {
      System.out.println("I am Patent");
  }

}

加注解后

/*
 * 注解的应用：@Deprecated
 * 加注解后
 */

public class AnnotationTest {


    public static void main(String[] args) {
         //过时提示
         new Parent().show();

    }

}

    class Parent
{
        //加注解，提示方法过时
         @Deprecated
         public void show()
          {
              System.out.println("I am Patent");
          }
}

@SuppressWarnings

加注释前

加注释后

自定义注解

自定义注解用关键字@interface，在设计annotations的时候必须把一个类型定义为@interface，而不能用class或interface关键字。所有的注解类都隐式继承于 java.lang.annotation.Annotation，注解不允许显式继承于其他的接口。
定义方法：
例：@interface Myannotation{}
定义成员：
例：String name() default “李四”;

注解定义包含四个元注解，分别为@Target,@Retention,@Documented,
@Inherited。各元注解的作用如下：

1) @Target

表示该注解用于什么地方，可能的 ElemenetType 参数包括：

Ø ElemenetType.CONSTRUCTOR 构造器声明。

Ø ElemenetType.FIELD 域声明（包括 enum 实例）。

Ø ElemenetType.LOCAL_VARIABLE 局部变量声明。

Ø ElemenetType.METHOD 方法声明。

Ø ElemenetType.PACKAGE 包声明。

Ø ElemenetType.PARAMETER 参数声明。

Ø ElemenetType.TYPE 类，接口（包括注解类型）或enum声明。

2) @Retention

表示在什么级别保存该注解信息。可选的 RetentionPolicy 参数包括：

Ø RetentionPolicy.SOURCE 注解将被编译器丢弃。

Ø RetentionPolicy.CLASS 注解在class文件中可用，但会被VM丢弃。

Ø RetentionPolicy.RUNTIME VM将在运行期也保留注释，因此可以通过反射机制读取注解的信息。

举一个例子，如@Override里面的Retention设为SOURCE，编译成功了就不要这一些检查的信息，相反，@Deprecated里面的Retention设为RUNTIME，表示除了在编译时会警告我们使用了哪个被 Deprecated的方法，在执行的时候也可以查出该方法是否被Deprecated。
3) @Documented

将此注解包含在 javadoc 中

4) @Inherited

允许子类继承父类中的注解

定义注解类：

/*
 * 定义注解
 */
//定义注解的保存级别
@Retention(RetentionPolicy.RUNTIME)
//定义注解可标注的地放
@Target(ElementType.TYPE)

public @interface Myannotation {
    //定义属性，default为指定默认值为李四
   String name() default "李四";
   //特殊的属性
   String value()  default "haha";
}

//对注解中的特殊属性赋值
@Myannotation("Hello World")
public class AnnotationTest {


    public static void main(String[] args) {
        //检测是否有注解Myannotation
        boolean flag = AnnotationTest.class.isAnnotationPresent(Myannotation.class);
        if(flag)
        {
            //得到注解对象
            Myannotation annotation = AnnotationTest.class.getAnnotation(Myannotation.class);
            //获得注解中的某属性值
            System.out.println(annotation.name());
        }

    }

}