源码-hadoop1.1.0-core-org.apache.hadoop

---

按包的顺序类的顺序来吧，因为我不懂hadoop类的具体体系和类之间的联系，如果有一定知识积累的可以看下别人写的hadoop源码解读类的书，类似的有 http://pan.baidu.com/s/1i3GGvvZ  。我看的模模糊糊，因为没基础。

---

这个包下面只有一个类 HadoopVersionAnnotation，它是一个注释类

---

 /*
  * Licensed to the Apache Software Foundation (ASF) under one
  * or more contributor license agreements.  See the NOTICE file
  * distributed with this work for additional information
  * regarding copyright ownership.  The ASF licenses this file
  * to you under the Apache License, Version 2.0 (the
  * "License"); you may not use this file except in compliance
  * with the License.  You may obtain a copy of the License at
  *
  *     http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */

  //apache的软件所有权声明，意思就是说hadoop所有权是属于apache的。在其其他产品中如tomcat中经常可以看到

 package org.apache.hadoop;

 import java.lang.annotation.*;
 //只导入了Java的注释包中的类。一是说明它没有级联其他hadoop类，二是说明这个类基本上就是一个注释类了
 /**
  * A package attribute that captures the version of Hadoop that was compiled.
  */
  //意思是这是个包属性类，当hadoop编译的时候捕捉其版本号
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.PACKAGE)
 //两个注释。恶补了一下后知道第一个是注释后能让JVM实时通过反射得到注释信息。
 //第二个就是指定这个注释类的目标，就是用在什么地方，具体可以用在类上、属性上等等，这个是说这个注释类是
 //用来注释包的
 public @interface HadoopVersionAnnotation {
 //@interface是说这个类是个注释类。
   /**
    * Get the Hadoop version
    * @return the version string "0.6.3-dev"
    */
   String version();
   //得到hadoop的版本号
   /**
    * Get the username that compiled Hadoop.
    */
   String user();
   //得到编译这个hadoop类时的所属用户
   /**
    * Get the date when Hadoop was compiled.
    * @return the date in unix 'date' format
    */
   String date();
   //当hadoop编译的时候得到时间，而且是unix格式的时间
   /**
    * Get the url for the subversion repository.
    */
   String url();
   //得到SVN版本库的地址
   /**
    * Get the subversion revision.
    * @return the revision number as a string (eg. "451451")
    */
   String revision();
   //得到SVN版本库的补丁号
 }

---

可以看来这个注释类作用体现在编译hadoop的时候。

其中JDK注释类的用法我也是恶补了一下才开始的。推荐 http://blog.csdn.net/foamflower/article/details/5946451 ，讲的很清楚。

---

这个类我翻译了一下另外一种格式，或许能看的更清楚。

 package org.apache.hadoop;

 import java.lang.annotation.*;

 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.PACKAGE)
 public class HadoopVersionAnnotation extends java.lang.annotation.Annotation{

     private String version;

     public void setVersion(String version) {
         this.version = version;
     }
     public String getVersion{
         return version;
     }

     private String user;

     public void setUser(String user) {
         this.user = user;
     }
     public String getUser{
         return user;
     }

     private String date;

     public void setDate(String date) {
         this.date = date;
     }
     public String getDate{
         return date;
     }

     private String url;

     public void setUrl(String url) {
         this.url = url;
     }
     public String getUrl{
         return url;
     }

     private String revision;

     public void setRevision(String revision) {
         this.revision = revision;
     }
     public String getRevision{
         return revision;
     }

 }

---

在apihome.cn中因为hadoop版本不同多一个属性：

　　

大概是hash之类的，用来校验的吧。不跟踪，继续hadoop1.1.0吧。

---

这里吐槽一下在apihome.cn中，因为没有搜索框，并且排序都是按首字母排的，很多类分了很多页，找起来很不方便。所以一个比较简单的方法就是直接访问，比如你要查看hadoop的

hadoopVersionAnnotation这个类，就访问 http://www.apihome.cn/api/hadoop/HadoopVersionAnnotation.html 这个地址，就找到了。

---

还有一个网址想推荐一下，是在读hadoop实战的时候得到的。里面干货不多，但是有几个mapreduce问题并且可以提交答案并验证，类似蓝桥。这对于我这种想找实战环境的hadoop菜鸟来说挺不错的。

http://cloudcomputing.ruc.edu.cn

---

希望大牛们多吐槽一下，谢谢。

---