转：如何将 Java 项目转换成 Maven 项目 如何将 Java 项目转换成 Maven 项目

如何将 Java 项目转换成 Maven 项目

本文内容

• Java 项目
• Maven 项目
• Java 项目转换成 Maven 项目

本文主要介绍如何将 Java 项目转换成 Maven 项目。首先要明确的是，用 Maven 管理 Java 项目的确方便。它带给你直观的方即是：你不用在网上找 Jar 包，而后把它复制到 lib 目录，再在项目中引用它。而只需向 pom.xml 写入你须要的 Jar 包依赖，Maven 就能自动从本地仓库或远程仓库下载，并引用……

如何将通常的 Java 项目转换成 Maven 项目？当你了解了 Java 项目与 Maven 项目在结构上的区别后，就能很容易地在它们之间进行转换，而不用局限于各类网络或书上的资料上所描述的方法（有些方法至关不靠谱，照猫画虎，知其然不知其因此然）。

本文假设你已经成功安装了 Maven。

个人 Eclipse 版本是 Eclipse eclipse-jee-mars-R-win32-x86_64 版本 4.5.0，Build id 为 20150621-1200，Maven 是 3.3.3。

Java 项目

---

用 Eclipse 建立一个 Java 项目，选择“File –> New -> Jave Project”，新建名为“JavaDemo”的项目。

文件系统目录结构以下图所示，之因此强调文件系统，是为了区分项目在 Eclipse 中的目录结构：

图 1 左：Java 项目在文件系统中的结构；右： Java 项目在 Eclipse 中的结构

说明：

• src 目录，是源代码目录；
• .classpath 文件，用来描述程序编译的 classpath。好比，上面创建的 Java 项目，该文件的可能内容是：

<?xml version="1.0" encoding="UTF-8"?>

<classpath>

    <classpathentry kind="src" path="src"/>

    <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.8"/>

    <classpathentry kind="output" path="bin"/>

</classpath>

指定了源文件的位置为 src 目录；con 容器为 JRE，标准 VM（虚拟机），Java 8 等信息；编译输出位置为 bin 目录。固然，还能够有 lib 目录。你能够想象，该文件实际上指定了 Java 项目在逻辑结构与文件系统的物理结构之间的对应关系。

• .project 文件，是项目文件，好比，仍是上面项目，该文件的可能内容是：

<?xml version="1.0" encoding="UTF-8"?>

<projectDescription>

    <name>JavaDemo</name>

    <comment></comment>

    <projects>

    </projects>

    <buildSpec>

        <buildCommand>

            <name>org.eclipse.jdt.core.javabuilder</name>

            <arguments>

            </arguments>

        </buildCommand>

    </buildSpec>

    <natures>

        <nature>org.eclipse.jdt.core.javanature</nature>

    </natures>

</projectDescription>

指定了项目名称 JavaDemo，项目描述信息，生成命令，核心等信息。

接下来，再看看 Maven 项目是什么样的。

Maven 项目

---

用 Eclipse 新建一个 Maven 项目，选择“File –> New-> Other”，找到“Maven –> Maven Project”，Archetype 选择“quickstart”，Group ID 和 Artifact Id 都为 mavenDemo，

 

 

 

 

 

 

图 2 左：Maven 项目在文件系统中的结构；右：Maven 项目在 Eclipse 中的结构

说明：

• 上图左边，Maven 项目比 Java 项目多了 pom.xml，即 Project Object Model，该文件本文就不介绍了；

上图右边，Eclipse 的内容变化就比较多了，甚至连项目图标都变了，右上角有个“J”，左上角多个“M”，包括：

• 源文件位置，Java 项目只有 src，而 Maven 在 src 下又区分了 main 和 test，其中 main 是主代码，test 是测试代码，显示样式也有变化，如 src/main/java。若是你看下 Maven 的文件系统结构，其实它们都是文件夹。能够想象，当咱们修改代码后，可让 Maven 进行测试，测试完成后，生成 Jar 包，而 Jar 包中不包含测试代码。这就是如此划分的好处；
• target 目录，跟 Java 项目的 bin 目录做用同样；
• Maven Dependencies，Java 项目有 lib 目录，用来放置你使用的三方 Jar 包。当采用 Maven 时，lib 目录就没用了。Maven 的主要做用是管理项目依赖，它能够从本地仓库或远程仓库得到你须要的 Jar 包，即使是你本身写的 Java 项目，也彻底不用再配置“Configure Build Path”，只需向 pom.xml 添加 dependency 节点，写上你引用项目的 Group Id 和 Artfact Id，就能直接引用。想象一下，若是没有 Maven，当你使用三方 Jar 包时，一般会先创建一个 lib 目录，而后把 Jar 包复制到这里，再经过“Configure Build Path” 引用它们，有了 Maven 后，这些步骤，就通通不用了（差点忘了，你还得在网上找到你须要的 Jar 包，并下载本地）；
• .classpath 文件，跟 Java 项目区别不大，但内容会不一样，好比，上面新建的 Maven 项目，该文件的可能内容是：

<?xml version="1.0" encoding="UTF-8"?>

<classpath>

    <classpathentry kind="src" output="target/classes" path="src/main/java">

        <attributes>

            <attribute name="optional" value="true"/>

            <attribute name="maven.pomderived" value="true"/>

        </attributes>

    </classpathentry>

    <classpathentry kind="src" output="target/test-classes" path="src/test/java">

        <attributes>

            <attribute name="optional" value="true"/>

            <attribute name="maven.pomderived" value="true"/>

        </attributes>

    </classpathentry>

    <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.8">

        <attributes>

            <attribute name="maven.pomderived" value="true"/>

        </attributes>

    </classpathentry>

    <classpathentry kind="con" path="org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER">

        <attributes>

            <attribute name="maven.pomderived" value="true"/>

        </attributes>

    </classpathentry>

    <classpathentry kind="output" path="target/classes"/>

</classpath>

注意，classpathentry 的 kind 属性同 Java 项目中的同样，也有“src”、“con”、“output”，但比 Java 项目多，好比，关于 src 的就有两个。但其属性就有区别了，好比，kind 为 src 的 classpathentry，分别有 path=src/main/java 和 path=src/test/java，指示主代码和测试代码的位置。

• .project 文件，好比，仍是上面 Maven 项目，该文件的可能内容是：

<?xml version="1.0" encoding="UTF-8"?>

<projectDescription>

    <name>mavenDemo</name>

    <comment></comment>

    <projects>

    </projects>

    <buildSpec>

        <buildCommand>

            <name>org.eclipse.jdt.core.javabuilder</name>

            <arguments>

            </arguments>

        </buildCommand>

        <buildCommand>

            <name>org.eclipse.m2e.core.maven2Builder</name>

            <arguments>

            </arguments>

        </buildCommand>

    </buildSpec>

    <natures>

        <nature>org.eclipse.jdt.core.javanature</nature>

        <nature>org.eclipse.m2e.core.maven2Nature</nature>

    </natures>

</projectDescription>

Maven 的 .project 文件，除了有关于 Java 的，还添加了它本身的。

本质上，Maven 接管了 Java 项目的管理。

Java 项目转换 Maven 项目

---

首先，右键选择 JavaDemo，选择“Configure –> Convert to Maven Project”， 填写“Group ID”和“Artifact Id”都为“JavaDemo”。如图 3 所示：

图 3 Java 项目编程 Maven 项目

能够看到，项目图标变了，多了 pom.xml，Maven Dependencies，target 等。但 src 代码位置不对，没有指示出主代码和测试代码。

但愿你还有印象，前面两小节，对 Java 项目和 Maven 项目的 .classpath 文件进行的比较。所以，IDE 在转换时没有自动修改 .classpath 文件。

而你只需在文件系统下，在 src 目录下创建 main 和 test 子目录，并在它们下再分别创建 java 子目录。也就是，src/main/java，src/test/java。而后修改 .classpath 文件，或用一个现成的 Maven .classpath 文件覆盖它便可。

将：

<?xml version="1.0" encoding="UTF-8"?>

<classpath>

    <classpathentry kind="src" output="target/classes" path="src">

        <attributes>

            <attribute name="optional" value="true"/>

            <attribute name="maven.pomderived" value="true"/>

        </attributes>

    </classpathentry>

    <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.8">

        <attributes>

            <attribute name="maven.pomderived" value="true"/>

        </attributes>

    </classpathentry>

    <classpathentry kind="con" path="org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER">

        <attributes>

            <attribute name="maven.pomderived" value="true"/>

        </attributes>

    </classpathentry>

    <classpathentry kind="output" path="target/classes"/>

</classpath>

改为：

<?xml version="1.0" encoding="UTF-8"?>

<classpath>

    <classpathentry kind="src" output="target/classes" path="src/main/java">

        <attributes>

            <attribute name="optional" value="true"/>

            <attribute name="maven.pomderived" value="true"/>

        </attributes>

    </classpathentry>

    <classpathentry kind="src" output="target/test-classes" path="src/test/java">

        <attributes>

            <attribute name="optional" value="true"/>

            <attribute name="maven.pomderived" value="true"/>

        </attributes>

    </classpathentry>

    <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.8">

        <attributes>

            <attribute name="maven.pomderived" value="true"/>

        </attributes>

    </classpathentry>

    <classpathentry kind="con" path="org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER">

        <attributes>

            <attribute name="maven.pomderived" value="true"/>

        </attributes>

    </classpathentry>

    <classpathentry kind="output" path="target/classes"/>

</classpath>

此时，JavaDemo 这个项目就会变成如图 4 所示，若是你着急，就按 F5 刷新。

图 4 Java 项目转换成 Maven 项目

如今，这个 Java 项目就跟 Maven 建立的项目同样了。

了解这个原理，你也能将 Maven 项目转换成 Java 项目。

另外，你会发现 Eclipse 这个 IDE 一个方便的地方是，即使 Eclipse 已经打开了你的项目，你也能够在操做系统的资源管理器上随意操做文件和文件夹（固然，我说的是 Windows 操做系统），这跟一些其余的 IDE 不一样，好比微软的 VS，你就不能这么干，缘由很简单，对一个 IDE 正在访问的文件，又在操做系统的资源管理里对文件进行剪切或删除，IDE 显然不会答应。可是 Eclipse 就跟 Notepad 或 UE 这些文本编辑器似的，会监视文件，但不会阻止你作你想作的事，给程序员最大的灵活度和自由度，这也是 Java 的理念之一。因此，在 Maven 项目与 Java 项目进行转换成，无所谓先进行哪步，后进行哪步，如图 3，项目中有 pom.xml 文件了，即使 .classpath 文件不正确，那么这个项目的图标也会已变成 Maven 图标，以前的 bin 目录或 lib 目录也会存在，虽然 Maven 彻底不须要它们，并且主代码和测试代码的显示也彻底不对，甚至，还会出现彻底按操做系统的一级又一级……的目录结构来显示，而不是逻辑结构——Java 包的方式来显示~若是最终全部的修改达到 Maven的要求，它就能正确显示结构。