借助Maven搭建Hadoop开发环境的最详细教程分享

在Maven插件的帮助下,VSCode写Java其实非常方便。这一讲我们介绍如何借助maven用VScode搭建Hadoop开发环境。

1.Java环境安装

首先我们需要搭建好Java开发环境。我们需要从网站 https://www.oracle.com/java/technologies/downloads/ 下载指定版本的Java压缩包或安装包。压缩包需要解压到机器的指定目录,安装包直接傻瓜式安装即可。我这里下载的是Java17的MACOS安装包,运行后它默认给我安装在了/Library/Java/JavaVirtualMachines/temurin-17.jdk/目录下。

然后配置环境变量,Mac用户在~/.zshrc中添加:

  1. export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin17.jdk/Contents/Home

然后source ~/.zshrc即可(linux用户我没记错的话应该是~/.bashrc文件)。

可以运行java -version命令查看当前机器的Java版本。

  1. (base) lonelyprince7@lonelyprince7deMacBookPro ~ % java version
  2. openjdk version “17” 20210914
  3. OpenJDK Runtime Environment Temurin17+35 (build 17+35)
  4. OpenJDK 64Bit Server VM Temurin17+35 (build 17+35, mixed mode)

然后读者需要在VSCode中安装以下Java插件:

-1

其中需要注意,Maven for Java插件是用来构建Java大型项目的(也就是说不只是使用JRE内部的包,而且使用外包的JDK包。内部的包用java命令编译的时候就会自动帮我们导入,但外部的包要稍微复杂一些,最简单的方式就是使用maven工具了)。

2.安装Maven

如果你是Mac系统且安装了homebrew,可以直接下列命令运行安装

  1. brew install maven

你也可以前往Maven官网 https://maven.apache.org/download.cgi 下载并解压到自定义目录。

安装完后记得配置环境变量:

  1. export M2_HOME=/opt/homebrew/Cellar/maven/3.8.2/libexec
  2. export PATH=${PATH}:${M2_HOME}/bin

此处/opt/homebrew/Cellar/maven/3.8.2/libexec是我的maven安装位置,修改成你实际的自定义目录即可。

然后source ~/.zshrc即可(同样,Linux用户应该是~/.bashrc文件)。

运行mvn -version可以查看maven版本。

(base) orion-orion@MacBook-Pro libexec % mvn -version
Apache Maven 3.8.2 (3599d3414f046de2324203b78ddcf9b5e4388aa0)
Maven home: /opt/homebrew/Cellar/maven/3.8.2/libexec
Java version: temurin-17, vendor: Oracle Corporation, runtime: /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
Default locale: zh_CN_#Hans, platform encoding: UTF-8
OS name: “mac os x”, version: “12.3.1”, arch: “aarch64”, family: “mac”

3.新建Maven项目

首先,用VSCode打开一个存放用于项目的目录(在我电脑上是 "/Users/lonelyprince7/Documents/LocalCode/Hadoop-MapReduce" ),然后在右键菜单中选择从Maven原型中创建新项目。

-2

然后从下拉选单中选择“maven-archetype-quickstart”。

-3

然后随便选择一个版本即可。

-4

然后再输入组织的名称(该名称在将你的项目打包发布有用)。组织名称一般命名为`com.×××`,这里我命名为`com.orion`。注意组织名称只能由小写字符和下换线组成,不能包括大写字符和空格之类的东西。

-5

接下来输入工程(archetype)的名称,这里我们命名为”hello_world”即可。

-6

然后我们的工程目录就选择 "/Users/lonelyprince7/Documents/LocalCode/Hadoop-MapReduce" 就行。

-7

之后VSCode会提示是否跳转到”hello_world”工程的目录,选择“是”,然后就退跳转到该目录。

进入该目录后,我们会发现控制台正在初始化Maven配置,有以下打印输出:

-8

其中,会跳出一些选项让我们选择,我们只需要全部按回车选择默认值即可。

-9

最后,我们看到项目”hello_world”成功创建,项目目录如下:

-10

4.进行测试

我们可以看到App.java已经为我们生成,为如下内容:

  1. package com.orion;
  2. /**
  3.      * Hello world!
  4.      *
  5.      */
  6. public class App
  7. {
  8.      public static void main( String[] args )
  9.      {
  10.          System.out.println( “Hello World!” );
  11.      }
  12. }

pom.XML只引入了最基本的junit依赖包,并配置了一些基本的Maven项目初始化的内容:

  1. <?xml version=“1.0” encoding=“UTF-8”?>
  2. <project xmlns=“http://maven.apache.org/POM/4.0.0” xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance”
  3.      xsi:schemaLocation=“http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd”>
  4.      <modelVersion>4.0.0</modelVersion>
  5.      <groupId>com.orion</groupId>
  6.      <artifactId>hello_world</artifactId>
  7.      <version>1.0-SNAPSHOT</version>
  8.      <name>hello_world</name>
  9.      <!– FIXME change it to the project’s website –>
  10.      <url>http://www.example.com</url>
  11.      <properties>
  12.      <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  13.      <maven.compiler.source>1.7</maven.compiler.source>
  14.      <maven.compiler.target>1.7</maven.compiler.target>
  15.      </properties>
  16.      <dependencies>
  17.      <dependency>
  18.          <groupId>junit</groupId>
  19.          <artifactId>junit</artifactId>
  20.          <version>4.11</version>
  21.          <scope>test</scope>
  22.      </dependency>
  23.      </dependencies>
  24.      <build>
  25.      <pluginManagement><!– lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) –>
  26.          <plugins>
  27.          <!– clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle –>
  28.          <plugin>
  29.              <artifactId>maven-clean-plugin</artifactId>
  30.              <version>3.1.0</version>
  31.          </plugin>
  32.          <!– default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging –>
  33.          <plugin>
  34.              <artifactId>maven-resources-plugin</artifactId>
  35.              <version>3.0.2</version>
  36.          </plugin>
  37.          <plugin>
  38.              <artifactId>maven-compiler-plugin</artifactId>
  39.              <version>3.8.0</version>
  40.          </plugin>
  41.          <plugin>
  42.              <artifactId>maven-surefire-plugin</artifactId>
  43.              <version>2.22.1</version>
  44.          </plugin>
  45.          <plugin>
  46.              <artifactId>maven-jar-plugin</artifactId>
  47.              <version>3.0.2</version>
  48.          </plugin>
  49.          <plugin>
  50.              <artifactId>maven-install-plugin</artifactId>
  51.              <version>2.5.2</version>
  52.          </plugin>
  53.          <plugin>
  54.              <artifactId>maven-deploy-plugin</artifactId>
  55.              <version>2.8.2</version>
  56.          </plugin>
  57.          <!– site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle –>
  58.          <plugin>
  59.              <artifactId>maven-site-plugin</artifactId>
  60.              <version>3.7.1</version>
  61.          </plugin>
  62.          <plugin>
  63.              <artifactId>maven-project-info-reports-plugin</artifactId>
  64.              <version>3.0.0</version>
  65.          </plugin>
  66.          </plugins>
  67.      </pluginManagement>
  68.      </build>
  69. </project>

选中App.java文件按F5进行编译并运行,看到控制台成功打印Hello World!

(base) lonelyprince7@lonelyprince7deMacBook-Pro hello_world %  /usr/bin/env /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home/bin/java -agentlib:jdwp=transport=dt_socket,server=n,suspend=y,address=localhost:50684 -XX:+ShowCodeDetailsInExceptionMessages -cp /Users/lonelyprince7/Documents/LocalCode/Hadoop-MapReduce/hello_world/target/classes com.orion.App
Hello World!

我们接下来试试用Maven导入Hadoop依赖。我们只需要在pom.xml依赖项就行。相关的依赖项的名称和版本号我们可以在Maven仓库的官网 https://mvnrepository.com/ 进行查询,比如我们可以查询到Hadoop-common(3.3.1)版本的依赖项如下:

-11

一般来说,Hadoop项目需要引入hadoop-common、hadoop-hdfs、hadoop-client、hadoop-yarn-api这几个api,我们需要将下列标签加入<dependencies> <dependencies/>之间,也即:

  1. <dependencies>
  2.      <dependency>
  3.          <groupId>junit</groupId>
  4.          <artifactId>junit</artifactId>
  5.          <version>4.11</version>
  6.          <scope>test</scope>
  7.      </dependency>
  8.      <!– 导入hadoop依赖环境 –>
  9.      <dependency>
  10.          <groupId>org.apache.hadoop</groupId>
  11.          <artifactId>hadoop-common</artifactId>
  12.          <version>3.3.1</version>
  13.      </dependency>
  14.      <dependency>
  15.          <groupId>org.apache.hadoop</groupId>
  16.          <artifactId>hadoop-hdfs</artifactId>
  17.          <version>3.3.1</version>
  18.      </dependency>
  19.      <dependency>
  20.          <groupId>org.apache.hadoop</groupId>
  21.          <artifactId>hadoop-mapreduce-client-core</artifactId>
  22.          <version>3.3.1</version>
  23.      </dependency>
  24.      <dependency>
  25.          <groupId>org.apache.hadoop</groupId>
  26.          <artifactId>hadoop-client</artifactId>
  27.          <version>3.3.1</version>
  28.      </dependency>
  29.      <dependency>
  30.          <groupId>org.apache.hadoop</groupId>
  31.          <artifactId>hadoop-yarn-api</artifactId>
  32.          <version>3.3.1</version>
  33.      </dependency>
  34.      </dependencies>

但是聪明的逆可能已经注意到了,这样版本号就完全属于“硬编码”了。后期我要修改hadoop的版本号,只能把上面的挨个修改,非常麻烦。好在我们在<properties></properties>标签之间先集中定义好一些后面要使用的常量(比如版本号),后面再使用${变量名}的形式来引用即可。如我们将hadoop的版本号hadoop.version追加到<properties></properties>标签之间:

  1.      <!– 集中定义版本号 –>
  2.      <properties>
  3.      <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  4.      <maven.compiler.source>1.7</maven.compiler.source>
  5.      <maven.compiler.target>1.7</maven.compiler.target>
  6.      <hadoop.version>3.3.1</hadoop.version> <!–这里追加hadoop版本号–>
  7.      </properties>

然后后面我们就可以使用${hadoop.version}来替代前面频繁出现的3.3.1了。

最后给出我们完整的pom.xml文件:

  1. <?xml version=“1.0” encoding=“UTF-8”?>
  2. <project xmlns=“http://maven.apache.org/POM/4.0.0” xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance”
  3.      xsi:schemaLocation=“http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd”>
  4.      <modelVersion>4.0.0</modelVersion>
  5.      <groupId>com.orion</groupId>
  6.      <artifactId>hello_world</artifactId>
  7.      <version>1.0-SNAPSHOT</version>
  8.      <name>hello_world</name>
  9.      <!– FIXME change it to the project’s website –>
  10.      <url>http://www.example.com</url>
  11.      <!– 集中定义版本号 –>
  12.      <properties>
  13.      <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  14.      <maven.compiler.source>1.7</maven.compiler.source>
  15.      <maven.compiler.target>1.7</maven.compiler.target>
  16.      <hadoop.version>3.3.1</hadoop.version> <!–这里追加hadoop版本号–>
  17.      </properties>
  18.      <dependencies>
  19.      <dependency>
  20.          <groupId>junit</groupId>
  21.          <artifactId>junit</artifactId>
  22.          <version>4.11</version>
  23.          <scope>test</scope>
  24.      </dependency>
  25.      <!– 导入hadoop依赖环境 –>
  26.      <dependency>
  27.          <groupId>org.apache.hadoop</groupId>
  28.          <artifactId>hadoop-common</artifactId>
  29.          <version>${hadoop.version}</version>
  30.      </dependency>
  31.      <dependency>
  32.          <groupId>org.apache.hadoop</groupId>
  33.          <artifactId>hadoop-hdfs</artifactId>
  34.          <version>${hadoop.version}</version>
  35.      </dependency>
  36.      <dependency>
  37.          <groupId>org.apache.hadoop</groupId>
  38.          <artifactId>hadoop-mapreduce-client-core</artifactId>
  39.          <version>${hadoop.version}</version>
  40.      </dependency>
  41.      <dependency>
  42.          <groupId>org.apache.hadoop</groupId>
  43.          <artifactId>hadoop-client</artifactId>
  44.          <version>${hadoop.version}</version>
  45.      </dependency>
  46.      <dependency>
  47.          <groupId>org.apache.hadoop</groupId>
  48.          <artifactId>hadoop-yarn-api</artifactId>
  49.          <version>${hadoop.version}</version>
  50.      </dependency>
  51.      </dependencies>
  52.      </dependencies>
  53.      <build>
  54.      <pluginManagement><!– lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) –>
  55.          <plugins>
  56.          <!– clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle –>
  57.          <plugin>
  58.              <artifactId>maven-clean-plugin</artifactId>
  59.              <version>3.1.0</version>
  60.          </plugin>
  61.          <!– default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging –>
  62.          <plugin>
  63.              <artifactId>maven-resources-plugin</artifactId>
  64.              <version>3.0.2</version>
  65.          </plugin>
  66.          <plugin>
  67.              <artifactId>maven-compiler-plugin</artifactId>
  68.              <version>3.8.0</version>
  69.          </plugin>
  70.          <plugin>
  71.              <artifactId>maven-surefire-plugin</artifactId>
  72.              <version>2.22.1</version>
  73.          </plugin>
  74.          <plugin>
  75.              <artifactId>maven-jar-plugin</artifactId>
  76.              <version>3.0.2</version>
  77.          </plugin>
  78.          <plugin>
  79.              <artifactId>maven-install-plugin</artifactId>
  80.              <version>2.5.2</version>
  81.          </plugin>
  82.          &lt;plugin>
  83.              <artifactId>maven-deploy-plugin</artifactId>
  84.              <version>2.8.2</version>
  85.          </plugin>
  86.          <!– site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle –>
  87.          <plugin>
  88.              <artifactId>maven-site-plugin</artifactId>
  89.              <version>3.7.1</version>
  90.          </plugin>
  91.          <plugin>
  92.              <artifactId>maven-project-info-reports-plugin</artifactId>
  93.              <version>3.0.0</version>
  94.          </plugin>
  95.          </plugins>
  96.      </pluginManagement>
  97.      </build>s
  98. </project>

ctrl/command+s保存,项目会对pom.xml重新解析,导入我们添加进入的包。

最后我们尝试在App.java中导入hadoop相关的包:

  1. package com.orion;
  2. import org.apache.hadoop.fs.FileSystem;
  3. import org.apache.hadoop.conf.Configuration;
  4. import org.apache.hadoop.fs.Path;
  5. import org.apache.hadoop.io.IntWritable;
  6. import org.apache.hadoop.io.Text;
  7. import org.apache.hadoop.mapreduce.Job;
  8. import org.apache.hadoop.mapreduce.Mapper;
  9. import org.apache.hadoop.mapreduce.Reducer;
  10. import org.apache.hadoop.mapreduce.lib.input.FileInputFormat;
  11. import org.apache.hadoop.mapreduce.lib.output.FileOutputFormat;
  12. /**
  13.      * Hello world!
  14.      *
  15.      */
  16. public class App
  17. {
  18.      public static void main( String[] args )
  19.      {
  20.          System.out.println( “Hello World!” );
  21.      }
  22. }

按’F5’重新编译运行,成功打印输出Hello World!,说明我们的包导入成功。

(base) lonelyprince7@lonelyprince7deMacBook-Pro hello_world %  /usr/bin/env /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home/bin/java -agentlib:jdwp=transport=dt_socket,server=n,suspend=y,address=localhost:54181 –enable-preview -XX:+ShowCodeDetailsInExceptionMessages -cp “/Users/lonelyprince7/Library/Application Support/Code/User/workspaceStorage/fe34994f622cdbfbf60e8ed045c6bde3/RedHat.java/jdt_ws/jdt.ls-java-project/bin” com.orion.App
Hello World!

注意,如果报错org.apache.hadoop.fs.FileSystem cant be resolved这种错误,则需要先清空项目缓存,然后再重新编译运行。

至此,我们已经成功用VScode+Maven创建好一个Hadoop的开发环境。在Hadoop编程中,最基本的一种分布式编程范式即MapReduce编程。在后面我们会借由“WordCount”(词频统计)这个MapReduce编程的入门项来讲解Hadoop中MapReduce编程的基本语法,敬请继续关注。

到此这篇关于借助Maven搭建Hadoop开发环境的最详细教程分享的文章就介绍到这了,更多相关Maven搭建Hadoop开发环境内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们!

标签

发表评论