用maven管理项目包(Maven项目管理工具的介绍和使用)
用maven管理项目包(Maven项目管理工具的介绍和使用)[4] 报告report:测试程序执行的结果;[3] 测试test:自动测试,自动调用junit程序;项目构建过程包括【清理项目】→【编译项目】→【测试项目】→【生成测试报告】→【打包项目】→【安装项目】→【部署项目】这几个步骤,这几个步骤就是一个项目的完整构建过程,我们在项目开发过程中不一定需要使用所有的步骤,往往只需要使用到其中几个关键步骤。[1] 清理clean:将以前编译得到的旧文件class字节码文件删除,为下一次编译做准备;[2] 编译compile:将java源程序编译成class字节码文件;
在我们的项目开发过程中,常常会使用Maven作为依赖,来快速地引入依赖进行开发。很多人都知道maven或者使用的次数也非常多,今天我们就来了解一下maven,系统地介绍一下。
1、Maven的基本概念
Maven是跨平台的项目管理工具。主要服务于基于Java平台的项目构建,依赖管理和项目信息管理。接下来我们就来介绍一下项目构建和依赖管理。
1.1、项目构建
项目构建过程包括【清理项目】→【编译项目】→【测试项目】→【生成测试报告】→【打包项目】→【安装项目】→【部署项目】这几个步骤,这几个步骤就是一个项目的完整构建过程,我们在项目开发过程中不一定需要使用所有的步骤,往往只需要使用到其中几个关键步骤。
[1] 清理clean:将以前编译得到的旧文件class字节码文件删除,为下一次编译做准备;
[2] 编译compile:将java源程序编译成class字节码文件;
[3] 测试test:自动测试,自动调用junit程序;
[4] 报告report:测试程序执行的结果;
[5] 打包package:动态Web工程打War包,java工程打jar包;
[6] 安装install:Maven特定的概念—–将打包得到的文件复制到“仓库”中的指定位置;
[7] 部署deploy:将动态Web工程生成的war包复制到Servlet容器下,使其可以运行;
相关的maven命令:
- mvn clean:清理;
- mvn compile:编译主程序;
- mvn test-compile:编译测试程序;
- mvn test:执行测试;
- mvn package:打包;
- mvn install:安装jar到本地仓库;
- mvn deploy:将最终的包复制到远程的仓库,以让其它开发人员与项目共享;
- mvn site:生成项目站点信息;
- mvn clean install:组合命令,告诉Maven clean在每个模块中执行install阶段;
1.2、依赖管理
依赖指的是jar包之间的相互依赖,比如我们搭建一个struts2的开发框架时,如果只有struts2-core.jar这个jar包是不行的,struts2-core.jar还依赖其它的jar包,依赖管理指的就是使用Maven来管理项目中使用到的jar包,Maven管理的方式就是“自动下载项目所需要的jar包,统一管理jar包之间的依赖关系”。
2、Maven安装
2.1、安装或者查看环境
首先要确保开发环境已经安装了JDK,配置好JDK的环境变量,使用如下的两个命令检查检查JDK安装的情况。
① Echo %JAVA_HOME%
② Java –version
2.2、下载maven
到官网maven.apache.org下载对应操作系统的版本,比如我是windows系统,我会选择下载apache-maven-3.8.6-bin.zip,下载之后对zip压缩文件进行解压。如果是linux操作系统,可以下载后缀是gz格式的压缩包。
2.3、设置系统环境变量
桌面“我的电脑”->右键打开“属性”->“高级系统设置”->"环境变量" 中设置 MAVEN_HOME,设置为maven的解压缩目录。小编之前已经安装了3.8.1版本,而不是最新的3.8.6版本,后续以此版本截图说明。
2.4、设置环境变量Path
将%MAVEN_HOME%\bin加入Path中,一定要注意要用分号;与其他值隔开。%MAVEN_HOME%\bin代表的就是"D:\install\apache-maven-3.8.1\bin"目录(这是我的安装目录,每个人这里对应的自己的安装目录)。
2.5、验证Maven安装是否成功
打开cmd窗口,输入"mvn –v"命令 查看Maven的相关信息。会显示maven的版本、jdk的版本信息以及操作信息的相关信息。
3、Maven的简单使用
3.1、Maven项目的目录约定
3.2、maven的配置文件setting.xml
我们先来了解一下setting.xml 配置文件格式和内容。
上面这个例子看起来比较复杂,但我们在实际使用中往往只关注两个方面,一个是配置本地仓库的路径,一个是设置下载依赖的来源。
<!--本地仓库。该值表示构建系统本地仓库的路径。其默认值为~/.m2/repository。-->
<localRepository>E:\mavenRepository\repository</localRepository>
<!--为仓库列表配置的下载镜像列表。-->
<mirror>
<id>nexus-aliyun</id>
<mirrorOf>central</mirrorOf>
<name>Nexus aliyun</name>
<url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>
配置好setting.xml 配置文件,然后就可以在开发工具中引入,我以IntelliJ IDEA为例。
4、Maven坐标
maven项目,跟maven相关的最重要的文件就是pom.xml文件了,我们来了解一下。
4.1、Maven坐标主要组成
- groupId:组织标识(包名);
- artifactId:项目名称;
- version:项目的当前版本;
- packaging:项目的打包方式,最为常见的jar和war两种。
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.4.1</version>
<relativePath />
</parent>
<groupId>com.bianchengxia.springboot</groupId>
<artifactId>springboot</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>springboot</name>
<packaging>jar</packaging> <!-- jar或者war -->
4.2、依赖管理
我们在标签对dependencies内,引入项目所需要的依赖。
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-autoconfigure</artifactId>
</dependency>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.2</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<!--切面日志 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-aop</artifactId>
</dependency>
<!--mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.3</version>
</dependency>
<!-- mysql依赖jar -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.22</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
</dependencies>
4.3、添加外部依赖
正常的我们引入远程仓库的依赖,直接可以是使用上面的方式,但是如果我们需要引入项目里面的依赖,比如一个开源的项目有一个私有的依赖包,我们下载下来之后需要引入才能正常运行或者打包。那我们就可以使用下面的方式:除了引入依赖之外,再添加配置,设置includeSystemScope为true。
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<!--打包时将外部引入的jar包打包,不加此配置,本地可以运行,但服务器上jar中是没有的-->
<includeSystemScope>true</includeSystemScope>
</configuration>
</plugin>
</plugins>
</build>
5、Maven仓库
maven仓库的分类:本地仓库和远程仓库。其中远程仓库包括中央仓库、私服和其他公共库。
5.1、远程仓库
(1)中央仓库:Maven默认的远程仓库,中央仓库是远程仓的核心。中央仓库包含了绝大多数流行开源Java构件,以及源码、作者信息、SCM、信息、许可证信息等。如果中央仓库慢可以用mirrors来替换它,它的id是central。
<!-- 中央仓库 -->
<repositories>
<repository>
<id>central</id>
<name>Central Repository</name>
<url>http://repo.maven.apache.org/maven2</url>
<layout>default</layout>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
(2)私服:是一种特殊的远程仓库,maven私服是指私有服务器,是针对局域网而言的,目的是代理远程仓库及部署第三方构建,很多公司会搭建自己的私服。有了私服之后,当 Maven 需要下载构件时,直接请求私服,私服上存在则下载到本地仓库;否则,私服请求外部的远程仓库,将构件下载到私服,再提供给本地仓库下载。
(3)其他公共库:默认的远程仓库也就是中央仓库往往下载比较慢,所以很多公司会搭建私服,但是搭建私服也比较麻烦,这个时候有人就想,能不能使用“拿来主义”直接使用别人搭建好的仓库呢?当然可以,这就是其他公共库,对外开放,我们可以直接使用。比如我们在上面的setting.xml 配置文件里面<mirror>标签对里面设置的仓库,就是阿里云开放的公共仓库。
5.2、本地仓库
maven在本地存储构件的路径,一般本地仓库地址可以在settings.xml里边指定。我们在上面介绍settings.xml文件时也说明了,设置localRepository元素的值为本地仓库路径。
6、maven模块聚合和继承
6.1、顶级pom文件配置
6.2、模块聚合配置
6.3、继承配置代码
继承代码过程中,可以定义属性,例如:
<!--属性定义-->
<properties>
<!--项目构建基本配置-->
<spring.version>3.2.0.RELEASE</spring.version>
<struts.version>2.3.15.1</struts.version>
<servlet.version>3.0.1</servlet.version>
<urlrewriter.version>4.0.4</urlrewriter.version>
</properties>
访问属性的方式为${junit.version},例如:
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>${junit.version}</version>
<scope>test</scope>
</dependency>
父模块用dependencyManagement进行管理:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.tydic.framework</groupId>
<artifactId>frameworkbase</artifactId>
<version>${framework.version}</version>
</dependency>
</dependencies>
<dependencyManagement>