Eclipse 使用Maven 构建Web项目的最佳方式，我认为没有之一

古城微笑少年丶 2021-09-14 13:02 158阅读 0赞

我接触Maven特别的晚，大概是在2017年的11月份，现在是2017年12月28日，也就是说别的开发者已经坐上了飞机，而我还是骑着牛（事实上我的确还没有坐过飞机，也没有骑过牛，尽管我已经28岁了）。但子曰：“朝闻道夕死可矣”，尽管我一点都不想死，也并没有精通Maven，但我已经在正式成为Maven大家庭的一员了——荣幸之至！

我是一名忠实的保守主义者，如果一件工具没有彻彻底底的伤透我的心，我是会一直使用下去的。就像，别人爱上了IntelliJ IDEA，我还是忠于Eclipse；别人爱上了Maven，我还是通过Eclipse新建Java project或者dynamic Web project；别人爱上了Restful，我还是通过Eclipse新建Web service。我就像行走在新干线上的一头牛，就要被日新月异的IT技术淘汰了！但我不甘于被淘汰，我想要迎头赶上，所以我选择折腾Maven，直到Maven被我所用。

我折腾Maven也不是一时半会的事了，持续有一个月的时间，但也就是终于弄明白怎么使用Maven新建一个Web项目了。

我偷偷的告诉你，我爱上Maven的原因是——

1）Maven项目可以直接查看到源码（点击源码的时候Maven后台就会自动下载source包到Maven仓库），而不像传统的项目要加载source源码包。

![这里写图片描述][SouthEast]

传统的方式：

![这里写图片描述][SouthEast 1]

2）使用SVN down一个完整的项目，再也不必等啊等，尤其jar包很多的时候，Maven第一次会在本地下载一个仓库，时间会稍微久一点（毕竟第一次嘛，时间久一点是应该的，以后就不会了）。默认的地址是：C:\\Users\\abc.m2\\repository（Windows为例）

![这里写图片描述][SouthEast 2]

3）新增jar太方便，直接在pom.xml文件中追加对应的jar包配置就可以，关键是还有Maven仓库的镜像可以参照。

地址为：[http://mvnrepository.com/][http_mvnrepository.com]

![这里写图片描述][SouthEast 3]

只要左键点击Maven tab页的内容，就已经复制了内容，连Ctrl C都省了，真是不要太人性化！复制好后，将内容粘贴到pom.xml文件的`<dependencies>`节点下就可以了。

我爱上Maven也是基于这三点因素，至于Maven的命令嘛，不在我们本章的学习范围之内，我们的目的——就是通过Eclipse来新建Maven Web项目。

## 一、下载Eclipse ##

很奇怪，不知道为什么，最新版的Eclipse（也就是氧气版（oxygen））无法自动化加载完成一个Maven项目，为此，我还专门研究了一篇文章「[Eclipse导入Maven项目，实在算得上是历经千辛万苦 ][Eclipse_Maven_]」（现在这篇文章可以废弃了，参照本篇教程即可），当时真是费了老大的劲，几乎崩溃——就在边缘。

最后，我选择了macs版本的Eclipse，并在此版本的Eclipse导入Maven web项目成功。

地址：[http://www.eclipse.org/downloads/eclipse-packages/][http_www.eclipse.org_downloads_eclipse-packages]

![这里写图片描述][SouthEast 4]

至于neon版本行不行，你可以试试，我是看Mars版本下载的最多，所以选择后退的版本比较多。

## 二、下载Maven ##

有了Eclipse，接下来就要准备Maven。

地址：[https://maven.apache.org/download.cgi][https_maven.apache.org_download.cgi]

![这里写图片描述][SouthEast 5]

下载zip版本，解压后，配置maven的系统path路径。像配Java那样。

win10的截图：

![这里写图片描述][SouthEast 6]

配置完成后，启动cmd，输入mvn -v，看看能否有结果？

我电脑上以前配置的3.5.0版本：

![这里写图片描述][SouthEast 7]

## 三、Eclipse关联Maven ##

Eclipse是支持Maven的，下载好Eclipse后，就会有Maven的选项。

![这里写图片描述][SouthEast 8]

默认的仓库地址如上图。

## 四、Eclipse新建Maven项目 ##

工欲善其事必先利其器，我们的准备工作已经做完了，接下来就是新建Maven的web项目了。

Eclipse也有这个选项，但是™的新建出来的web版本是2.5的，并且转换3.0的时候还报错！实在是坑，我就想问问Eclipse团队为啥不好好整一个！！！！！！！

![这里写图片描述][SouthEast 9]

鉴于此，我新建了一个SpringMVC 版本的的空的Web项目，其结构图如下：

.  
├── pom.xml  
└── src  
├── main  
│ ├── java  
│ │ ├── application-context.xml  
│ │ ├── cmower.properties  
│ │ ├── com  
│ │ │ └── cmower  
│ │ │ └── spring  
│ │ │ └── IndexController.java  
│ │ ├── context-dispatcher.xml  
│ │ └── log4j.properties  
│ ├── resources  
│ └── webapp  
│ ├── 404.jsp  
│ └── WEB-INF  
│ ├── pages  
│ │ └── index.jsp  
│ └── web.xml  
└── test  
├── java  
└── resources

13 directories, 9 files

GitHub地址：[https://github.com/qinggee/Maven4Web][https_github.com_qinggee_Maven4Web]

![这里写图片描述][SouthEast 10]

点击「copy or download」把项目copy到本地。

![这里写图片描述][SouthEast 11]

使用eclipse导入：

![这里写图片描述][SouthEast 12]

![这里写图片描述][SouthEast 13]

完成后，效果图：

![这里写图片描述][SouthEast 14]

关键要看pom.xml：

<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/maven-v4_0_0.xsd">
        <modelVersion>4.0.0</modelVersion>
        <groupId>com.cmower</groupId>
        <artifactId>Maven4Web</artifactId>
        <packaging>war</packaging>
        <version>0.0.1-SNAPSHOT</version>
        <name>Maven4Web Maven Webapp</name>
        <url>http://maven.apache.org</url>
    
        <developers>
            <developer>
                <id>cmower</id>
                <name>maweiqing</name>
            </developer>
        </developers>
    
        <properties>
            <javax.servlet.version>3.1.0</javax.servlet.version>
            <spring.version>3.2.8.RELEASE</spring.version>
            <spring.security.version>3.2.3.RELEASE</spring.security.version>
            <jstl.version>1.2</jstl.version>
            <mysql.connector.version>5.1.30</mysql.connector.version>
            <jdk.version>1.7</jdk.version>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>javax.servlet</groupId>
                <artifactId>javax.servlet-api</artifactId>
                <version>${javax.servlet.version}</version>
                <scope>provider</scope>
            </dependency>
    
            
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-core</artifactId>
                <version>${spring.version}</version>
                <exclusions>
                    <exclusion>
                        <groupId>commons-logging</groupId>
                        <artifactId>commons-logging</artifactId>
                    </exclusion>
                </exclusions>
            </dependency>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-web</artifactId>
                <version>${spring.version}</version>
            </dependency>
    
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-webmvc</artifactId>
                <version>${spring.version}</version>
            </dependency>
    
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-jdbc</artifactId>
                <version>${spring.version}</version>
            </dependency>
    
            
            <dependency>
                <groupId>jstl</groupId>
                <artifactId>jstl</artifactId>
                <version>${jstl.version}</version>
            </dependency>
    
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>3.8.1</version>
                <scope>test</scope>
            </dependency>
    
            
            <dependency>
                <groupId>log4j</groupId>
                <artifactId>log4j</artifactId>
                <version>1.2.16</version>
            </dependency>
            
            <dependency>
                <groupId>org.slf4j</groupId>
                <artifactId>slf4j-api</artifactId>
                <version>1.7.25</version>
            </dependency>
            
            <dependency>
                <groupId>org.slf4j</groupId>
                <artifactId>slf4j-log4j12</artifactId>
                <version>1.7.25</version>
            </dependency>
    
            
            <dependency>
                <groupId>commons-logging</groupId>
                <artifactId>commons-logging</artifactId>
                <version>1.1.1</version>
            </dependency>
        </dependencies>
    
        <build>
            <finalName>Maven4Web</finalName>
            <plugins>
    
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>2.3.2</version>
                    <configuration>
                        <source>${jdk.version}</source>
                        <target>${jdk.version}</target>
                    </configuration>
                </plugin>
    
            </plugins>
    
            <resources>
                <resource>
                    <directory>src/main/java</directory>
                    <includes>
                        <include>**/*.xml</include>
                    </includes>
                </resource>
            </resources>
        </build>
    </project>

运行项目：

![这里写图片描述][SouthEast 15]

pom的英文全称应该是Project Object Model（项目对象模型）。pom.xml，一个将项目编译、测试、部署等步骤联系在一起加以自动化的XML，通常放置在项目的根目录下。它是Maven 项目的灵魂文件，它的作用主要是用来配置项目、开发者的信息，管理项目的依赖包、编译环境等。

pom.xml文件的第一部分通常是：

其中的modelVersion是4.0.0，这是当前仅有的，可以被Maven2&3同时支持的POM版本，它是必须的。

pom.xml文件的第二部分通常是：

<groupId>com.cmower</groupId>
    <artifactId>Maven4Web</artifactId>
    <packaging>war</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <name>Maven4Web Maven Webapp</name>
    <url>http://maven.apache.org</url>
    <developers>
        <developer>
            <id>cmower</id>
            <name>maweiqing</name>
        </developer>
    </developers>

1.  groupId : 组织标识，本书的所有源码均为com.cmower。
2.  artifactId : 项目名称，本例子为Maven4Web。
3.  packaging : 打包的格式，Java Web项目为war包。
4.  version : 版本号，通常以0.0.1为起始版本号。
5.  name：项目的名称, Maven产生的文档用
6.  url：项目主页的URL, Maven产生的文档用
7.  developers：项目的开发者，可以有多个。

pom.xml文件的第三部分通常是：

<properties>
        <spring.version>3.2.8.RELEASE</spring.version>
        <jdk.version>1.7</jdk.version>
    </properties>

用来定义一些可能需要变动又经常使用的版本号变量，比如说Spring的版本号定义为3.2.8.RELEASE。

pom.xml文件的第四部分通常是：

<dependencies>
        
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>${spring.version}</version>
            <exclusions>
                <exclusion>
                    <groupId>commons-logging</groupId>
                    <artifactId>commons-logging</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

元素描述了项目相关的所有依赖， 这些依赖组成了项目构建过程中的一个个环节。每次更改pom.xml文件保存后，新增或者改动的依赖将会自动从Maven 定义的仓库中（比如阿里云镜像库）下载到本地仓库。

有了Maven的帮助，新增项目依赖的JAR包实在是太方便了。比如说我们使用Fastjson  
来进行JSON解析和生成，那么要添加Fastjson的JAR包到项目的构建路径中，该怎么做呢？

第一步，进入MavenRepository网站（地址为 [http://mvnrepository.com][http_mvnrepository.com 1]），在 search 文本域中输入com.alibaba（groupId）或者 fastjson（artifactId），然后点击「search」按钮，结果如下：

![fastjson][]

第二步，点击Fastjson的链接进入到Fastjson的主页，可以看到所有版本的Fastjson，选择一个使用率最高的，目前是1.2.41版本。使用率高在一定程度上表明这个版本的JAR包最稳定，它已经得到了广大程序员的认可。

第三步，在1.2.41版本的Fastjson页，只需要左键轻轻地在 「Maven」选项卡内点一下，就已经把Fastjson的依赖信息复制到粘贴板了，不再需要「Ctrl+C」哦——非常的人性化。

第四步，将Fastjson的依赖信息粘贴到pom.xml文件的`<dependencies>`节点下，然后按下快捷键「Ctrl+S」保存。紧接着，依次展开Maven4Web → Java Resources → Libraries → Maven Dependencies 节点，你可以看到 fastjson-1.2.41.jar 已经悄悄地添加进来了。

另外，元素主要用于解决版本冲突问题。上例中在计算spring-core的依赖传递时， 排除commons-logging的依赖构件集。

pom.xml文件的第五部分通常是：

<build>
        <finalName>Maven4Web</finalName>
        <plugins>
    
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.3.2</version>
                <configuration>
                    <source>${jdk.version}</source>
                    <target>${jdk.version}</target>
                </configuration>
            </plugin>
        </plugins>
    
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.xml</include>
                </includes>
            </resource>
        </resources>
    </build>

1.  元素用于构建项目需要的信息。
2.  元素用于指定该项目使用的插件列表。比如本例中指定了编译源代码的“maven-compiler-plugin”插件。
3.  元素描述了项目相关的所有资源路径列表。比如本例中指定的xml文件，这些资源被包含在最终的打包文件里。

--------------------

> 生活不易，写作不易，传道不易，我们需要你的关注：
> 
> ![沉默王二][20161224204853903]

[SouthEast]: /images/20210506/2ad0fb14a4424ba08a935e878565ef92.png
[SouthEast 1]: /images/20210506/8eae4704b92b489ea9eb230f264fdbbb.png
[SouthEast 2]: /images/20210506/2fb5d793159c417094aa1dec83b494c3.png
[http_mvnrepository.com]: http://mvnrepository.com/
[SouthEast 3]: /images/20210506/4565097a8dd146eea96e5fda039c5445.png
[Eclipse_Maven_]: http://blog.csdn.net/qing_gee/article/details/78259454
[http_www.eclipse.org_downloads_eclipse-packages]: http://www.eclipse.org/downloads/eclipse-packages/
[SouthEast 4]: /images/20210506/e8bb3e16db0e413e88da8e64d7951d8b.png
[https_maven.apache.org_download.cgi]: https://maven.apache.org/download.cgi
[SouthEast 5]: /images/20210506/7023d7ea2e664cf389a3ee3f5f0fe66d.png
[SouthEast 6]: /images/20210506/e9799f97bc1142d79b65e42e2d25c517.png
[SouthEast 7]: /images/20210506/0f2e87f9fa7940cd922aa637401c242a.png
[SouthEast 8]: /images/20210506/5621387ede4b4c6ebbf4822ebc9b4aaa.png
[SouthEast 9]: /images/20210506/8d0ddac0c45b4736ab4ead32346c3d55.png
[https_github.com_qinggee_Maven4Web]: https://github.com/qinggee/Maven4Web
[SouthEast 10]: /images/20210506/56cf18c0b44840469b8a1493982861e2.png
[SouthEast 11]: /images/20210506/7124b5a30f504d4fac04bf1e76002b77.png
[SouthEast 12]: /images/20210506/6baafeb48fdc48a3af0664405dcec02a.png
[SouthEast 13]: /images/20210506/f4f1fe7f12b44953bbfdc1a8405243cc.png
[SouthEast 14]: /images/20210506/3d5e55e6df92494f87692de2635e4280.png
[SouthEast 15]: /images/20210506/bb41c3bad3924b519eb6fd443d44c2a8.png
[http_mvnrepository.com 1]: http://mvnrepository.com
[fastjson]: /images/20210506/f0e2474b06644608bc49715b0c2a39e1.png
[20161224204853903]: /images/20210506/e2d6dd3e37db4a238a300f02df483ee7.png