setting.xml的基本配置Eclipse中Maven的基本使用

朴灿烈づ我的快乐病毒、 2022-01-30 12:07 353阅读 0赞

## setting.xml的基本配置Eclipse中Maven的基本使用 ##

本文主要为笔记和一些Maven的基本操作记录，方便以后的知识回顾，也可供他人学习和参考。  
**查询依赖信息:[http://mvnrepository.com/][http_mvnrepository.com]**

前提已经安装好maven，在控制台中输入java -version和mvn -v命令可以显示出对应信息。如果不能显示可以参考一下我的上一篇文章[Maven的安装与环境变量配置][Maven]或者自行百度

## 1.setting.xml的基本配置 ##

主要在原文件中修改地方有3处  
① 添加本地仓库位置目录  
我的本地仓库位置为E:\\Maven\\mavenwarehouse，改为自己本地仓库的位置,这里需要用到**localRepository**标签。本地仓库就是指Maven在本地存储构件的地方，也就是存放jar包的地方，下载包时Maven会从远程仓库（中央仓库）下载到本地仓库中，然后在从本地仓库引入到项目中。

<localRepository>E:\Maven\mavenwarehouse</localRepository>

②添加远程仓库的镜像  
如果仓库x中的所有内容都能从仓库y中获取，那么我们就称y为x的镜像，换句话说，也就是任何x仓库能获取到的内容，我们都能够从它的镜像中获取，可以用镜像仓库来替代中央仓库。在setting.xml中可以加入以下代码，我这里用的国内镜像阿里云，下载速度较其他为最快的

<mirrors>
     	<mirror>
        	<id>nexus-aliyun</id>
        	<mirrorOf>*</mirrorOf>  
        	<name>Nexus aliyun</name>
       		<url>http://maven.aliyun.com/nexus/content/groups/public</url>
    	</mirror>
      </mirrors>

③配置默认jdk环境，我这里版本为jdk1.8，**profile**标签应在**profiles**标签内

到此setting基本配置已经完成，可以在cmd中输入指令:mvn help:system。会自行下载一些对以后编程有帮助的jar包。最后运行成功后。本地仓库中会多出来很多文件夹。

## 2.Eclipse中Maven的基本使用 ##

## 创建Maven工程 ##

选择Maven Project  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70]  
点击next后出现如下窗口，建议大家勾选**Create a simple project** 创建一个简单的Maven项目  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 1]  
然后点击next会出现如下窗口，填写**Group Id** 和**Artifact Id**来指定坐标，Version不用修改，下面的Packaging需要注意一下，点开下拉框有jar、pom、war三个选项，他们分别指创建Java项目、创建Maven工程、创建web工程。我这里创建的为web工程，如下图  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 2]  
点击Finish创建出一个Maven工程，基本目录结构也自动创建好了但是发现报了一个错。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 3]  
该错是因为web项目中没有web.xml而报错,解决办法如下:  
右击项目名称→Properties→Project Facets 看到Dynamic Web Model左边打着对勾  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 4]  
先把对勾去掉→点击Apply→再把对勾打上可以看见窗口下面多出了一行背景颜色为黄色的链接  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 5]  
点击链接弹出一个小窗口，修改Context directory为src/main/webapp目录  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 6]  
点击**ok**→点击**Apply**→点击**Apply and Close**，然后发现不报错了，并且在src下多出了一些文件夹以及之前没有的web.xml  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 7]  
这里还有一个问题就是在webapp下创建一个jsp文件，jsp中左上角的<@符号部分会有红色波浪线，如图:  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 8]  
原因：没有引入Tomcat  
解决方法一：  
右击项目名称→Build Path→Configure Build Path→Add Library→Server Runtime→选择Tomcat路径→Finish→Apply→Apply and Close 如图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 9]  
解决方法二：  
直接在pom.xml文件中添加ServletAPI，添加下面语句即可。

<dependency>
    			<groupId>javax.servlet</groupId>
    			<artifactId>servlet-api</artifactId>
    			<version>2.5</version>
    			<scope>provided</scope>
    </dependency>

## 项目自动添加jar包 ##

在pom.xml中添加语句,如引入spring-core的jar包,对于不知道想要导入的jar包如何写对应语句的可以点击超链接 [搜索需要的 jar 包的依赖信息][http_mvnrepository.com]

<dependency>
        	<groupId>org.springframework</groupId>
        	<artifactId>spring-core</artifactId>
        	<version>5.1.7.RELEASE</version>
    	</dependency>

而后等待几秒钟Maven就会自动将相应的jar包导入到项目中，发现在maven Dependencies中多出了一个spring-core的jar包。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 10]

## scope:范围分类 ##

在这里有一个很重要的属性**scope**,也就是范围的jar意思：在上面我的**spring-core**的jar包没有设置scope，在没有设置scope的情况下，它的默认范围为compile  
**1.comple**（编译范围）：comple是默认的范围，如果没有提供一个范围，那么依赖的范围就是编译范围。编译范围在所有的classpath中可用，同时他们也会被打包。  
**2.provided**(已提供范围)：provided依赖只有在当JDK或者一个容器已提供该依赖之后才使用。例如， 你开发了一个web 应用，你可能在编译 classpath 中需要可用的Servlet API 来编译一个servlet，但是你不会想要在打包好的WAR 中包含这个Servlet API；这个Servlet API JAR 由你的应用服务器或者servlet 容器提供。已提供范围的依赖在编译classpath （不是运行时）可用。它们不是传递性的，也不会被打包。  
**3.runtime**（运行时范围）：在运行和测试的时候需要，但在编译的时候不需要。  
**4.test**（测试范围）：在运行和测试的时候不需要，但在编译的时候需要。  
**5.system**（系统范围）：system范围依赖与provided 类似，但是你必须显式的提供一个对于本地系统中JAR 文件的路径。这么做是为了允许基于本地对象编译，而这些对象是系统类库的一部分。这样的构件应该是一直可用的，Maven 也不会在仓库中去寻找它。如果你将一个依赖范围设置成系统范围，你必须同时提供一个 systemPath 元素。注意该范围是不推荐使用的（你应该一直尽量去从公共或定制的 Maven 仓库中引用依赖）。

## 统一管理相同版本的jar包 ##

我这里就拿spring中的不同jar包来演示我这里在pom.xml中引入了spring-context、spring-core、spring-beans三个jar包都是5.1.7版本的，在引入的同时maven也把它的依赖包也引入了进来。

<dependency>
    	    <groupId>org.springframework</groupId>
    	    <artifactId>spring-context</artifactId>
    	    <version>5.1.7.RELEASE</version>
    	</dependency>
    	<dependency>
    	    <groupId>org.springframework</groupId>
    	    <artifactId>spring-core</artifactId>
    	    <version>5.1.7.RELEASE</version>
    	</dependency>
    	<dependency>
    	    <groupId>org.springframework</groupId>
    	    <artifactId>spring-beans</artifactId>
    	    <version>5.1.7.RELEASE</version>
    	</dependency>

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 11]  
如果因为一些原因我们需要使用5.1.5版本的jar包，我们一个一个改比较麻烦，maven也对这一问题制定了相应的对策，可以使用properties标签

<properties>
      	<cn.black.maven>5.1.7.RELEASE</cn.black.maven>//标签名可变，这里写版本号
      </properties>
      <dependencies>
      	<dependency>
    			<groupId>javax.servlet</groupId>
    			<artifactId>servlet-api</artifactId>
    			<version>2.5</version>
    			<scope>provided</scope>
    	</dependency>
    	<dependency>
    	    <groupId>org.springframework</groupId>
    	    <artifactId>spring-context</artifactId>
    	    <version>${
        cn.black.maven}</version>//version中写${标签名}
    	</dependency>
    	<dependency>
    	    <groupId>org.springframework</groupId>
    	    <artifactId>spring-core</artifactId>
    	    <version>${
        cn.black.maven}</version>//version中写${标签名}
    	</dependency>
    	<dependency>
    	    <groupId>org.springframework</groupId>
    	    <artifactId>spring-beans</artifactId>
    	    <version>${
        cn.black.maven}</version>//version中写${标签名}
    	</dependency>	
      </dependencies>

如把他们统一修改为5.1.5版本的只需修改properties标签中的版本号即可，如图，我修改5.1.7为5.1.5版本  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 12]

## 创建父工程，在子工程中引用父工程 ##

首先需要创建一个父工程**Parent01**，创建步骤和普通Maven工程大致相同，唯一不同的就是在选择项目类型时，有三个选项jar、pom、war ，这次选pom类型。创建完后为了方便一会的操作按照项目**MavenProject01**的步骤我们创建**MavenProject02**，创建完后让**Parent**成为**MavenProject01**和**MavenProject02**的父工程。也就是让**MavenProject01**和**MavenProject02**的jar包统一由Parent管理。在**MavenProject01**和**MavenProject02**的pom.xml文件中都添加如下代码：

//Parent01的坐标，从Parent01的pom.xml文件中复制一下坐标就可以
    	<parent>
    	  <groupId>cn.black.maven</groupId>
    	  <artifactId>Parent01</artifactId>
    	  <version>0.0.1-SNAPSHOT</version>
     	</parent>

添加完后会发现两个文件中的坐标代码位置出现了黄色下划线，在这里只需要删除黄色下划线标记的代码即可。  
然后将**MavenProject01**和**MavenProject02**所共有的jar包在父工程**Parent01**中引入就可以而不需要再在子工程中引入。  
**Parent01中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/xsd/maven-4.0.0.xsd">
      <modelVersion>4.0.0</modelVersion>
      <groupId>cn.black.maven</groupId>
      <artifactId>Parent01</artifactId>
      <version>0.0.1-SNAPSHOT</version>
      <packaging>pom</packaging>
      <properties>
      	<cn.black.maven>5.1.5.RELEASE</cn.black.maven>
      </properties>
      <dependencies>
      	<dependency>
    			<groupId>javax.servlet</groupId>
    			<artifactId>servlet-api</artifactId>
    			<version>2.5</version>
    			<scope>provided</scope>
    	</dependency>
    	<dependency>
    	    <groupId>org.springframework</groupId>
    	    <artifactId>spring-context</artifactId>
    	    <version>${
        cn.black.maven}</version>
    	</dependency>
    	<dependency>
    	    <groupId>org.springframework</groupId>
    	    <artifactId>spring-core</artifactId>
    	    <version>${
        cn.black.maven}</version>
    	</dependency>
    	<dependency>
    	    <groupId>org.springframework</groupId>
    	    <artifactId>spring-beans</artifactId>
    	    <version>${
        cn.black.maven}</version>
    	</dependency>	
      </dependencies>
    </project>

**MavenProject01中的pom.xml文件中的代码：**

**MavenProject02中的pom.xml文件中的代码：**

如果需要再修改版本直接在父工程Parent01中修改版本就可以。

## 聚合 ##

将多个工程拆分为模块后，需要手动逐个安装到仓库后依赖才能够生效。修改源码后也需要逐个手动进行 clean 操作。而使用了聚合之后就可以批量进行 Maven 工程的安装、清理工作。  
过程：在父类中添加代码：

<modules>
      	<module>../MavenProject01</module>//子工程的相对路径
      	<module>../MavenProject02</module>//子工程的相对路径
      </modules>

在子工程中一定要添加**relativePath**标签

<parent>
      	<groupId>cn.black.maven</groupId>
      	<artifactId>Parent01</artifactId>
      	<version>0.0.1-SNAPSHOT</version>
      	<relativePath>../Parent01/pom.xml</relativePath>//添加的代码，子工程的pom.xml文件到父工程的pom.xml文件的相对路径
      </parent>

这样右击父工程→5 Maven install安装项目到本地仓库，它的子工程也就一起安装到本地仓库中了,然后在按照坐标在本地仓库中找就可以找到  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 13]

[http_mvnrepository.com]: http://mvnrepository.com/
[Maven]: https://blog.csdn.net/weixin_44789861/article/details/90239835
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70]: /images/20220130/a14168b44ba3468289e158e97cc71c1a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 1]: /images/20220130/4dd6c5503ed34af2a188106b50b89064.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 2]: /images/20220130/b11c925a6c8943c4885f6a252954c4e3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 3]: /images/20220130/c4fdf57534ee4bb8884150114d2601a2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 4]: /images/20220130/07d1f5c98ff1470ba309a15ece9466a2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 5]: /images/20220130/ec4197b2034a4f9bb05797389d2d8f0b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 6]: /images/20220130/2c27c24883d042138d28eeb48000af39.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 7]: /images/20220130/a9bafb05c9cc4b7eb981e1bae18aaf6b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 8]: /images/20220130/245e258a222c428b94aad01940725829.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 9]: /images/20220130/f8e1bbe5c60d4d9dba63761128686b47.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 10]: /images/20220130/455606cead834a91b40b2a51bf8e02de.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 11]: /images/20220130/77503f926382424d921e2fd99a373745.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 12]: /images/20220130/fac53b070623449c877099bbb54a18aa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDc4OTg2MQ_size_16_color_FFFFFF_t_70 13]: /images/20220130/06fd44cd60e14ac1aeedb37d3029c0f1.png