如果作为一个Java程序员,那么在日常的开发过程中,maven是很常见的项目构建工具。maven可以极大的提高我们的开发效率,帮助我们简化开发过程中一些解决依赖和项目部署的相关问题,所以学习掌握maven的相关知识是非常有必要的。
本文从入门安装开始,逐步深入讲解maven的相关知识。
首先我们需要准备好安装包,这里推荐在官网下载:maven官网下载地址
我这里下载的是3.8.1版本的maven,不同版本的maven配置过程基本是一样的。
首先将maven安装包解压,根据自己的习惯选择解压目录,后续配置需要使用到解压的目录。我这里解压到了D:\software\Maven,之后的配置也是从这里开始的。
首先要配置Windows的环境变量,如果是最新版的Windows 10,那么右键单击属性后会出现如下页面,点击高级系统设置=>环境变量即可:
接下来就是配置系统变量,首先配置MAVEN_HOME,在系统变量窗口点击新建,然后输入变量名和变量值,变量名为MAVEN_HOME,变量值就是maven的安装路径,可以通过浏览目录找到自己的maven安装位置。
接下来配置系统变量中的path变量,首先选中path变量,然后点击编辑,弹出编辑path变量的窗口,点击新建,在最后一行输入如下参数:%MAVEN_HOME%\bin
此时maven的环境变量已经配置完成了,可以打开cmd窗口,运行mvn -v查看配置是否成功。
将下载好的文件上传至云服务器,我这里直接上传到了/usr/local/目录下,然后直接将其解压
tar -zxvf apache-maven-3.8.1-bin.tar.gz
接下来就是配置环境变量,在/etc/profile文件中添加环境变量,内容如下:
export MAVEN_HOME=/usr/local/apache-maven-3.8.1
export PATH=$PATH:$MAVEN_HOME/bin
然后再运行source /etc/profile使其生效即可。
然后可以运行mvn -v命令查看是否配置成功:
当安装完maven以后,我们还需要配置maven的镜像和我们本地仓库的地址,maven的全局配置文件是安装目录下的conf/settings.xml文件,下面的配置都是在该文件中进行的。
本地仓库是我们新建maven项目并添加依赖后,那些依赖的jar包下载到的位置。
首先看看配置文件,本地仓库路径不配置的话默认为当前用户目录下的./m2文件夹下的repository目录,我们最好自己配置下,管理maven仓库的位置。
配置的话选定自己的仓库目录,然后添加在配置文件中即可,例如我这里是这样配置的:
<localRepository>D:\software\Maven\MavenRepositorylocalRepository>
Linux的话需要注意路径的方式:
<localRepository>/usr/local/apache-maven-3.8.1/MavenRepositorylocalRepository>
如果我们不配置国内镜像的话,那么maven下载依赖可能会非常非常慢,所以我们这里要配置镜像,这里我配置的是阿里云的镜像:
<mirrors>
<mirror>
<id>alimavenid>
<name>aliyun mavenname>
<url>https://maven.aliyun.com/repository/publicurl>
<mirrorOf>centralmirrorOf>
mirror>
mirrors>
当然也可以配置些其他的镜像,例如华为的镜像。
阿里云maven、华为云镜像
我们通常都是使用idea进行项目的开发工作,所以这里接着介绍下idea如何配置我们自己安装的maven,而不是使用idea自带的maven。
首先点击Files->settins打开配置窗口:
然后找到maven的配置,将maven的安装路径和配置文件以及本地仓库的配置均修改为我们自己安装的maven即可:
此外还要配置每个新建项目的maven配置,点击New Projects Settings -> Settings for New Projects:
也是进行相同的配置:
配置完成以后,我们以后就可以使用自己安装的maven在idea中开发项目了。
虽然我们可以使用idea简化项目的开发,但是我们还是要简单了解一下不借助idea如何新建maven项目的。
首先来看看maven的项目结构:
src
|--main
|--java 源代码目录
|--resources 资源目录
|--test
|--java 测试代码目录
|--resources 测试资源目录
target
|--classes 编译后的class文件目录
|--test-classes 编译后的测试class文件目录
pom.xml Maven工程配置文件
其中src、target、pom是同级目录,接下来我们尝试手动创建这些目录:
我们首先来看看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.0modelVersion>
<groupId>cn.wygandwdngroupId>
<artifactId>learn_mavenartifactId>
<version>1.0-SNAPSHOTversion>
project>
然后接着在src/java目录下新建一个Hello.java:
import java.util.*;
class Hello {
public static void main(String[] args) {
System.out.println("Hello Maven");
}
}
然后在项目的根目录下运行mvn compile试试,也就是src文件对应的目录:
出现BUILD SUCCESS就是构建成功了,接下来看看都构建出来了哪些文件:
可以看出,maven自动为我们将Hello.java构建成了Hello.class并放到了target/classes目录下。
是不是很简单,当我们使用idea之后,这些工作都不需要我们来做,都是自动化完成的。
如果我们打开idea,查看maven的话,会发现maven的几个生命周期:
这些生命周期实际上分为三部分,分别是:
这三个生命周期又有各自详细的生命周期。
clean生命周期又分为如下几个阶段:
default又分为如下几个阶段(和idea中显示的正好对应,这是简化版的生命周期):
site生命周期又分为如下几个阶段:
各个生命周期相互独立,互不影响,一个生命周期的阶段前后依赖。
当我们运行maven命令时,例如运行mvn compile,只有该阶段之前以及包括该阶段在内的所有阶段才会被执行,在compile之后的test、package等是不会被执行的。
常用的maven命令:
命令 | 说明 |
---|---|
mvn -v | 显示版本信息 |
mvn clean | 清理项目产生的临时文件,一般是模块下的target目录 |
mvn compile | 编译源代码,一般编译模块下的src/main/java目录 |
mvn package | 项目打包工具,会在target目录下生成jar包或者war包 |
mvn test | 测试命令,或执行src/test/java/下junit的测试用例 |
mvn install | 将打包的jar/war文件复制到本地仓库,供其他模块使用 |
mvn deploy | 将打包的文件发布到远程服务器,供其他人员下载依赖 |
mvn site | 生成项目相关信息的网站 |
mvn dependency:tree | 打印出项目的整个依赖树 |
mvn archetype:generate | 创建maven的普通Java项目 |
首先我们来看看一个简单的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.0modelVersion>
<groupId>cn.wygandwdngroupId>
<artifactId>learn_mavenartifactId>
<version>1.0-SNAPSHOTversion>
<packaging>pompackaging>project>
project>
这是maven项目构建后产生的最基础的pom文件,接下来讲讲这几个标签的含义:
接下来的groupId、artifactId、version是唯一定位一个项目的,相当于项目的坐标:
Maven的version中通常出现如下几个特殊的字符串:SNAPSHOT、LATEST、RELEASE,例如我们使用idea创建的默认maven项目的版本通常为:1.0-SNAPSHOT。各个版本的含义和逻辑为:
我们之前说过,maven最终的功能就是管理依赖,那么这些依赖就是通过dependencies&dependency标签来定义的。
例如:
<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.0modelVersion>
<groupId>cn.wygandwdngroupId>
<artifactId>learn_mavenartifactId>
<version>1.0-SNAPSHOTversion>
<packaging>pompackaging>
<dependencies>
<dependency>
<groupId>junitgroupId>
<artifactId>junitartifactId>
<version>4.12version>
<type>jartype>
<scope>compliescope>
<optional>falseoptional>
<exclusions>
<exclusion>
<groupId>org.slf4jgroupId>
<artifactId>slf4j-apiartifactId>
exclusion>
exclusions>
dependency>
dependencies>
project>
上面的groupId、artifactId、version是定位jar包的坐标,通过这个唯一的标识,maven会自动去仓库引入依赖。
type:代表项目依赖的类型,例如jar、war、pom等。
scope:代表的是这些依赖的作用范围,分别如下:
compile(默认编译范围):该范围是默认依赖范围,此依赖范围对于编译、测试、运行三种classpath都有效,也就是说该范围下的jar包在编译、测试、运行和打包时都可以使用。
test(测试依赖范围):test范围的依赖只对测试classpath有效,在编译主代码和项目运行时,都将无法使用该依赖,最典型的例子就是junit。junit是测试时才需要的依赖,所以它的依赖范围需要指定为test。如果不加范围也不会报错,但是该依赖会被加入到编译和运行的classpath中,会浪费一定的空间
<dependency>
<groupId>junitgroupId>
<artifactId>junitartifactId>
<version>4.7version>
<scope>testscope>
dependency>
provided(已提供依赖):使用该依赖范围时,只对编译和测试的classpath有效,对运行时classpath无效,最典型的例子就是servlet-api,编译和测试项目时都需要该依赖,但是在运行时,web容器已经提供该依赖,所以运行时就不需要此以爱,如果不显示指定该依赖范围,并且容器依赖的版本和maven不一致的话,可能会造成冲突。
<dependency>
<groupId>javax.servletgroupId>
<artifactId>javax.servlet-apiartifactId>
<version>4.0.1version>
<scope>providedscope>
dependency>
runtime(运行时依赖范围):使用该依赖范围时,只对测试和运行的classpath有效,对编译时的classpath无效,典型的例子就是jdbc驱动的实现,项目主代码编译的时候只需要jdk提供的jdbc接口,只有在测试和运行时才需要实现上述接口的具体jdbc驱动。
<dependency>
<groupId>mysqlgroupId>
<artifactId>mysql-connector-javaartifactId>
<version>5.1.25version>
<scope>runtimescope>
dependency>
optional:设置依赖是否可选,默认为false,即子项目默认都继承。如果为true,则子项目必需显示的引入
exclusions:该标签主要用于依赖的排除,该标签包含s,说明可以排除多个依赖,具体排除的依赖通过exclusion标签定义,exclusion中通过groupId和artifactId定位要排除的依赖。
dependencyManagement通常会在父工程中定义,目的就是为了统一各个子模块的依赖版本,也就是管理子项目中依赖的jar包的版本。
该标签只是声明依赖,并不是实际的引入
子项目需要显式的声明需要用的依赖,如果不再子项目中声明依赖,那么子项目是不会从父项目中继承依赖的
只有在子项目中写了该依赖项,并且没有指定具体版本,才会从父项目中继承该项,并且version和scope都读取自父pom;另外如果子项目中指定了版本号,那么会使用子项目中指定的jar版本
在我们创建聚合工程时,使用该标签非常有用
properties定义了一些在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.0modelVersion>
<groupId>cn.wygandwdngroupId>
<artifactId>learn_mavenartifactId>
<version>1.0-SNAPSHOTversion>
<packaging>pompackaging>
<properties>
<mysql.version>8.0.22mysql.version>
properties>
<dependencies>
<dependency>
<groupId>mysqlgroupId>
<artifactId>mysql-connector-javaartifactId>
<version>${mysql.version}version>
dependency>
dependencies>
project>
当我们定义mysql连接依赖时,将其对应的版本通过properties来定义,那么以后修改mysql连接依赖时,只需要修改标签中的依赖即可,不需要再去对应的依赖处修改。
properties标签内一般根据依赖的名称来自定义标签,通过"."进行分割,然后在dependency中引入即可。
当我们引入众多的依赖时,使用properties非常有用,通过properties定义版本,那么修改时,只统一修改这里的版本即可。其子项目也可以使用properties里定义的标签。
来看看build标签下的内容:
<build>
<finalName>myPorjectNamefinalName>
<directory>${basedir}/targetdirectory>
<sourceDirectory>${basedir}\src\main\javasourceDirectory>
<testSourceDirectory>${basedir}\src\test\javatestSourceDirectory>
<outputDirectory>${basedir}\target\classesoutputDirectory>
<testOutputDirectory>${basedir}\target\test-classestestOutputDirectory>
<resources>
<resource>
<directory>src/main/javadirectory>
<includes>
<include>**/*.propertiesinclude>
<include>**/*.xmlinclude>
includes>
<excludes>
<exclude>**/*.propertiesexclude>
excludes>
<filtering>falsefiltering>
resource>
<resource>
<directory>src/main/resourcesdirectory>
<includes>
<include>**/*.propertiesinclude>
<include>**/*.xmlinclude>
includes>
<filtering>falsefiltering>
resource>
resources>
<testResources>
<testResource>
<targetPath />
<filtering />
<directory />
<includes />
<excludes />
testResource>
testResources>
<plugins>
<plugin>
plugin>
plugins>
<pluginManagement>
<plugins>...plugins>
pluginManagement>
build>
resources主要处理资源过滤的问题,这里详细解释下resource标签下的各个属性:
当我们想引入支付包的jar包或者oracle的连接驱动时,可以自己配置jar包的路径,然后引入项目,具体的配置如下:
<plugin>
<groupId>org.apache.maven.pluginsgroupId>
<artifactId>maven-compiler-pluginartifactId>
<inherited>trueinherited>
<configuration>
<source>1.8source>
<target>1.8target>
<encoding>UTF-8encoding>
<compilerArguments>
<extdirs>${project.basedir}/src/main/webapp/WEB-INF/libextdirs>
compilerArguments>
configuration>
plugin>
从这里我们可以看出,不管是引入依赖,还是引入插件,都是通过groupId、artifactId进行唯一的标识,来确定我们引入的具体的依赖或者插件。
<repositories>
<repository>
<id>alimavenid>
<name>aliyun mavenname>
<url>http://maven.aliyun.com/nexus/content/groups/public/url>
<releases>
<enabled>trueenabled>
releases>
<snapshots>
<enabled>falseenabled>
snapshots>
repository>
repositories>
pom.xml里面的仓库与setting.xml里的仓库功能是一样的。主要的区别在于,pom里的仓库是个性化的。比如一 家大公司里的setting文件是公用的,所有项目都用一个setting文件,但各个子项目却会引用不同的第三方库,所 以就需要在pom.xml里设置自己需要的仓库地址。
<name>banseon-maven name>
<url>http://www.clf.com/ url>
<description>A maven project to study maven. description>
<inceptionYear />
<mailingLists>
<mailingList>
<name> Demo name>
<post> [email protected]post>
<subscribe> [email protected]subscribe>
<unsubscribe> [email protected]unsubscribe>
<archive> http:/hi.clf.com/archive>
mailingList>
mailingLists>
<developers>
<developer>
<id> HELLO WORLD id>
<name> banseon name>
<email> [email protected]email>
<url />
<roles>
<role> Project Managerrole>
<role>Architect role>
roles>
<organization> demoorganization>
<organizationUrl>http://hi.clf.com/ organizationUrl>
<properties>
<dept> No dept>
properties>
<timezone> -5timezone>
developer>
developers>
<contributors>
<contributor>
<name />
<email />
<url />
<organization />
<organizationUrl />
<roles />
<timezone />
<properties />
contributor>
contributors>
<licenses>
<license>
<name> Apache 2 name>
<url>http://www.clf.com/LICENSE-2.0.txt url>
<distribution> repodistribution>
<comments> Abusiness-friendly OSS license comments>
license>
licenses>
<organization>
<name> demo name>
<url> http://www.clf.com/url>
organization>
还有其他很多,想要了解的可以去官网看看更加详细的版本。
Maven给我们带来的最大的便利就是自动帮我们下载并且管理依赖,我们不必再向之前那样自己在网上寻找各种依赖,导入工程中;这大大简化了我们的开发工作,提高了效率。
接下来我们来看看maven如何解决依赖问题。
当我们在maven的pom配置文件中引入依赖后,也就是在中配置后,maven会自动帮我们下载我们所需要的依赖。
那么这个依赖是如何下载的呢?
通过上图我们可以发现,当maven项目导入依赖之后,首先从本地仓库查找依赖,找不到则取远程仓库查找,这里去远程仓库就用到了我们之前配置的镜像。
如果在公司内部,电脑无法联网,那么可能查完本地会去私服查找依赖,这个私服既在局域网内部,又可以连接外网,而且在局域网内部下载相当快。私服的配置一般通过nexus来完成的。
在开发过程中,我们的项目可以依赖第三方的jar包,那么第三方的jar包也可以依赖其他人的jar包,那么如果依赖重复了,maven如何解决依赖的传递性呢,它有如下几种原则:
当我们不想要某个jar包依赖的jar包时,我们可以通过exclusions来排除jar包的依赖。
在项目开发过程中,我们通常使用maven构建一个整体的项目,然后在其中构建不同的子模块进行开发工作,那么这些父子工程就对应了聚合和继承。
对于聚合和继承,有两个关键的标签,分别是parent和modules:
可以被继承的元素如下:
可以被继承的POM元素如下:
此外还有一些项目的描述信息也可以被继承:
首先选择新建maven项目:
不选择任何模板,直接next,然后给定项目的名称,点击finish即可完成项目的创建:
项目创建完成后可以删除对应的src目录,因为我们要创建子模块,不会在这个父工程中写代码:
然后右键项目名,选择新建module:
选择父模块,并且填写相关的信息:
当新建完成以后,我们看看两个工程的pom文件:
可以看到对应的父子信息了。
当我们创建分布式项目时,往往都是创建一个maven项目,然后在其下面创建不同的子模块。这些子模块有可能是spring boot项目,如果使用idea的Spring Initializr创建的话,那么默认父项目为:
<parent>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-parentartifactId>
<version>2.3.1.RELEASEversion>
<relativePath/>
parent>
这个默认的父项目为我们定义了各种各样的依赖版本,我们在开发过程中可以很轻松的解决版本相关的问题。
但是这样的话,我们统一创建的maven项目就没有意义了,那么我们如何解决这个问题呢?
如果我们查看这个父工程的话,可以发现它的父工程为:
我们再看看spring-boot-dependencies:
其实这个spring-boot-dependencies已经为我们定义好了各种版本依赖,那么真正解决版本问题的实际上就是spring-boot-dependencies,所以如果我们在父maven项目中依赖了spring-boot-dependencies,那么也可以进行版本的配置管理,不用担心复杂的版本问题,所以我们可以使用如下方式新建分布式项目。
这里我们使用spring-boot-dependencies进行了版本的管理。
那么对应的父工程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.0modelVersion>
<groupId>cn.wygandwdngroupId>
<artifactId>micro_officialartifactId>
<packaging>pompackaging>
<version>1.0-SNAPSHOTversion>
<modules>
<module>micro_official_newsmodule>
modules>
<properties>
<maven.compiler.source>8maven.compiler.source>
<maven.compiler.target>8maven.compiler.target>
<mysql-connector-java.version>8.0.22mysql-connector-java.version>
<mybatis-spring-boot-starter.version>2.1.4mybatis-spring-boot-starter.version>
<lombok.version>1.18.20lombok.version>
<spring.boot.dependencies.version>2.4.5spring.boot.dependencies.version>
<fastjson.version>1.2.47fastjson.version>
properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-dependenciesartifactId>
<version>${spring.boot.dependencies.version}version>
<type>pomtype>
<scope>importscope>
dependency>
<dependency>
<groupId>org.mybatis.spring.bootgroupId>
<artifactId>mybatis-spring-boot-starterartifactId>
<version>${mybatis-spring-boot-starter.version}version>
dependency>
<dependency>
<groupId>mysqlgroupId>
<artifactId>mysql-connector-javaartifactId>
<version>${mysql-connector-java.version}version>
<scope>runtimescope>
dependency>
<dependency>
<groupId>org.projectlombokgroupId>
<artifactId>lombokartifactId>
<version>${lombok.version}version>
<scope>providedscope>
dependency>
<dependency>
<groupId>com.alibabagroupId>
<artifactId>fastjsonartifactId>
<version>${fastjson.version}version>
dependency>
dependencies>
dependencyManagement>
project>
子工程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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0modelVersion>
<parent>
<groupId>cn.wygandwdngroupId>
<artifactId>micro_officialartifactId>
<version>1.0-SNAPSHOTversion>
parent>
<artifactId>micro_official_newsartifactId>
<name>micro_official_newsname>
<description>newsdescription>
<properties>
<java.version>1.8java.version>
properties>
<dependencies>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-webartifactId>
dependency>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-testartifactId>
<scope>testscope>
dependency>
dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-maven-pluginartifactId>
plugin>
plugins>
build>
project>
Maven实际上是依赖插件执行的框架,每个任务实际上是由插件完成的,Maven插件通常被用来:
插件通常提供了一个目标的集合,并且可以使用下面的语法执行:
mvn [plugin-name]:[goal-name]
例如,一个 Java 工程可以使用 maven-compiler-plugin 的 compile-goal 编译,使用以下命令:
mvn compiler:compile
<build>
<plugins>
<plugin>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-maven-pluginartifactId>
plugin>
plugins>
build>
Spring Boot的Maven插件(Spring Boot Maven plugin)能够以Maven的方式为应用提供Spring Boot的支持,即为Spring Boot应用提供了执行Maven操作的可能。
Spring Boot Maven plugin能够将Spring Boot应用打包为可执行的jar或war文件,然后以通常的方式运行Spring Boot应用。
Spring Boot Maven plugin的5个Goals
maven还有很多知识,了解了这些基本的maven知识以后,其他相关的知识也可以很快掌握。
更多有关maven的知识可以参考官网,以上讲述的知识已经可以胜任我们日常的开发工作了。
Maven官网
bilibili
尚硅谷