【HDFS API编程】第一个应用程序的开发-创建文件夹

/**
 * 使用Java API操作HDFS文件系统
 * 关键点:
 * 1)创建 Configuration
 * 2)获取 FileSystem
 * 3)...剩下的就是 HDFS API的操作了
*/

先上代码

public class HDFSApp {
    public static void main(String[] args) throws Exception {
        Configuration configuration = new Configuration();

        FileSystem fileSystem = FileSystem.get(new URI("hdfs://hadoop000:8020"),configuration,"hadoop");

        Path path = new Path("/hdfsapi/test");
        boolean result = fileSystem.mkdirs(path);
        System.out.println(result);
    }
}

对于方法的源码是我们在学习的时候必须的，我们可以按住Ctrl然后点击对应的方法类名进去进行源码的下载。

首先要对HDFS进行操作我们就必须获取FileSystem，

Ctrl点进FileSystem源码，我们能看到最顶部的注释介绍(附上了中文翻译)：

/****************************************************************
 * An abstract base class for a fairly generic filesystem.  It
 * may be implemented as a distributed filesystem, or as a "local"
 * one that reflects the locally-connected disk.  The local version
 * exists for small Hadoop instances and for testing.
 *
 * <p>
 *
 * All user code that may potentially use the Hadoop Distributed
 * File System should be written to use a FileSystem object.  The
 * Hadoop DFS is a multi-machine system that appears as a single
 * disk.  It's useful because of its fault tolerance and potentially
 * very large capacity.
 * 
 * <p>
 * The local implementation is {@link LocalFileSystem} and distributed
 * implementation is DistributedFileSystem.
 *****************************************************************/
/**********************************************

*一个相当通用的文件系统的抽象基类。它可以实现为分布式文件系统，也可以实现为“本地”
*反映本地连接磁盘的磁盘。本地版本
*存在于小型Hadoop实例和测试中。
*所有可能使用Hadoop分布式的用户代码
*应该写入文件系统以使用文件系统对象。这个Hadoop DFS是一个多机系统，显示为单个磁盘。它是有用的，因为它的容错性和潜在的容量很大。
*< P>
*本地实现是@link localfilesystem和分布式的
*实现是分布式文件系统。
***********************************************/

写作的开门见山，第一句话能够概括全文中心---> 这是 一个相当通用的文件系统的抽象基类。，所以我们使用Java API操作HDFS文件系统需要获取FileSystem。

使用FileSystem的get方法获取fileSystem，FileSystem有三种get方法：

不知道怎么用？哪里不会Ctrl点哪里！

首先看只有一个参数的get方法：get(Configuration conf)：

/**
   * Returns the configured filesystem implementation.
   * @param conf the configuration to use
   */
/**
*返回配置的文件系统实现。
*@参数conf 要使用的配置
*/
  public static FileSystem get(Configuration conf) throws IOException {
    return get(getDefaultUri(conf), conf);
  }

从源码的介绍中可以知道 Configuration 是某种配置，具体是什么？Ctrl点一点：

Provides access to configuration parameters.//提供对配置参数的访问。

源码中configuration的注释介绍第一句已经介绍了这是对配置参数的访问，所以，使用Java API操作HDFS文件系统需要创建configuration：Configuration configuration = new Configuration();

跳过两个参数的get方法，我们来看包含三个参数的get方法,Ctrl 点进去：

/**
* Get a filesystem instance based on the uri, the passed
* configuration and the user
* @param uri of the filesystem
* @param conf the configuration to use
* @param user to perform the get as
* @return the filesystem instance
* @throws IOException
* @throws InterruptedException
*/
/**
*获取基于URI的文件系统实例，配置和用户
*@参数uri 文件系统的uri
*@参数conf 要使用的配置
*@参数user 要执行get as的用户
*@返回文件系统实例
*@引发IOException
*@引发InterruptedException
*/ 
  public static FileSystem get(final URI uri, final Configuration conf,
        final String user) throws IOException, InterruptedException {
    String ticketCachePath =
      conf.get(CommonConfigurationKeys.KERBEROS_TICKET_CACHE_PATH);
    UserGroupInformation ugi =
        UserGroupInformation.getBestUGI(ticketCachePath, user);
    return ugi.doAs(new PrivilegedExceptionAction<FileSystem>() {
      @Override
      public FileSystem run() throws IOException {
        return get(uri, conf);
      }
    });
  }

重点看方法上面的注释，介绍了方法的功能、参数解释、返回值以及可能引发的异常。

我们要对HDFS操作，是不是需要知道我们要对哪个HDFS操作(URI)，是不是要指定用什么样的配置参数进行操作(configuration),是不是需要确认是用什么用户进行操作(user)，这样我们才能够准确地使用正确的用户以及正确的配置访问正确的HDFS。

此时我们拿到的fileSystem已经是我们需要的fileSystem了，那么剩下的操作就是对HDFS API的操作了，例如我们创建一个文件夹：

使用fileSystem的mkdirs方法，mkdirs方法不知道怎么用？Ctrl点！

  /**
   * Call {@link #mkdirs(Path, FsPermission)} with default permission.
   */
  public boolean mkdirs(Path f) throws IOException {
    return mkdirs(f, FsPermission.getDirDefault());
  }

我们可以看到mkdir方法接收的参数是一个Path路径，返回值是boolean类型判断是否创建成功，所以我们可以写：

Path path = new Path("/hdfsapi/test");//创建一个Path
boolean result = fileSystem.mkdirs(path);
System.out.println(result);//输出result查看是否创建成功
此时我们可以通过终端控制台进行查看文件夹是否创建成功：



当然也可以通过浏览器查看是否创建成功：输入  地址IP:50070 回车， 例如 192.168.42.110:50070 回车，
进去点击Utilities下拉列表的Browse the fiel system,点Go！就能看到：

点进去hdfsapi：

操作成功。