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>