API操作

• Shell操作是在集群内部，即hadoop102上进行操作，API操作是希望在Windows上能远程连接集群实现增删改查操作

一、客户端环境准备

1、找到资料包路径下的Windows依赖文件夹，拷贝hadoop-3.1.0到非中文路径
2、在Windows上配置HADOOP_HOME环境变量
3、配置Path环境变量
4、验证Hadoop环境变量是否正常，双击winutils.exe，如果报错，则可能缺少微软运行库
5、在IDEA中创建一个Maven工程HdfsClientDemo，并导入相应的依赖坐标+日志添加

<dependencies>
	<dependency>
		<groupId>org.apache.hadoop</groupId>
		<artifactId>hadoop-client</artifactId>
		<version>3.1.3</version>
	</dependency>
	<dependency>
		<groupId>junit</groupId>
		<artifactId>junit</artifactId>
		<version>4.12</version>
	</dependency>
	<dependency>
		<groupId>org.slf4j</groupId>
		<artifactId>slf4j-log4j12</artifactId>
		<version>1.7.30</version>
	</dependency>
</dependencies>

• 在项目的src/main/resources目录下，新建一个文件，命名为“log4j.properties”，在文件中填入：

log4j.rootLogger=INFO, stdout 
log4j.appender.stdout=org.apache.log4j.ConsoleAppender 
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout 
log4j.appender.stdout.layout.ConversionPattern=%d %p [%c] - %m%n 
log4j.appender.logfile=org.apache.log4j.FileAppender 
log4j.appender.logfile.File=target/spring.log 
log4j.appender.logfile.layout=org.apache.log4j.PatternLayout 
log4j.appender.logfile.layout.ConversionPattern=%d %p [%c] - %m%n

6、创建包名：com.user.hdfs
7、创建HdfsClient类

package com.user.hdfs;

import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;

import java.io.IOException;
import java.net.URI;
import java.net.URISyntaxException;


public class HdfsClient {
    private FileSystem fs;

    @Before
    public void init() throws URISyntaxException, IOException, InterruptedException {
        // 1 获取文件系统
        //连接的集群地址
        URI uri = new URI("hdfs://hadoop102:8020");
        //创建一个配置文件
        Configuration configuration = new Configuration();
        //用户
        String user = "user";
        //获取客户端对象
        this.fs = FileSystem.get(uri, configuration, user);
    }

    @After
    public void close() throws IOException {
        // 3 关闭资源
        fs.close();
    }
    @Test
    public void testmkdirs() throws IOException, URISyntaxException, InterruptedException {
        // 2 创建目录
        fs.mkdirs(new Path("/xiyou/huaguoshan1"));
    }
}

注意

• 在以上代码中，获取客户端对象这么写FileSystem fs = FileSystem.get(uri, configuration, user);会抛出抛出NullPointerException，因为在@Before注解的init方法中，我们在方法内部创建了FileSystem的一个新实例，但是没有将其赋值给类的成员变量fs。由于成员变量fs没有被初始化，它仍然是null，所以在@After注解的close方法中调用fs.close()时会抛出NullPointerException
• 在HDFS Web端删除文件huaguoshan1报错Permission denied: user=dr.who, access=WRITE, inode="/xiyou":user:supergroup:drwxr-xr-x表示用户dr.who试图对/xiyou目录进行写操作，但是没有足够的权限，只好在hadoop102使用Shell命令删除文件

二、其他API案例实操

1、从本地上传文件

• 首先在本地D盘创建一个文本文件sunwukong.txt
• 在上述HdfsClient类代码里继续添加如下代码，以下实例也一样

// 上传
    @Test
    public void testPut() throws IOException {
        //参数解读
        //参数一：表示是否删除原数据
        //参数二：表示是否允许覆盖
        //参数三：原数据路径
        //参数四：目的地路径
        fs.copyFromLocalFile(false,false,new Path("D:\\sunwukong.txt"),new Path("/xiyou/huaguoshan"));
    }

注意参数优先级

• 参数优先级从低到高：hdfs-default.xml —> hdfs-site.xml —> 在项目资源目录下的配置文件 —> 代码里面的配置
• 在上面的文件上传的代码中，没有额外设置副本数，即Replication的值为3
• 假设我们在项目资源目录下新建文件hdfs-site.xml并添加如下内容，那么上传文件后显示的Replication值为1

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="configuration.xsl"?>
<configuration>
	<property>
		<name>dfs.replication</name>
		<value>1</value>
	</property>
</configuration>

• 假设我们继续在init方法中添加如下内容，则上传文件后的Replication值为2

configuration.set("dfs.replication", "2");

2、从HDFS下载文件到本地

    // 文件下载 从HDFS下载数据到本地
    @Test
    public void testGet() throws IOException {
        //参数一：是否删除原文件
        //参数二：原文件的路径（HDFS）
        //参数三：目标地址路径（Win）
        //参数四：是否开启本地校验，true是没有开启校验，最后下载的文件里没有.crc文件
        fs.copyToLocalFile(false,new Path("/xiyou/huaguoshan/sunwukong.txt"),new Path("C:\\sunwukong1.txt"),false);
    }

3、文件删除

    // 删除
    @Test
    public void testRm() throws IOException {
        //参数一：要删除的路径
        //参数二：是否要递归删除
        //fs.delete(new Path("/jdk-8u212-linux-x64.tar.gz"),false);

        //删除非空目录
        fs.delete(new Path("/xiyou"),true);
    }

4、文件更名和移动

    // 文件的更名和移动
    @Test
    public void testmv() throws IOException {
        //文件名称修改
        //参数一：原文件路径
        //参数二：目标文件路径
        //fs.rename(new Path("/input/word.txt"),new Path("/input/SEVENTEEN.txt"));

        //文件的移动和更名
        fs.rename(new Path("/input/SEVENTEEN.txt"),new Path("/CREW.txt"));

        //目录的更名
        fs.rename(new Path("/input"),new Path("/result"));
    }

5、文件详情查看

    // 获取文件详细信息
    @Test
    public void fileDetail() throws IOException {
        // 获取所有文件信息 这是一个迭代器
        RemoteIterator<LocatedFileStatus> listFiles = fs.listFiles(new Path("/"), true);

        //遍历文件
        while (listFiles.hasNext()) {
            LocatedFileStatus fileStatus = listFiles.next();

            System.out.println("===========" + fileStatus.getPath() + "===========");
            System.out.println(fileStatus.getPermission());
            System.out.println(fileStatus.getOwner());
            System.out.println(fileStatus.getGroup());
            System.out.println(fileStatus.getLen());
            System.out.println(fileStatus.getModificationTime());
            System.out.println(fileStatus.getReplication());
            System.out.println(fileStatus.getBlockSize());
            System.out.println(fileStatus.getPath().getName());

            // 获取块信息
            BlockLocation[] blockLocations = fileStatus.getBlockLocations();
            System.out.println(Arrays.toString(blockLocations));
        }
    }

6、文件和文件夹的判断

    // 文件和文件夹判断
    @Test
    public void testFile() throws IOException {
        FileStatus[] listStatus = fs.listStatus(new Path("/"));

        for (FileStatus status : listStatus) {
            if (status.isFile()) {
                System.out.println("文件：" + status.getPath().getName());
            }else {
                System.out.println("目录：" + status.getPath().getName());
            }
        }
    }