maven入门基础

1.Maven是什么

Maven是一种构建工具（构建是指例如完成清理，编译，测试，打包，发布等一些自定义的过程），类似于make（最早的构建工具，通过一系列目标和依赖将整个构建过程串联起来，同时利用本地命令完成每个目标的实际行为），ant（ant可以看成一个java版 的make，ant 可以跨平台（基于java的原因），且使用xml定义构建脚本，相对于make来说更友好），gradle（基于ant与maven的开发，后续可能取代maven，就好像git逐渐取代svn）

2. maven的安装

下载地址：http://mirrors.hust.edu.cn/apache/maven/maven-3/3.5.3/binaries/

安装：https://jingyan.baidu.com/article/6c67b1d646ae842786bb1e7a.html

3.maven的安装目录解析

bin: 该目录包含了mvn的运行的脚本

boot: 只包含一个文件类加载器框架，保证maven加载自己的类库

conf：配置文件，里面有一个非常重要的setting.xml文件，直接修改可以用于全局，但是一般更偏向于复制到用户目录/.m2/目录下然后修改文件，作用范围为用户范围。

修改仓库地址：

修改setting.xml（最好是用户目录）<localRepository>/path/to/local/repo</localRepository>，默认的位置在Default: ${user.home}/.m2/repository，在seting.xml的文件中有说明

4.maven文件的结构（运行tree/F）

备注：可以手动建立，可以采用mvn  archetype:generate 来建立，也可以采用eclipse的maven插件自动生成等，实现原则约定优于配置

 

 备注：maven的目录结构和原java的目录结构的构建是有所区别的，这个是在不改变编译后路径的前提下，

5.pom配置简要说明

<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>com.cgz.cgz</groupId>

      <artifactId>maventest</artifactId>

      <version>0.0.1-SNAPSHOT</version>

      <name></name>

</project>

说明：

xsd约束文件；

modelVersion 版本，POM文件是遵从哪个版本的项目描述符，默认一般不要去更改

groudID  通常是公司名加项目组

artifactid 项目组中项目的id（唯一）

version  版本，SNAPSHOT表示快照版，在通常情况下不稳定，不建议使用，建议使用release版本较为稳定

name：可以省略不写，通常情况下建议写，进一步对项目的名称进行说明。

package：打包方式，jar，war，pom，package，默认为jar

6.maven在windows下的常用命令

mvn  compile  编译  相应的产生一个target文件夹

mvn  clean 清除 删除target文件

mvn  test  测试

mvn  package 打包

mvn  install 将其打包加入本地仓库

7.maven的生命周期

maven的生命周期有3个，clean清理（clean插件），default构建项目（一系列插件），site建立项目网点（site插件）

整个生命周期如下

Pre-clean 执行一些清理前需要完成的工作------Clean 清理上一次构建生成的文件--------Post-clean 执行一些清理后需要完成的工作-----Clean命令 实现的是pre-clean和clean阶段

Default生命周期

validate ----Initialize----generate-sources----process-sources----generate-resources-----process-resources----compile----process-classes----generate-test-sources--process-test-sources----generate-test-resources----process-testresources----test-compile----process –test-classes----test----prepare-package---package---pre-integration-test----integration-test-----post-integration-test----verify---install---deploy

site生命周期

pre-site 执行一些在生成项目站点之前需要完成的工作

site 生成项目站点文档

post-site 执行 一些在生成项目站点之后需要 完成的工作

site-deploy 生成站点 发布到服务器上

备注

mvn compile  从validate运行到compile 阶段，不包括clean周期。

mvn test 从validate运行到test阶段，包括compile周期，不包括clean周期

mvn package 从validate运行到package 阶段，包括test周期，不包括clean周期

mvn insatall 从validate运行到deploy 阶段，包括package周期，不包括clean周期

mvn clean deploy  site-deploy  会执行3个阶段的所有的生命周期

上编译，测试，打包，安装前先进行clean操作，否则上述可能存在缓存的问题导致，例如compile后修改配置的scope再使用test，不会再次使用compile，而是在compile的基础上进行test。

8.依赖

常规配置

<dependencies>
      <dependency>
          <groupId>javax.servlet</groupId>    
          <artifactId>servlet-api</artifactId>
          <version>2.5</version>
          <type>...</type>
          <scope>provided</scope>    
          <exclusions>   
                <exclusion>...</exclusion>
                    ...
          </exclusions>
          <optional>...</optional>
     </dependency>
<dependencies>   

groupId，artifactid，version类似于上，scope依赖范围（没写默认为compile）,

type类似于上的package（没写默认为jar）,exclusions排除传递性依赖（排除依赖pom中的依赖，排除后不再具有传递性）,options 值为true或者false可选依赖（不具有传递性）

2）依赖的范围和传递性

依赖范围就是用来控制依赖与3种classpath之间的关系（编译classpath，测试claspath，运行classpath）

compile：编译依赖的范围，编译，测试，运行三种classpath都有效（具有传递性）

test：对测试范围有效（不具有传递性，且不会编译在src/main/java下的内容）

provided：对编译和测试有效（不具有传递性）

3）依赖树的查看

mvn  dependency:list  查看依赖树

mvn dependency:tree 更加清晰的看到依赖由那条路径引入

mvn dependency:analyze 可帮助显示当前项目的直接依赖

 

 4）依赖的优先级

路径优先原则和声明优先原则

路径优先原则：多个文件依赖于同一种jar，但是版本不同，那么路径较短者优先

声明优先原则：多个文件依赖于同一种jar，但是版本不同，那么那个先声明那么那个就优先

假如需要自己指定的版本的jar，那么自己指定的优先，在一个pom里面重复书写了多个不同版本的jar，那么就是最后指定的那个

5）依赖的需求

需要在本地仓库中或者自定义的远程仓库中或者私服中存在，否则会依赖错误，例如自己写的一个文件需要依赖自己需写的另一个文件，那么另一个文件首先需要install，否则会找不到依赖文件

9.聚合与继承

1）聚合

聚合的创建，首先创建一个maven project项目，maven project项目需要满足的条件打包方式packging必须是<packaging>pom</packaging>，然后创建一个maven  module，有一个父类的选择，选择刚刚创建的maven project项目，创建完成后的变化如下

<!-- maven  module -->
<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>
  <!-- 选择parent是自动添加的 -->
  <parent>
    <groupId>cn.jdbc.test</groupId>
    <artifactId>jdbctest</artifactId>
    <version>0.0.1-SNAPSHOT</version>
  </parent>
　　<!--取的artifactId-->
  <artifactId>testjdbcmudle1</artifactId>
</project>

<!-- maven project -->
<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.jdbc.test</groupId>
	<artifactId>jdbctest</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<!-- 必须为pom -->
	<packaging>pom</packaging>
	<name>jdbctest</name>
	<!-- 创建maven  module 聚合时自动添加的 相对路径，相对于parent  项目文件的路径-->
	<modules>
		<module>testjdbcmudle1</module>
	</modules>
</project>

 聚合的作用:我们只需要构建常见的 maven project（parent），那么modules中的<module>testjdbcmudle1</module>会跟随构建，这样做的目的是模块化

2）继承

继承的创建，首先创建一个maven project项目，maven project项目的条件打包方式packging必须是<packaging>pom</packaging>，然后创建一个maven project项目的parent是前建立的pom的maven project项目，继承不可以多继承。

<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.jdbc.test2</groupId>
	<artifactId>jdbctest2</artifactId>
	<name>jdbctest2</name>
	<description>jdbctest2</description>
	<parent>
		<groupId>cn.jdbc.test</groupId>
		<artifactId>jdbctest</artifactId>
		<version>0.0.1-SNAPSHOT</version>
		<!-- 相对该pom.xml的父pom.xml的位置 -->
		<relativePath>../jdbctestparent/pom.xml</relativePath>
	</parent>
</project>

 父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.jdbc.test</groupId>
	<artifactId>jdbctest</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<!-- 必须为pom -->
	<packaging>pom</packaging>
	<name>jdbctest</name>
	<dependencies>
			<dependency>
				<groupId>org.junit.jupiter</groupId>
				<artifactId>junit-jupiter-api</artifactId>
				<version>5.2.0</version>
				<scope>test</scope>
			</dependency>
			<dependency>
				<groupId>mysql</groupId>
				<artifactId>mysql-connector-java</artifactId>
				<version>8.0.11</version>
			</dependency>
	</dependencies>
</project>

 按需求实现，在子maven里面需要的话，那么在子maven中需要重写

<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.jdbc.test</groupId>
	<artifactId>jdbctest</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<!-- 必须为pom -->
	<packaging>pom</packaging>
	<name>jdbctest</name>
        <!-- 依赖的自定义实现 -->
	<dependencyManagement>
		<dependencies>
			<dependency>
				<groupId>org.junit.jupiter</groupId>
				<artifactId>junit-jupiter-api</artifactId>
				<version>5.2.0</version>
				<scope>test</scope>
			</dependency>
			<dependency>
				<groupId>mysql</groupId>
				<artifactId>mysql-connector-java</artifactId>
				<version>8.0.11</version>
			</dependency>
		</dependencies>
	</dependencyManagement>
</project>

 对于插件的继承也是同样，头部和尾部省略，替换整个</dependencyManagement>模块即可

<build>
		<pluginManagement>
			<plugins>
				<plugin>
					
				</plugin>
			</plugins>
		</pluginManagement>
</build>

 依赖的优先级上面已经说明，这里不再重复

3）可继承元素

groupId：项目组ID，项目坐标的核心元素。

version：项目版本，项目坐标的核心元素。

description：项目的描述信息。

organization：项目的组织信息。

inceptionYear：项目的创始年份。

url：项目的URL地址。

developers：项目的开发者信息。

contributors：项目的贡献者信息。

distributionManagement：项目的部署配置。

issueManagement：项目的缺陷跟踪系统信息。

ciManagement：项目的持续集成系统信息。

scm：项目的版本控制系统信息。

mailingLists：项目的邮件列表信息。

properties：自定义的Maven属性。

dependencies：项目的依赖配置。

dependencyManagement：项目的依赖管理配置。

repositories：项目的仓库配置。

build：包括项目的源码目录配置、输出目录配置、插件配置、插件管理配置等。

reporting：包括项目的报告输出目录配置、报告插件配置等。

4）依赖的版本管理

       <properties>
                 <springframework.version>5.0.4.RELEASE</springframework.version>
        </properties>

        <dependencies>    
                 <dependency>
                           <groupId>org.springframework</groupId>
                           <artifactId>spring-core</artifactId>
                           <version>${springframework.version}</version>
                 </dependency>               
                 <dependency>
                           <groupId>org.springframework</groupId>
                           <artifactId>spring-beans</artifactId>
                           <version>${springframework.version}</version>
                 </dependency>               
        </dependencies>

10.其他

1）eclipse maven项目的导入

Import –maven –existing maven project

2）eclipse查看仓库地址

Window—preference—maven –usersetting ，在用户目录下setting.xml文件中的仓库位置配置

3）eclipse添加本地的依赖

 

4）eclipse显示仓库

Window—show view—others—maven—maven repositories

 

5）eclipse war的运行测试

tomcat:run

6）http代理（基于安全因素，要求通过安全认证才能够访问，这时候就需要http代理）

在setting.xml中的<proxies>里添加如下配置

<proxy>
      <id>optional</id>
      <active>true</active>
      <protocol>http</protocol>
      <username>proxyuser</username>
      <password>proxypass</password>
      <host>proxy.host.net</host>
      <port>80</port>
      <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
</proxy>

备注：<nonProxyHosts>用来指定那些主机名不需要代理，可以用|符号来分隔多个主机名，支持通配符，如*

11.maven运用过程中遇到的一些问题和解决方法。

1）[WARNING] Using platform encoding (UTF-8 actually) to copy filtered resources, i.e. build is platform dependent!

解决方法：在pom.xml中添加如下配置

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

2）项目下的文件及文件夹没有报错，但是该项目的项目文件夹报错

解决方法：在该项目上鼠标右键，选择maven，然后选择update project，这个会在修改pom后经常出现，例如在maven中更改jre编译环境时，就会出现红叉，按上述操作后会更新jre版本及去除红叉

3）Error code 401, Unauthorized

解决方法：在~/.m2文件夹下添加setting文件，并在setting文件中的servers中添加相应的server认证

4）maven的packaging为war时缺少文件

解决方法：该项目鼠标右键选择properties，然后选择project facts，然后取消Dynamic web module  选择应用 ，然后选择Dynamic web module 选择应用

5）ERROR]No compiler is provided in this environment. Perhaps you are running on a JRE rather than a JDK?

解决方法：点击window选择properties，然后选择java下的install jres ，配置相应的正确的jdk路径和jdk，而不是jre

6）在maven中test依赖修饰的jar只能使用在test的文件夹下，不能使用在main的文件夹下，例如程序包org.junit不存在，因为作用范围没到compile所以报不存在

7）修改jdk版本

<plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-compiler-plugin</artifactId>
                 <version>3.7.0</version>
                 <configuration>
                 <source>1.8</source>
                 <target>1.8</target>
                 <encoding>UTF-8</encoding>
                 </configuration>
</plugin>

也可以在setting中配置成全局的配置

<profile>
                 <id>jdk-1.8</id> 
                 <activation> 
                         <activeByDefault>true</activeByDefault> 
                         <jdk>1.8</jdk> 
                 </activation> 
                <properties> 
                         <maven.compiler.source>1.8</maven.compiler.source> 
                         <maven.compiler.target>1.8</maven.compiler.target> 
                         <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion> 
                 </properties> 
</profile>