1. 【实验介绍】
1. 实验内容
本实验利用 Hadoop 提供的 Java API 进行编程对 HDFS 进行操作。
-
实验目标
通过本实验掌握利用 Hadoop 提供的 Java API 进行编程对 HDFS 进行操作。
-
实验知识点
Hadoop Java API
HDFS 目录操作
-
实验环境
Hadoop 2.7.1
Eclipse 4.8.0
CourseGrading在线实验环境
-
预备知识
Hadoop 基本操作
MapReduce 编程基础
HDFS 基本操作
Java 编程基础
2. 【实验原理】HDFS文件系统编程框架
1. 【实验原理】HDFS文件系统编程框架以下代码为HDFS文件系统的编程框架:
01 import org.apache.hadoop.conf.Configuration;
02 import org.apache.hadoop.fs.FileSystem;
04 public class FileExist {
05 public static void main(String[] args) {
06 try {
07 Configuration conf = new Configuration();
08 FileSystem fs = FileSystem.get(conf);
09 }catch(Exception e) {
10 e.printStackTrace();
11 }
12 }
13 }
上述代码的第7行到第8行为根据配置(Configuration)创建文件系统。文件编程的接口大多都是基于FileSystem类提供的方法进行的,在获得fs对象后,就可以对文件进行操作了。
FileSystem类中各方法的详细含义可参考:FileSystem (Apache Hadoop Main 3.3.1 API)
3. 【环境准备】
1. 【环境准备】### 快捷部署
集群版的大数据实验支持一键快捷部署,自动完成前期的部署工作。具体操作如下
1. 启动命令终端
右键桌面,进入命令终端。
2.输入启动命令
在终端中输入./setuphadoop
后,按Enter键,启动一键部署工具。
3.在部署过程中的操作
在执行到下图的步骤时,需要按下两次Enter键继续执行。
4.部署完成
到下图步骤时,部署工具已执行完成。
5.验证是否部署成功
打开浏览器,访问172.18.0.2:50070
,点击Datanodes栏目,查看三个slave节点是否在线。
此时集群已经部署完毕,可以继续进行实验了。
4. 【实验准备】
1. 【实验准备】# 创建工作目录
本实验的工作目录为~/course/hadoop/hdfs_pro
,使用以下命令创建和初始化工作目录:
$ mkdir -p ~/course/hadoop/hdfs_pro
$ cd ~/course/hadoop/hdfs_pro
安装部署Hadoop集群
参考《Hadoop安装部署》实验,安装有三个数据节点的Hadoop集群
创建eclipse工程
接下来创建eclipse工程:
在终端输入eclipse&
命令从后台启动Eclipse IDE环境。
依次点击:File->New->Project->Map/Reduce Project->Next
。
在项目名称(Project Name)处填入hdfs_pro
,将工程位置选择为本实验的工作目录,再点击Finish
。
如下图所示:
如果需要设置hadoop路径,点击Configure Hadoop install directory...
,选择hadoop路径为/headless/dev/hadoop-2.7.1
,如下所示:
5. 【实验步骤】目录的相关操作
1. 【实验步骤】目录的相关操作# 一、创建目录
1、相关接口说明
创建目录可以使用FileSystem
的mkdirs
方法,该方法的含义如下:
-
函数原型:
public boolean mkdirs(Path f) throws IOException
-
函数功能:调用该方法,根据f指定的路径创建目录。目录的权限为默认权限。
-
参数说明:
f
,Path
对象。表示要创建的目录的路径。 -
返回值:如果目录成功创建,返回
true
。 -
异常:如果遇到IO故障,抛出
IOException
异常。
mkdirs还有一个带有目录权限参数的版本,其原型为:
public abstract boolean mkdirs(Path f, FsPermission permission) throws IOException
2、完整实验代码
将 hdfs_pro
项目下 src
目录新建名为 CreateDir
的类
(选中src
文件夹->File->new->Class->
在name
选项中填入 CreateDir->Finish
)
该实验的完整实验代码如下:
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;
public class CreateDir {
public static void main(String[] args) {
try {
Configuration conf = new Configuration();
FileSystem fs = FileSystem.get(conf);
String dirPath = args[0]; // 新建目录的路径由外部传入
Path hdfsPath = new Path(dirPath);
if(fs.mkdirs(hdfsPath)){
System.out.println("Directory "+ dirPath +" has been created successfully!");
}
}catch(Exception e) {
e.printStackTrace();
}
}
}
将该代码拷贝到CreateDir.java
文件中。如下图所示:
以上代码中主要调用fs
的mkdirs
方法来创建目录,如果目录创建成功,会输出相应提示信息。
3、运行结果分析
在CreateDir.java
上,点击右键,选择Export
,导出 Jar 包。
注意选择导出的路径为本实验的工作目录。
最后设置MainClass
新建一个终端,切换到jar包所在的目录,然后将导出的jar包传到master节点上。
cd ~/course/hadoop/hdfs_pro
cp CreateDir.jar /cgsrc
进入master节点,查看hdfs文件系统上当前目录下的内容,然后输入如下hadoop jar命令创建目录,最后再查看是否创建成功:
docker exec -it --privileged master /bin/bash
hadoop fs -ls .
hadoop jar /cgsrc/CreateDir.jar newdir
hadoop fs -ls .
运行结果的截图如下:
如图所示,目录newdir
已经被成功创建。
二、目录存在性判断
1、相关接口说明
判断文件是否存在需要使用FileSystem
的exists
方法,该方法的详细含义如下:
方法名:exists
方法原型:public boolean exists(Path f) throws IOException
接口功能:检查某个路径所指的目录是否存在。
接口说明:参数f
的含义为源路径。如果目录存在,返回值为true
。如果IO故障会抛出IOException
异常。
2、完整实验代码
将 hdfs_pro
项目下src
目录新建名为DirExist
的类
(选中src
文件夹->File->new->Class->
在name
选项中填入 DirExist->Finish
)
该实验的完整代码如下所示:
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;
public class DirExist {
public static void main(String[] args) {
try {
Configuration conf = new Configuration();
FileSystem fs = FileSystem.get(conf);
String dirName = args[0];
if(fs.exists(new Path(dirName ))) {
System.out.println("Directory Exists!");
} else {
System.out.println("Directory not Exists!");
}
}catch(Exception e) {
e.printStackTrace();
}
}
}
3、运行结果分析
使用和上一节相同的方法导出 DirExist.jar
,并导出到master节点上,并在master节点上使用如下hadoop jar命令提交运行。
hadoop jar /cgsrc/DirExist.jar newdir
结果如下:
如图所示,程序判断无误。
三、列出目录中的内容
1、相关接口说明
在HDFS文件系统上浏览某个目录中子文件和子目录时,需要使用FileSystem
类提供的listStatus
方法,该方法将返回该目录下所有子文件和子目录的详细信息,包括文件的长度、块大小、备份数、修改时间、所有者以及权限等信息,这些信息都被封装在FileStatus
对象中。调用listStatus
方法时需要提供目录的路径,listStatus
方法的详细说明如下:
函数原型:public abstract FileStatus[] listStatus(Path f) throws FileNotFoundException, IOException
函数功能:根据输入参数f
所指定的目录,列出该目录下所有子文件/子目录的详细信息。注意,该接口不保证返回的文件/目录信息是有序的。
函数参数:f
,指定目录的路径。
返回值:f
所指定的目录下所有子文件/子目录的详细信息。
异常:两种异常,FileNotFoundException
和IOException
。当所指定的目录不存在时,抛出FileNotFoundException
异常。当遇到IO故障时,返回IOException
异常。
2、完整实验代码
将 hdfs_pro
项目下 src
目录新建名为 ListFiles
的类
(选中src
文件夹->File->new->Class->
在name
选项中填入 ListFiles->Finish
)
该实验的完整代码如下:
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FileStatus;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.FileUtil;
import org.apache.hadoop.fs.Path;
public class ListFiles {
public static void main(String[] args) {
try {
Configuration conf = new Configuration();
FileSystem fs = FileSystem.get(conf);
String filePath = args[0];
Path srcPath = new Path(filePath);
FileStatus[] stats = fs.listStatus(srcPath);
Path[] paths = FileUtil.stat2Paths(stats);
for(Path p : paths)
System.out.println(p.getName());
}catch(Exception e) {
e.printStackTrace();
}
}
}
3、运行结果分析
使用和上节相同的方法导出 ListFiles.jar
,并导出到master节点上,并在master节点上使用如下hadoop jar命令提交运行。
hadoop jar ListFiles.jar .
运行结果如下:
如图,程序成功列出了mydir
目录下的所有文件。(如果当前目录没有newDir
文件夹,可使用前面步骤提到的方法创建该文件夹,再进入该文件夹下继续创建文件夹,最后退出该文件夹后运行该jar包查看实验效果)。
四、删除目录
1、相关接口说明
删除文件可以使用FileSystem
的delete
接口,该接口的含义如下:
-
函数原型:
public abstract boolean delete(Path f,boolean recursive) throws IOException
-
函数功能:删除文件或者目录。
-
参数说明:
f
,要删除的文件或者目录的路径。recursive
,是否需要递归删除。如果是删除目录的话,将该参数设置为true
。否则,设置为false
. -
返回值:如果成功删除,则返回
true
。否则,返回false
。 -
如果遇到IO故障,会抛出
IOException
。
2、完整实验代码
将 hdfs_pro
项目下 src
目录新建名为DeleteDir
的类
(选中src
文件夹->File->new->Class->
在name
选项中填入 DeleteDir->Finish
)
该实验的完整代码如下所示:
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;
public class DeleteDir {
public static void main(String[] args) {
try {
Configuration conf = new Configuration();
FileSystem fs = FileSystem.get(conf);
String dirPath = args[0];
Path hdfsPath = new Path(dirPath);
if(fs.delete(hdfsPath,true)){
System.out.println("Directory "+ dirPath +" has been deleted successfully!");
}
}catch(Exception e) {
e.printStackTrace();
}
}
}
3、运行结果分析
使用和上节相同的方法导出DeleteDir.jar
,并导出到master节点上,并在master节点上使用如下hadoop jar命令提交运行。
hadoop jar DeleteDir.jar newdir
运行结果如下:
可以看到,上一节创建的 newdir
目录被成功删除。
6. 【实验步骤】文件的相关操作
1. 【实验步骤】文件的相关操作# 一、创建文件
1、相关接口说明
使用FileSystem
的create
函数可以创建文件,根据参数的不同,create
函数有以下几种重载类型:
public FSDataOutputStream create(Path f) throws IOException
public FSDataOutputStream create(Path f,boolean overwrite) throws IOException
public FSDataOutputStream create(Path f,Progressable progress) throws IOException
public FSDataOutputStream create(Path f,short replication) throws IOException
public FSDataOutputStream create(Path f,short replication,Progressable progress) throws IOException
public FSDataOutputStream create(Path f,boolean overwrite,int bufferSize) throws IOException
public FSDataOutputStream create(Path f,boolean overwrite,int bufferSize,Progressable progress) throws IOException
public FSDataOutputStream create(Path f,boolean overwrite,int bufferSize,short replication,long blockSize) throws IOException
public FSDataOutputStream create(Path f,boolean overwrite,int bufferSize,short replication,long blockSize,Progressable progress)throws IOException
public abstract FSDataOutputStream create(Path f,FsPermission permission,boolean overwrite,int bufferSize,short replication,long blockSize,Progressable progress) throws IOException
public FSDataOutputStream create(Path f,FsPermission permission,EnumSet<CreateFlag> flags,int bufferSize,short replication,long blockSize,Progressable progress) throws IOException
public FSDataOutputStream create(Path f,FsPermission permission,EnumSet<CreateFlag> flags,int bufferSize, short replication,long blockSize,Progressable progress, org.apache.hadoop.fs.Options.ChecksumOpt checksumOpt) throws IOException
上述接口中,各参数的含义分别如下:
f
,要打开的文件名,默认会覆盖已经存在的文件。
overwrite
,如果要创建的文件已经存在,是否覆盖。设置为true
时,覆盖;为false
时,不覆盖。
progress
,用于汇报进度信息。
replication
,设置文件块的副本数量。
bufferSize
,所使用的缓冲区的大小。
blockSize
,块大小。
permission
,设置文件的权限。
flags
,指定文件创建标志,文件创建标志包括:CREATE
,APPEND
,OVERWRITE
,SYNC_BLOCK
,LAZY_PERSIST
,APPEND_NEWBLOCK
等。
2、完整实验代码
将 hdfs_pro
项目下 src
目录新建名为 CreateFile
的类
(选中src
文件夹->File->new->Class->
在name
选项中填入CreateFile->Finish
)
此次实验的完整代码如下所示:
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;
public class CreateFile {
public static void main(String[] args) {
try {
Configuration conf = new Configuration();
FileSystem fs = FileSystem.get(conf);
String filePath = args[0];
Path hdfsPath = new Path(filePath);
fs.create(hdfsPath);
}catch(Exception e) {
e.printStackTrace();
}
}
}
3、运行结果分析
使用和上节相同的方法导出 CreateFile.jar
,并导出到master节点上,并在master节点上使用如下hadoop jar命令提交运行(执行命令前记得切换到CreateFile.jar
所在目录/cgsrc
,后续步骤不再赘述)。
hadoop jar CreateFile.jar newfile.txt
运行结果如下:
如图所示,文件已经成功被创建。
二、文件存在性判断
1、相关接口说明
判断文件是否存在需要使用FileSystem
的exists
方法,该方法的详细含义如下:
方法名:exists
方法原型:public boolean exists(Path f) throws IOException
接口功能:检查某个路径所指的文件是否存在。
接口说明:参数f
的含义为源路径。如果文件存在,返回值为true
。如果IO故障会抛出IOException
异常。
2、完整实验代码
该实验的完整代码如下:
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;
public class FileExist {
public static void main(String[] args) {
try {
Configuration conf = new Configuration();
FileSystem fs = FileSystem.get(conf);
String fileName = args[0];
if(fs.exists(new Path(fileName))) {
System.out.println("File Exists!");
} else {
System.out.println("File not Exists!");
}
}catch(Exception e) {
e.printStackTrace();
}
}
}
3、运行结果分析
导出FileExist.jar
后,并导出到master节点上,并在master节点上使用如下hadoop jar命令提交运行。
hadoop jar FileExist.jar newfile.txt
运行结果如下:
可以发现newfile.txt
存在。
三、文件写
1、相关接口说明
HDFS不支持文件的随机写,写文件的方式有两种:1)文件不存在,创建文件之后,开始对文件的内容进行写入。2)文件存在,打开文件,在文件尾部追加写。
对于第一种方式,由于调用create
方法后会返回FSDataOutputStream
对象,使用该对象对文件进行写操作。第二种方式,使用FileSystem
类的append
接口,该接口也会返回FSDataOutputStream
对象,同样使用该对象可对文件进行追加操作。
create
方法在文件创建实验中已经进行了详细说明,这里对FSDataOutputStream
的相关常用方法进行说明,FSDataOutputStream
有三个常用的方法,分别为write
,flush
,close
函数。write
将数据写入到文件中,flush
将数据缓存在内存中的数据更新到磁盘,close
则关闭流对象。
FileSystem
的append
函数详细说明如下:
函数原型:public FSDataOutputStream append(Path f) throws IOException
函数功能:在一个已经存在的文件尾部追加数据。
函数参数:f
,文件路径。
返回值:FSDataOutputStream
对象。
异常:遇到IO故障时,抛出IOException
异常。
2、完整实验代码
将hdfs_pro
项目下 src
目录新建名为 WriteFile
的类
(选中src
文件夹依次点击File->new->Class
,在name
选项中填入WriteFile
,最后点击Finish
)
该实验的完整代码如下所示:
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FSDataOutputStream;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;
public class WriteFile {
public static void main(String[] args) {
try {
Configuration conf = new Configuration();
FileSystem fs = FileSystem.get(conf);
String filePath = args[0];
Path srcPath = new Path(filePath);
FSDataOutputStream os = fs.create(srcPath,true,1024,(short)1,(long)(1<<26));
String str = "Hello, this is a sentence that should be written into the file.\n";
os.write(str.getBytes());
os.flush();
os.close();
os = fs.append(srcPath);
str = "Hello, this is another sentence that should be written into the file.\n";
os.write(str.getBytes());
os.flush();
os.close();
}catch(Exception e) {
e.printStackTrace();
}
}
}
该代码中,文件的写入分为两部分,第一部分使用create
返回的FSDataOutputStream
对象进行写入,第二部分使用append
返回的FSDataOutputStream
对象进行写入。
3、运行结果分析
导出 WriteFile.jar
后,并导出到master节点上,并在master节点上使用如下hadoop jar命令提交运行。
hadoop jar WriteFile.jar WriteFile newfile.txt
运行结果如下:
如图所示,文件成功写入。
四、文件读
1、相关接口说明
如果要读取HDFS
上的文件,可以使用open
方法。open
方法会返回一个FSDataInputStream
对象,使用该对象可对文件进行读操作。open
函数详细说明如下:
函数原型:public FSDataInputStream open(Path f) throws IOException
函数功能:打开Path
对象f
指定的路径的文件。
参数说明:f
,要打开的文件。
返回值:FSDataInputStream
对象,利用FSDataInputStream
对象可对文件进行读操作。
异常:遇到IO故障时,将抛出IOException
。
open
方法还有一个带有bufferSize
参数的重载版本,该方法的原型为:
public abstract FSDataInputStream open(Path f,int bufferSize) throws IOException
其中,bufferSize
的含义为读取过程中所使用的缓冲区的大小。
2、完整实验代码
将 hdfs_pro
项目下 src
目录新建名为 ReadFile
的类
(选中src
文件夹->File->new->Class->
在name
选项中填入ReadFile->Finish
)
该实验的完整代码如下:
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;
public class ReadFile {
public static void main(String[] args) {
try {
Configuration conf = new Configuration();
FileSystem fs = FileSystem.get(conf);
String filePath = args[0];
Path srcPath = new Path(filePath);
FSDataInputStream is = fs.open(srcPath);
while(true) {
String line = is.readLine();
if(line == null) {
break;
}
System.out.println(line);
}
is.close();
}catch(Exception e) {
e.printStackTrace();
}
}
}
3、运行结果分析 导出ReadFile.jar
后,并导出到master节点上,并在master节点上使用如下hadoop jar命令提交运行。
hadoop jar ReadFile.jar newfile.txt
运行结果如下:
如图,文件中的内容成功被读取。
五、文件重命名
1、相关接口说明
文件重命名可以使用FileSystem
的rename
方法,该方法的详细说明如下:
函数原型:public abstract boolean rename(Path src,Path dst)throws IOException
函数功能:将路径src
重命名为路径dst
。
参数:src
,将被重命名的路径。dst
,重命名后的路径。
返回值:如果重命名成功,返回true
;否则,返回false
;
异常:如果遇到IO故障,抛出IOException
异常。
2、完整实验代码
将 hdfs_pro
项目下 src
目录新建名为 Rename
的类
(选中src
文件夹->File->new->Class->
在name
选项中填入Rename->Finish
)
该实验的完整代码如下:
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;
public class Rename {
public static void main(String[] args) {
try {
Configuration conf = new Configuration();
FileSystem fs = FileSystem.get(conf);
String srcStrPath = args[0];
String dstStrPath = args[1];
Path srcPath = new Path(srcStrPath);
Path dstPath = new Path(dstStrPath);
if(fs.rename(srcPath,dstPath)) {
System.out.println("rename from " + srcStrPath + " to " + dstStrPath + "successfully!");
}
}catch(Exception e) {
e.printStackTrace();
}
}
}
3、运行结果分析
导出 Rename.jar
后,并导出到master节点上,并在master节点上使用如下hadoop jar命令提交运行。
hadoop jar Rename.jar newfile.txt file.txt
运行结果如下:
如图可以发现文件已经重命名。
六、文件删除
1、相关接口说明
删除文件可以使用FileSystem
的delete
接口,该接口的含义如下:
-
函数原型:
public abstract boolean delete(Path f,boolean recursive) throws IOException
-
函数功能:删除文件或者目录。
-
参数说明:
f
,要删除的文件或者目录的路径。recursive
,是否需要递归删除。如果是删除目录的话,将该参数设置为true
。否则,设置为false
. -
返回值:如果成功删除,则返回
true
。否则,返回false
。 -
如果遇到IO故障,会抛出
IOException
。
2、完整实验代码
将 hdfs_pro
项目下 src
目录新建名为 DeleteFile
的类
(选中src
文件夹->File->new->Class->
在name
选项中填入DeleteFile->Finish
)
该实验的完整代码如下:
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;
public class DeleteFile {
public static void main(String[] args) {
try {
Configuration conf = new Configuration();
FileSystem fs = FileSystem.get(conf);
String filePath = args[0];
Path hdfsPath = new Path(filePath);
if(fs.delete(hdfsPath,false)){
System.out.println("File "+ filePath +" has been deleted successfully!");
}
}catch(Exception e) {
e.printStackTrace();
}
}
}
3、运行结果分析
导出 DeleteFile.jar
后,并导出到master节点上,并在master节点上使用如下hadoop jar命令提交运行。
hadoop jar DeleteFile.jar file.txt
运行结果如下:
file.txt
已经被删除。
7. 【实验作业1】自己动手实现HDFS Shell
1. 【实验作业1】自己动手实现HDFS Shell基于已经学习到的Hadoop API编程知识,自己动手实现一个简单的HDFS Shell程序,程序名称为HShell,要求能够支持以下功能:
1.使用HShell -cp 本地路径 HDFS路径
,将文件从Linux本地文件系统拷贝到HDFS指定路径上。
2.使用HShell -rm 路径
删除文件
3.使用HShell -rm -r 路径
删除目录
4.使用HShell -cp -r 本地目录路径 HDFS路径
,将目录从Linux本地拷贝到HDFS指定路径上。
5.使用HShell -list 路径
显示某个文件的信息或者某个目录的信息
6.使用HShell -mv 路径 路径
移动文件或者重命名文件
7.使用HShell -find 文件名 目录
实现在目录下递归查找某个文件名的文件。