黑马程序员----JAVA----注解

----------------------------------android培训、java培训、期待与您交流！------------------------------

span style="font-size:18px;">

注解(注释)Annotation类
 
jdk1.5以后提供的新特性
 
①类中的注释有三个@Deprecated(废除)、@Override(复写)、@SuppressWarnings(压缩警告)
 
Deprecated类
 
用 @Deprecated 注释的程序元素，不鼓励程序员使用这样的元素，通常是因为它很危险或存在更好的选择。在使用不被赞成的程序元素或在不被赞成的代码中执行重写时，编译器会发出警告。
 
Override类
 
@Override表示一个方法声明打算重写超类中的另一个方法声明。
 


SuppressWarnings类
 
@SuppressWarnings指示应该在注释元素（以及包含在该注释元素中的所有程序元素）中取消显示指定的编译器警告。如果要在特定的方法中取消显示某个警告，则应该注释该方法而不是注释它的类。
 
注释的反射：
 
class类中的isAnnotation()和isAnnotationPresent方法可以检测这个class对象上是否有注释并且可以获取这个注释
 
boolean isAnnotation() 

如果此 Class 对象表示一个注释类型则返回 true。 

boolean isAnnotationPresent(Class<? extends Annotation> annotationClass) 

如果指定类型的注释存在于此元素上，则返回 true，否则返回 false。 

②注释中的注释有四个Documented类、Inherited类、Retention类和Target类
 
Documented类
 
指示某一类型的注释将通过 javadoc 和类似的默认工具进行文档化。
 
Inherited类
 
指示注释类型被自动继承。如果在注释类型声明中存在 Inherited 元注释，并且用户在某一类声明中查询该注释类型，同时该类声明中没有此类型的注释，则将在该类的超类中自动查询该注释类型。此过程会重复进行，直到找到此类型的注释或到达了该类层次结构的顶层 (Object) 为止。如果没有超类具有该类型的注释，则查询将指示当前类没有这样的注释。 

注意，如果使用注释类型注释类以外的任何事物，此元注释类型都是无效的。还要注意，此元注释仅促成从超类继承注释；对已实现接口的注释无效。 

Retention类
 
指示注释类型的注释要保留多久。如果注释类型声明中不存在 Retention 注释，则保留策略默认为 RetentionPolicy.CLASS。
 
三种取值：RetentionPolicy.SOURCE 、RetentionPolicy.CLASS 、RetentionPolicy.RUNTIME 分别对应的阶段为：java源文件，class文件，内存字节码
 
注意：只有元注释类型直接用于注释时，Target 元注释才有效。
 
Target类
 
指示注释类型所适用的成分。
 
参数：
 
ElementType.[
 
ANNOTATION_TYPE 注释类型声明 

CONSTRUCTOR 构造方法声明 

FIELD 字段声明（包括枚举常量） 

LOCAL_VARIABLE 局部变量声明 

METHOD 方法声明 

PACKAGE 包声明 

PARAMETER 参数声明 

TYPE 类、接口（包括注释类型）或枚举声明 ]
 


③。注解属性
 
注解的属性就类似于注释的标志
 
注解的属性可以包括String类型，Class类型，8个基本类型，8个基本类型加String类型的数组类型，枚举类型，注释类型。
 
自定义注解实例
 
package cn.itcast.day2;
 import java.lang.annotation.Documented;
 import java.lang.annotation.Inherited;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 import java.lang.annotation.ElementType;
 import java.lang.annotation.RetentionPolicy;
 /*
  * 元注解@Target,@Retention,@Documented,@Inherited
  * @Target 表示该注解用于什么地方，可能的 ElemenetType 参数包括：
  * ElemenetType.CONSTRUCTOR 构造器声明
  * ElemenetType.FIELD 域声明（包括 enum 实例）
  * ElemenetType.LOCAL_VARIABLE 局部变量声明
  * ElemenetType.METHOD 方法声明
  * ElemenetType.PACKAGE 包声明
  * ElemenetType.PARAMETER 参数声明
  * ElemenetType.TYPE 类，接口（包括注解类型）或enum声明
  * @Retention 表示在什么级别保存该注解信息。可选的 RetentionPolicy 参数包括：
  * RetentionPolicy.SOURCE 注解将被编译器丢弃
  * RetentionPolicy.CLASS 注解在class文件中可用，但会被VM丢弃
  * RetentionPolicy.RUNTIME VM将在运行期也保留注释，因此可以通过反射机制读取注解的信息。
  * @Documented 将此注解包含在 javadoc 中
  * @Inherited 允许子类继承父类中的注解
  */
 @Target(ElementType.METHOD)
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
 @Inherited
 /*
 * 定义注解 Test
 * 注解中含有两个元素 id 和 description
 * description 元素 有默认值 "no description"
 */
 public @interface Test {
      public int id();
      public String description() default "no description";
 }
 
下面是一个使用注解 和 解析注解的实例
 
package cn.itcast.day2;
 import java.lang.reflect.Method;
 public class Test_1 {
   /*
    * 被注解的三个方法
      */
  @Test(id = 1, description = "hello method_1")
  public void method_1() {
 
  }
   @Test(id = 2)
   public void method_2() {
 
 }
 
  @Test(id = 3, description = "last method")
      public void method_3() {
 
  }
  /*
 
  * 解析注解，将Test_1类 所有被注解方法 的信息打印出来
 
 */
  public static void main(String[] args) {
   Method[] methods = Test_1.class.getDeclaredMethods();
   for (Method method : methods) {
    /*
              * 判断方法中是否有指定注解类型的注解
 
  */
             boolean hasAnnotation = method.isAnnotationPresent(Test.class);
             if (hasAnnotation) {
                 /*
                  * 根据注解类型返回方法的指定类型注解
     */
     Test annotation = method.getAnnotation(Test.class);
      System.out.println("Test( method = " + method.getName()
         + " , id = " + annotation.id() + " , description = "
         + annotation.description() + " )");
    }
   }
  }
 }
 
输出结果如下：
 



    Test( method = method_1 , id = 1 , description = hello method_1 )
 
    Test( method = method_2 , id = 2 , description = no description )
 
    Test( method = method_3 , id = 3 , description = last method )
 

 

----------------------------------android培训、java培训、期待与您交流！------------------------------