【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：

操作成功。