HDFS Java API 操作

HDFS Java API操作

Hadoop是使用Java语言编写的,因此使用Java API操作Hadoop文件系统,HDFS Shell本质上就是对Java API的应用,通过编程的形式,操作HDFS,其核心是使用HDFS提供的Java API构造一个访问客户端对象,然后通过客户端对象对HDFS上的文件进行操作(增,删,改,查)

零、启动hadoop

在这里插入图片描述

一、HDFS常见类接口与方法

1、hdfs 常见类与接口

Hadoop 整合了众多文件系统,HDFS只是这个文件系统的一个实例
在这里插入图片描述

2、FileSystem 的常用方法

FileSystem 对象的一些方法可以对文件进行操作
在这里插入图片描述

二、Java 创建Hadoop项目

1、创建文件夹

现在D盘创建一个空的文件夹,HDFS02用来存放hadoop项目
在这里插入图片描述

2、打开Java IDEA

1) 新建项目

点击左上角,新建项目
在这里插入图片描述

2) 选择Maven

选择Maven包管理,记住一定是jdk1.8版本的,然后那个从archetype 不要选择
在这里插入图片描述
然后点击下一步,位置选择刚刚D盘创建的那个HDFS02文件夹,然后点击完成
在这里插入图片描述

三、配置环境

1、添加相关依赖

创建完成之后,进来是一个pom.xml文件
在这里插入图片描述
添加以下的相关的hadoopjunit依赖配置,其中大部分都是有的,主要是<dependencise></dependencise> 这个部分

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>HDFS02</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>18</maven.compiler.source>
        <maven.compiler.target>18</maven.compiler.target>
    </properties>
    <dependencies>
        <dependency>
    <!--hadoop客户端-->
            <groupId>org.apache.hadoop</groupId>
            <artifactId>hadoop-client</artifactId>
            <version>3.3.4</version>
        </dependency>
    <!--单元调试框架-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13.2</version>
        </dependency>
    </dependencies>
    
</project>

然后右上角有一个m的图标,点击一下,加载配置文件,导入包,这个很关键,不然那些包都用不起
在这里插入图片描述
Manen Repository (Maven仓库) http://mvnrepository.com/
在这里插入图片描述
搜索 hadoop在这里插入图片描述
点击 hadoop-client 超链接,然后点击下面的3.3.4
在这里插入图片描述
就可以看到上面在Java里面配置的hadoop的依赖就是这个地方的
在这里插入图片描述

2、创建日志属性文件

resources目录里创建log4j.properties文件
在这里插入图片描述
把下面的配置添加进去
在这里插入图片描述

log4j.rootLogger=stdout, logfile
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/hdfs.log
log4j.appender.logfile.layout=org.apache.log4j.PatternLayout
log4j.appender.logfile.layout.ConversionPattern=%d %p [%c] - %m%n

四、Java API操作

1、在HDFS上创建文件

在 /ied01 目录里创建hadoop.txt 文件
输入命令:hdfs dfs -mkdir /ied01/hadoop.txt
在这里插入图片描述
在webUI界面进行查看
在这里插入图片描述

2、在Java 上创建包

创建net.aex.hdfs包,在包里创建CreateFileOnHDFS
在这里插入图片描述

1) 编写create1()方法

注意导入包的时候一定不要导错了,有些很相似
在这里插入图片描述

package net.aex.hdfs;

import org.apache.hadoop.conf.Configuration;
import java.net.URI;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;
//下面这两个是错的
//import java.nio.file.FileSystem;
//import java.nio.file.Path;


public class CreateFileOnHDFS {
    public static void create1() throws Exception{
        //创建配置对象
        Configuration conf = new Configuration();
        //定义统一资源标识符 (uri: uniform resource identifer)
        String uri = "hdfs://master:9000";
        //创建文件系统对象(基于HDFS的文件系统)
        FileSystem fs = FileSystem.get(new URI(uri),conf);
        //创建路径对象
        Path path = new Path(uri + "/ied01/hadoop.txt");
        //基于路径对象创建文件
        boolean result = fs.createNewFile(path);
        //根据返回值判断文件是否创建成功
        if(result){
            System.out.println("文件[" + path + "创建成功]");
        }else{
            System.out.println("文件[" + path + "创建失败]");
        }
    }

    public static void main(String[] args) throws Exception{
        create1();
    }
}

下面使用main方法 对CreateFileOnHDFS 函数方法进行调用
在这里插入图片描述
运行程序查看结果,创建失败,因为我们之前已经在linux本地 hdfs上创建了这个文件
在这里插入图片描述
此时将这个创建的文件路径改为 /ied02/hadoop02.txt 就成功了
在这里插入图片描述
在webUI界面上进行查看
在这里插入图片描述
注意:在/ied01 目录里确实创建了一个0字节hadoop02.txt文件,有点类似于Hadoop shell 里执行 hdfs dfs -touchz /ied01/hadoop02.txt 但是在linux上面重复执行不会失败,只是会不断改变这个文件的时间戳,但是在Java API里面操作,如果重复执行就会失败

2) 编写create2() 方法

编写create2() 方法,事先判断文件是否已经存在

//create2
    public static void create2() throws Exception{
        //创建配置对象
        Configuration conf = new Configuration();
        //定义统一资源标识符 (uri: uniform resource identifer)
        String uri = "hdfs://master:9000";
        //创建文件系统对象(基于HDFS的文件系统)
        FileSystem fs = FileSystem.get(new URI(uri),conf);
        //创建路径对象
        Path path = new Path(uri + "/ied01/hadoop.txt");
        //判断路径对象指定的文件是否已经存在
        if(fs.exists(path)){
            //提示用户文件已经存在
            System.out.println("文件["+path+"]已经存在!");
        }else {
            //基于路径对象创建文件
            boolean result = fs.createNewFile(path);
            //根据返回值判断文件是否已经创建成功
            if (result){
                System.out.println("文件[" + path + "创建成功!");
            }else{
                System.out.println("文件[" + path + "创建失败!");
            }
        }
    }

使用main方法调用create2() 函数方法,查看程序运行结果,提示文件已经存在
在这里插入图片描述
此时我们怎么才能出现文件创建失败的情况呢,我们故意让HDFS进入安全模式(只能读,不能写)
linux上删除已经创建的/ied01/hadoop02.txt 文件
输入命令: hdfs dfs -rm /ied01/hadoop02.txt
在这里插入图片描述
输入命令:hdfs dfsadmin safemode enter 进入安全模式
在这里插入图片描述
此时,再运行程序,抛出SafeModelException 异常
在这里插入图片描述
修改程序,来处理这个可能会抛出的安全模式异常
使用try catch 来抛出捕获异常
在这里插入图片描述
运行程序,查看结果
在这里插入图片描述
linux 输入命令:hdfs dfsadmin -safemode leave 关闭安全模式
在这里插入图片描述
再运行程序,查看结果 创建成功
在这里插入图片描述

3、在HDFS上写入文件

net.aex.hdfs 包里创建WriteFileOnHDFS
在这里插入图片描述

1) 将数据直接写入HDFS文件

在linux本地 hdfs /ied01目录创建hello.txt文件
在这里插入图片描述

(1)编写write1() 方法

在Java 里创建 write1() 函数方法

package net.aex.hdfs;

import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FSDataOutputStream;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;

import java.net.URI;
import java.nio.charset.StandardCharsets;

public class WriteFileOnHDFS {
    public static void write1() throws Exception{
        //创建配置对象
        Configuration conf = new Configuration();
        //定义统一资源标识符 (uri: uniform resource identifer)
        String uri = "hdfs://master:9000";
        //创建文件系统对象(基于HDFS的文件系统)
        FileSystem fs = FileSystem.get(new URI(uri),conf);
        //创建路径对象
        Path path = new Path(uri + "/ied01/hello.txt");
        //创建文件系统数据字节输出流
        FSDataOutputStream out = fs.create(path);
        //通过字节输出流向文件写入数据
        out.write("Hello hadoop world".getBytes());
        //关闭输出流
        out.close();
        //关闭文件系统对象
        fs.close();
    }

    public static void main(String[] args) throws Exception{
        write1();
    }
}

运行程序,查看结果,报错,没有数据节点可以写入数据
在这里插入图片描述
修改代码,添加一个 设置数据节点主机名属性
在这里插入图片描述
运行1程序,查看结果
在这里插入图片描述
在webUI界面上查看hello.txt 文件
在这里插入图片描述

2) 将本地文件写入HDFS文件

在Java项目根目录创建一个文本文件test.txt
在这里插入图片描述

(1)、编写witer2() 方法

在Java WriteFileOnHDFS类里面创建 write2函数方法
在这里插入图片描述

//write2
    public static void write2() throws Exception{
        //创建配置对象
        Configuration conf = new Configuration();
        //设置数据节点主机名属性
        conf.set("dfs.client.use.datanode.hostname","true");
        //定义统一资源标识符 (uri: uniform resource identifer)
        String uri = "hdfs://master:9000";
        //创建文件系统对象(基于HDFS的文件系统)
        FileSystem fs = FileSystem.get(new URI(uri),conf,"root");
        //创建路径对象
        Path path = new Path(uri + "/ied01/exam.txt");
        //创建文件系统数据字节输出流对象
        FSDataOutputStream out = fs.create(path);
        //创建文字字符输入流对象
        FileReader fr = new FileReader("test.txt");
        //创建缓冲字符输入流对象
        BufferedReader br = new BufferedReader(fr);
        //定义行字符串
        String nextLine = "";
        //通过循环读取缓冲字符输入流
        while ((nextLine=br.readLine()) != null){
            //在控制台输出读取的行
            System.out.println(nextLine);
            //通过文件系统数据字节输出流对象写入指定文件
            out.write(nextLine.getBytes());
        }
        //关闭文件系统字节输出流
        out.close();
        //关闭缓冲字符输入流
        br.close();
        //关闭文件字符输入流
        fr.close();
        //提示用户写入文件成功
        System.out.println("本地文件[test.txt]成功写入[" + path + "]!");
    }

main函数调用write2() 方法,查看结果 写入成功
在这里插入图片描述
其实这个方法的功能就是将本地文件复制(上传)到HDFS,有更简单的处理方法,通过使用一个工具类IOUtils来完成文件的相关操作

(2)、编写write2_2() 方法

在这里插入图片描述

//write2_2()
    public static void write2_2() throws Exception{
        //创建配置对象
        Configuration conf = new Configuration();
        //设置数据节点主机名属性
        conf.set("dfs.client.use.datanode.hostname","true");
        //定义统一资源标识符 (uri: uniform resource identifer)
        String uri = "hdfs://master:9000";
        //创建文件系统对象(基于HDFS的文件系统)
        FileSystem fs = FileSystem.get(new URI(uri),conf,"root");
        //创建路径对象
        Path path = new Path(uri + "/ied01/test.txt");
        //创建文件系统数据字节输出流对象
        FSDataOutputStream out = fs.create(path);
        //创建文字字符输入流对象
        FileInputStream in = new FileInputStream("test");
        //利用IOUtils类提供的字节拷贝方法来复制文件
        IOUtils.copyBytes(in,out,conf);
        //关闭文件字节输入流
        in.close();
        //关闭文件系统字节输入流
        out.close();
        //关闭文件系统
        fs.close();
        //提示用户写入文件成功
        System.out.println("本地文件[test.txt]成功写入[" + path + "]!");
    }

使用main方法,运行write2_2() 函数方法 查看结果 写入成功
在这里插入图片描述
在linux查看hdfs 目录 /ied01/test.txt内容
在这里插入图片描述

4、读取HDFS文件

相当于Shell里的两个命令:hdfs dfs -cathdfs dfs -get
net.aex.hdfs包里创建ReadFileOnHDFS

1) 读取HDFS文件直接在控制台显示

准备读取 /ied01/test.txt 文件
在这里插入图片描述

(1) 编写read1() 方法

在这里插入图片描述

package net.aex.hdfs;

import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FSDataInputStream;
import org.apache.hadoop.fs.FSDataOutputStream;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;

import java.io.BufferedReader;
import java.io.FileReader;
import java.io.InputStreamReader;
import java.net.URI;

public class ReadFileOnHDFS {
    public static void read1() throws Exception{
        //创建配置对象
        Configuration conf = new Configuration();
        //设置数据节点主机名属性
        conf.set("dfs.client.use.datanode.hostname","true");
        //定义统一资源标识符 (uri: uniform resource identifer)
        String uri = "hdfs://master:9000";
        //创建文件系统对象(基于HDFS的文件系统)
        FileSystem fs = FileSystem.get(new URI(uri),conf,"root");
        //创建路径对象(指向目录或文件)
        Path path = new Path(uri + "/ied01/test.txt");
        //创建文件系统数据字节输入流对象
        FSDataInputStream in = fs.open(path);
        //创建缓冲字符输入流对象,提高读取效率(字节流-->字符流-->缓冲流)
        BufferedReader br = new BufferedReader(new InputStreamReader(in));
        //定义行字符串
        String nextLine = "";
        // 通过循环读取缓冲字符输入流
        while ((nextLine=br.readLine())!=null){
            //在控制台输出读取的行内容
            System.out.println(nextLine);
        }
        //关闭缓冲字符输入流
        br.close();
        //关闭文件系统数据字节输入流
        in.close();
        //关闭文件系统
        fs.close();
    }

    public static void main(String[] args) throws Exception{
        read1();
    }
}

使用main方法调用 read1() 函数方法 查看结果 将/ied01/test.txt里的文件读取出来了
在这里插入图片描述
其实我们可以使用IOUtils类来简化代码,创建read_()函数方法
在这里插入图片描述

 //read1_2()
    public static void read1_2() throws Exception{
        //创建配置对象
        Configuration conf = new Configuration();
        //设置数据节点主机名属性
        conf.set("dfs.client.use.datanode.hostname","true");
        //定义统一资源标识符 (uri: uniform resource identifer)
        String uri = "hdfs://master:9000";
        //创建文件系统对象(基于HDFS的文件系统)
        FileSystem fs = FileSystem.get(new URI(uri),conf,"root");
        //创建路径对象(指向目录或文件)
        Path path = new Path(uri + "/ied01/test.txt");
        //创建文件系统数据字节输入流对象
        FSDataInputStream in = fs.open(path);
        //读取文件在控制台显示
        IOUtils.copyBytes(in,System.out,4096,false);
        //关闭文件系统数据字节输入流
        in.close();
        //关闭文件系统
        fs.close();
    }

使用main方法,调用read1_2() 函数方法 查看结果
在这里插入图片描述

2) 读取HDFS文件,保存为本地文件

任务:将/ied01/test.txt 下载到项目下download目录里

(1) 创建read2()方法
//read2()
    public static void read2() throws Exception{
        //创建配置对象
        Configuration conf = new Configuration();
        //设置数据节点主机名属性
        conf.set("dfs.client.use.datanode.hostname","true");
        //定义统一资源标识符 (uri: uniform resource identifer)
        String uri = "hdfs://master:9000";
        //创建文件系统对象(基于HDFS的文件系统)
        FileSystem fs = FileSystem.get(new URI(uri),conf,"root");
        //创建路径对象(指向目录或文件)
        Path path = new Path(uri + "/ied01/test.txt");
        //创建文件系统数据字节输入流对象
        FSDataInputStream in = fs.open(path);
        //创建文件字节输出流
        FileOutputStream out = new FileOutputStream("D:\\HDFS02\\.idea\\download\\exam.txt");
        //读取HDFS文件(靠输入流),写入本地文件(靠输出流)
        IOUtils.copyBytes(in,out,conf);
        //关闭文件系统数据字节输入流
        in.close();
        //关闭文件字节输出流
        in.close();
        //关闭文件系统
        fs.close();
        //提示用户文件下载成功
        System.out.println("文件["+path+"]下载到本地文件[download/exam.txt]!");

    }

使用main方法,调用read2()函数,查看结果 exam.txt 文件已经下载到本地的download目录下了
在这里插入图片描述

5、重命名目录或文件

1) 重命名目录

任务:将/ied01 目录更名为 /lzy01

(1) 编写renameDir() 方法

在这里插入图片描述

package net.aex.hdfs;

import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;

import java.net.URI;

public class RenameDirOnFile {
    public static void renameDir() throws Exception{
        //创建配置对象
        Configuration conf = new Configuration();
        //设置数据节点主机名属性
        conf.set("dfs.client.use.datanode.hostname","true");
        //定义统一资源标识符 (uri: uniform resource identifer)
        String uri = "hdfs://master:9000";
        //创建文件系统对象(基于HDFS的文件系统)
        FileSystem fs = FileSystem.get(new URI(uri),conf);
        //创建源路径对象
        Path sourcePath = new Path("/ied01");
        //创建目标路径对象
        Path targePath = new Path("/lzy01");
        //利用文件系统对象重命名目录
        fs.rename(sourcePath,targePath);
        //关闭文件系统
        fs.close();
        //提示用户目录更名成功
        System.out.println("目录["+sourcePath.getName()+"]更名为目录[" + targePath.getName() + "]!");
    }

    public static void main(String[] args) throws Exception{
        renameDir();
    }
}

使用main方法调用renameDir()函数,查看结果 成功从/ied01 改为 lzy01
在这里插入图片描述
在webUI界面进行查看
在这里插入图片描述

2) 重命名文件

任务:将/lzy01目录下的hello.txt重名为hi.txt
在这里插入图片描述

(1)编写renameFile() 方法

主要需要两个对象的路径然后通过文件系统.rename()方法,把两个文件路径放进去进行更改

 public static void renameFile() throws Exception{
        //创建配置对象
        Configuration conf = new Configuration();
        //定义统一资源标识符 (uri: uniform resource identifer)
        String uri = "hdfs://master:9000";
        //创建文件系统对象(基于HDFS的文件系统)
        FileSystem fs = FileSystem.get(new URI(uri),conf);
        //创建源路径对象
        Path sourcePath = new Path("/lzy01/hello.txt");//目标对象
        //创建目标路径对象(指向文件)
        Path targePath = new Path("/lzy01/hi.txt");
        //利用文件系统重命名文件
        fs.rename(sourcePath,targePath);
        //关闭文件系统
        fs.close();
        //提示用户更更名成功
        System.out.println("文件[" + sourcePath.getName() + "]更名文件[" + targePath.getName() + "]!");
    }

使用main方法调用renameFile()方法,查看结果 更名成功
在这里插入图片描述
在这里插入图片描述

6、显示文件列表

net.aex.hdfs 包里创建ListHDFSFiles

1) 显示指定目录下文件全部信息

任务:显示/lzy01 目录下的文件列表
在这里插入图片描述

(1)、编写list1() 方法
package net.aex.hdfs;

import jdk.jshell.execution.LoaderDelegate;
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.LocatedFileStatus;
import org.apache.hadoop.fs.Path;
import org.apache.hadoop.fs.RemoteIterator;

import java.net.URI;

public class ListHDFSFile {
    public static void list1() throws Exception{
        //设置配置对象
        Configuration conf = new Configuration();
        //设置数据节点主机名属性
        conf.set("dfs.client.use.datanode.hostname","true");
        //定义统一资源标识符 (uri: uniform resource identifer)
        String uri = "hdfs://master:9000";
        //创建文件系统对象(基于HDFS的文件系统)
        FileSystem fs = FileSystem.get(new URI(uri),conf,"root");
        //创建远程迭代器对象,泛型是位置文件状态类(相当于`hdfs dfs -ls -R /lzy01`)
        RemoteIterator<LocatedFileStatus> ri = fs.listFiles(new Path("/lzy01"),true);
        //遍历远程迭代器
        while (ri.hasNext()){
            System.out.println(ri.next());

        }

    }

    public static void main(String[] args) throws Exception{
        list1();

    }
}

使用main 方法,调用list1() 方法 查看结果 这些hdfs /lzy01 目录下的文件都读取出来了
在这里插入图片描述上述文件状态对象封装的有关信息,可以通过相应的方法来获取,比如getPath() 方法就可以获取路径信息,getLen()方法就可以获取文件长度信息

2) 显示指定目录下文件路径和长度信息
(1) 编写list2() 方法
//list2()
    public static void list2() throws Exception{
        //创建配置对象
        Configuration conf = new Configuration();
        //设置数据节点主机名属性
        conf.set("dfs.client.use.datanode.hosename","true");
        //定义uri字符串
        String uri = "hdfs://master:9000";
        //创建文件系统对象
        FileSystem fs = FileSystem.get(new URI(uri),conf,"root");
        //创建远程迭代器对象,泛型是位置文件状态类(相当于`hdfs dfs -ls -R /lzy01`)
        RemoteIterator<LocatedFileStatus> ri = fs.listFiles(new Path("/lzy01"),true);
        //遍历远程迭代器
        while (ri.hasNext()){
            LocatedFileStatus lfs = ri.next();
            System.out.println(lfs.getPath() + "" + lfs.getLen() +  "字节");
        }
    }

使用main方法调用list2() 方法,查看结果 /lzy01目录下的文件的字节都显示出来了
在这里插入图片描述

7、获取文件块信息

任务:获取/lzy01/hadoop-3.3.4.tar.gz文件块信息在这里插入图片描述
hadoop压缩包会分割成6个文件块
在这里插入图片描述
net.aex.hdfs包里创建GetBlockLocations

  • 3
    点赞
  • 62
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值