org.apache.hadoop.classification-InterfaceAudience

標籤：style   blog   http   color   io   使用   ar   java   for   

 

我是從和心包core開始的。根據包名稱classification可以看出來這裡面的類也起著類似tool的作用。

 

 1 /** 2 *注釋省略... 3 **/ 4 package org.apache.hadoop.classification; 5  6 import java.lang.annotation.Documented; 7 //只引入了JDK的注釋包中的Documented介面，即沒有其他hadoop類級聯 8 /** 9  * Annotation to inform users of a package, class or method‘s intended audience.10  */11 //這裡面也是註解類，用來向使用者表明一個包、類或者方法的潛在的使用範圍12 @InterfaceAudience.Public13 @InterfaceStability.Evolving14 //自註解（自己起的名字）。第一個註解就用到了這個類中的第一個內部註解。第二個是同包下的第二個類（不解釋）。15 public class InterfaceAudience {16   /**17    * Intended for use by any project or application.18    */19   @Documented public @interface Public {};20   //@Doccumented 是元註解（就是註解註解的註解），作用是指示某一類型的注釋將通過 javadoc 和類似的預設工具進行文檔化。21   //這個註解是標識適用任何工程或者應用22   /**23    * Intended only for the project(s) specified in the annotation.24    * For example, "Common", "HDFS", "MapReduce", "ZooKeeper", "HBase".25    */26   @Documented public @interface LimitedPrivate {27     String[] value();28   };29   //標識適用於某些特殊的工程。比如HDFS、Mapreduce等30   //它的值是個字串數組，表示可以是多個工程31   32   /**33    * Intended for use only within Hadoop itself.34    */35   @Documented public @interface Private {};36 //只適用於hadoop自己37   private InterfaceAudience() {} // Audience can‘t exist on its own38 //構造方法，私人的。已有注釋39 }

關於元註解和自訂註解 http://www.cnblogs.com/peida/archive/2013/04/24/3036689.html 

 

org.apache.hadoop.classification-InterfaceAudience