win64从零开始搭建eclipse maven工程

最新推荐文章于 2024-06-08 10:32:34 发布

flowering09

最新推荐文章于 2024-06-08 10:32:34 发布

阅读量661

点赞数 1

分类专栏： maven 文章标签： eclipse jdk maven

本文链接：https://blog.csdn.net/flowering09/article/details/54883279

版权

maven 专栏收录该内容

0 篇文章 0 订阅

订阅专栏

环境：win64系统，jdk8+maven3+eclipse4.6

一、jdk安装

下载路径：
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
jdk下载选取
如图，选取 jdk-8u121-windows-x64.exe 下载，双击依向导安装，记住jdk的安装路径。

tips：jdk包含Java的开发环境和运行环境，jre仅包含Java的运行环境。

安装成功jdk后，安装向导后面的jre可以不安装。若安装jre8，会自动在路径C:\ProgramData\Oracle\Java\javapath下生成3个java*.exe文件，且在path变量值开头添加C:\ProgramData\Oracle\Java\javapath

设置环境变量：右击我的电脑，选择属性 > 高级系统设置 > 环境变量 > 系统变量，按如下设置

 - 新增变量 JAVA_HOME=jdk8的安装路径
 - 新增变量 CLASSPATH=.；
 - 修改path变量，在原值末尾添加 %JAVA_HOME%\bin（路径之间用;分隔，若原值末尾未有;请注意先添加上）

运行 cmd，在命令行输入以下命令，若均能成功输出结果则表示jdk环境设置ok：

java -version // 成功输出版本信息
javadoc -help // 成功输出帮助信息

注意：若安装jre8但未设置jdk8环境变量，在命令行输入 java -version 也能成功输出版本信息，此时运行的是C:\ProgramData\Oracle\Java\javapath目录下的java.exe命令

二、maven安装

下载路径：http://maven.apache.org/download.cgi
maven下载选取
如图，从官网选择 apache-maven-3.3.9-bin.zip 下载，archive为解压免安装版本，解压即可。

注意官网这样一句话：Maven 3.3 requires JDK 1.7 or above to execute
即：使用 maven3.3 必须安装至少1.7版本的jdk

1、设置环境变量

右击我的电脑，选择属性 > 高级系统设置 > 环境变量 > 系统变量，按如下设置：

 - 新增变量 M2_HOME=maven解压版目录路径（这里为E:\web\apache-maven-3.3.9）
 - 修改path变量，在原值末尾添加 %M2_HOME%\bin（路径之间用;分隔）

运行 cmd，在命令行输入 mvn -v 成功输出 maven home、java version、java home 等信息则表示maven环境设置ok。

tips：maven环境变量不是必须要求设置的，但若需要操作mvn命令请配置，若eclipse启动报MavenClasspathContainerInitializer异常也请配置。

2、设置maven本地仓库路径： settings.xml

打开文件 %M2_HOME%\conf\settings.xml，可以看到通篇都是被注释掉的配置实例以及说明。第一个属性 localRepository 是设置本地仓库的，本地仓库的默认路径为 ${user.home}/.m2/repository ，不设置则采用默认路径，可设置成自己的本地仓库路径，这里设置成 E:/web/repository

<localRepository>E:/web/repository</localRepository>

%M2_HOME%\conf\settings.xml 为maven全局配置文件，在eclipse中就是对该workspace内所有maven项目起作用。

网上有类似如下说法，之后在eclipse 4.6 中设置 Maven > User Settings 时的确看到有2个引进 settings.xml 路径的入口，暂未深究。

%M2_HOME%\conf\settings.xml为maven全局配置，对整台计算机生效；${user.home}.m2\settings.xml为用户范围配置，此文件默认是不存在的，需要自己创建；当两种配置文件并存时合并 settings.xml 配置信息。

3、了解maven局部配置： pom.xml

pom 是 project object model 的缩写，是xml结构的文件，描述了maven对单一项目的定义和构建。pom.xml 文件位于项目的根目录，称之为局部配置文件，优先级高于settings.xml配置文件，可以在pom.xml中配置只对本项目生效的配置以覆盖全局settings.xml文件中设置。

三、eclipse安装

下载路径：https://www.eclipse.org/downloads/eclipse-packages/
这里写图片描述
如图，选取 64 bit下载，解压后即可使用。为方便使用，一般会创建指向 eclipse.exe 的快捷方式。

1、集成maven

当前下载的最新版为4.6，该版的eclipse已集成maven；低版本的eclipse可能未集成maven，需要安装maven插件，maven插件的安装可参考如下博文：

2、eclipse启动配置：eclipse.ini

eclipse默认启动加载eclipse.ini文件，一般不需要调整该配置；该文件是一个纯文本文件，百度了一下它的格式：

1：所有的选项及其相关的参数必须在单独的一行之内，若参数形如“项值”形式，中间的空格需要换行书写，如果值中有空格则需要用双引号括起来；
2：所有在-vmargs之后的参数将会被传输给JVM，所有对Eclipse设置的参数必须写在-vmargs之前。

详细请参考博文：http://jasonwalker.blog.51cto.com/7020143/1416718

四、eclipse maven 配置

双击打开 eclipse，并设置自己的工作区间（这里设置成E:\workspace），然后选择 Window > Preferences ，在弹框中作如下设置：

1、设置eclipse工作区间编码：选择 General > Workspace，将 Text file encoding 设置成 utf-8，点击 Apply

2、设置外部maven安装路径：选择 Maven > Installations，点击 Add… 添加maven路径 %M2_HOME% ，点击 Apply

maven installations

eclipse集成Maven时，都会安装上一个内嵌的Maven，eclipse默认使用embedded的maven来编译。eclipse 4.6 内置的embedded maven版本就是3.3.9版本，实际生产中内嵌的maven与外部maven环境很难一致，为保证开发环境一致建议设置成外部Maven。

3、设置maven配置文件路径：选择 Maven > User Settings，点击 Browse… 添加配置文件 %M2_HOME%\conf\settings.xml，点击 Update Settings，本地仓库路径则为 E:/web/repository，点击 Apply

maven settings

最后点击ok，结束配置。

五、搭建maven工程

1、创建单一 maven项目

（1）在 Package Explorer 窗口（根据个人习惯选择，如 Navigator）空白处右击，选择 New > Maven Project，在弹框中勾选 Create a simple project，点击 Next

这里写图片描述

（2）如图，配置 group id 和 artifact id，选择 packaging 方式为 war，点击 Finish

这里写图片描述
packaging 选择说明：如果是java工程请选择为jar，如果是web工程请选择为war，如果是多模块maven项目中的父项目请选择为pom。

（3）手动添加WEB-INF目录和web.xml文件，最终项目结构如图：

这里写图片描述
注意：默认生成的工程不存在WEB-INF目录和web.xml文件，需要手动添加。

如上图，maven项目默认jre为1.5，在pom.xml文件中添加如下代码，然后执行 maven->update project，将本项目的编译jre改为1.8：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.0</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
            </configuration>
        </plugin>
    </plugins>
</build>

2、创建 多模块 maven项目：适用于多个项目复用一个子项目（构件）

（1）首先创建单一父项目study，packaging选择pom

这里写图片描述

（2）右击study项目，选择 New > Project… > Maven Module，在弹框中勾选 Create a simple project，设置 Module Name 为 study-common，点击 Finish 即可（可以点击Next选择packaging方式，这里默认packaging方式是jar，所以直接点击 Finish ）

这里写图片描述

打开父项目study的pom.xml文件，可以看到新增了一个modules属性，父项目中用modules聚合所有模块：

<modules>
    <module>study-common</module>
</modules>

打开子项目study-common的pom.xml文件，可以看到多了一个parent属性，子项目中必须用parent指定父项目：

<parent>
     <groupId>xlj.study</groupId>
     <artifactId>study</artifactId>
     <version>0.0.1-SNAPSHOT</version>
</parent>

若在构建过程中有打开Maven Console，可以看到Maven默认copying resources的编码是GBK的，可以在父pom.xml中添加如下设置，子项目会继承父项目中的properties属性（子pom.xml优先级高于父pom.xml）

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
</properties>

（3）右击study项目，新建一个Module Mame为 study-site、packaging为 jar 的子项目；打开新建项目study-site的pom.xml文件添加对study-common的依赖：

<dependencies>
    <dependency>
        <groupId>xlj.study</groupId>
        <artifactId>study-common</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </dependency>
</dependencies>

（4）右击study项目，新建一个Module Mame为 study-oss、packaging为 jar 的子项目；也为study-oss添加对study-common的依赖。

此时，父项目study的定义如下：

<groupId>xlj.study</groupId>
<artifactId>study</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>pom</packaging>
<modules>
    <module>study-common</module>
    <module>study-site</module>
    <module>study-oss</module>
</modules>

最终生成的项目结构如图：

这里写图片描述

到此，已成功创建了一个简单的maven工程，后续可以根据业务需求添加相应依赖与插件、增加业务逻辑代码。

tips：maven项目目录结构采用约定优先于配置的原则，常见目录约定如下

目录	描述
src/main/java	存放java源文件
src/main/resources	存放资源配置文件，会自动复制到classes文件夹下
src/main/webapp	web应用部署目录，包含WEB-INF、js、css等
src/test/java	存放单元测试java源文件
src/test/resources	存放单元测试需要的资源配置文件，会自动复制到test-classes文件夹下
target/classes	项目构建输出目录，存放编译的class文件和项目资源文件等
target/test-classes	单元测试构建输出目录，存放单元测试class文件和资源文件等