源码-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

---

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

---