Maven


Maven 简介

Maven是什么

  • Maven 的本质是一个项目管理工具,将项目开发和管理过程抽象成一个项目对象模型(POM)
  • POM(Projecet Object Model):项目对象模型

Maven的作用

  • 项目构建:提供标准的、跨平台的自动化项目构建方式
  • 依赖管理:方便快捷的管理项目依赖的资源(jar包),避免资源间的版本冲突问题
  • 统一开发结构:提供标准的、统一的项目结构

安装maven

下载地址:http://maven.apache.org

安装前先检查下JAVA_HOME环境变量。Maven是使用java开发的,所以必须知道当前系统环境中JDK安装目录

echo %JAVA_HOME%

>>>C:\Program Files\Java\jdk1.8.0_271\

下载maven zip包后解压即可。

在环境变量处配置 MAVEN_HOME

PATH处加上 %MAVEN_HOME%\bin

Maven 基础概念

仓库

  • 仓库:用于存储资源,包含各种jar包
  • 仓库分类:
    • 本地仓库:自己电脑上存储资源的仓库,连接远程仓库获取资源
    • 远程仓库:非本机电脑上的仓库,为本地仓库提供资源
      • 中央仓库:Maven团队维护,存储所有资源的仓库
      • 私服:部门/公司范围内存储资源的仓库,从中央仓库获取资源
  • 私服的作用:
    • 保存具有版权的资源,包含购买或自主研发的jar
      • 中央仓库中的jar都是开源的,不能存储具有版权的资源
    • 一定范围内共享资源,仅对内部开放,不对外共享

坐标

  • 什么是坐标

    Maven中的坐标用于描述仓库中资源的位置

    https://repo1.maven.org/maven2/

  • Maven 坐标主要组成

    groupId:定义当前Maven项目隶属组织名称(通常是域名反写,例如:org.mybatis)
    
    artifactId:定义当前Maven项目名称(通常是模块名称,例如CRM、SMS)
    
    version:定义当前项目版本号
    
    packaging:定义该项目的打包方式
    
  • Maven坐标的作用

    使用唯一标识,唯一性定位资源位置,通过该标识可以将资源的识别与下载工作交由机器完成

可以在https://mvnrepository.com里面找

本地仓库配置

配置文件地址:%MAVEN_HOME%\conf\settings.xml

默认放置地址:${user.home}/.m2/repository

一开始是没有这个.m2文件的。只有运行过mvn之后才会生成

可以自定义配置:D:\maven\repository

远程仓库配置

Maven 默认连接的仓库位置(不用修改)


	
		central
		Central Repository
		https://repo.maven.apache.org/maven2
		default
		
			false
		
	


镜像仓库配置

还是在%MAVEN_HOME\conf\settings.xml%里面,配置阿里云镜像仓库


	
	
		
		nexus-aliyun
		
		central
		
		Nexus aliyun
		
		https://maven.aliyun.com/repository/public
	


全局setting与用户setting区别

  • 全局setting定义了当前计算器中Maven的公共配置
  • 用户setting定义了当前用户的配置

具体的不写了,正常不会用到用户setting

第一个Maven项目(手工制作)

Maven工程目录结构

在src同层目录下创建pom.xml

<?xml version="1.0" encoding="UTF-8"?>

	4.0.0
	com.itheima
	project-java
	1.0
	jar
	
		
			junit
			junit
			4.12
		
	


构建命令

Maven 构建命令使用mvn开头,后面添加功能参数,可以一次执行多个命令,使用空格分割

mvn compile     #编译
mvn clean       #清理
mvn test        #测试
mvn package     #打包
mvn install     #安装到本地仓库

插件创建工程

  • 创建工程
mvn archetype:generate
	-DgroupId={project-packaging} 
	-DartifactId={project-name} 
	-DarchetypeArtifactId=maven-archetype-quickstart
	-DinteractiveMode=false
  • 创建java工程
mvn archetype:generate -DgroupId=com.itheima -DartifactId=java-project -
DarchetypeArtifactId=maven-archetype-quickstart -Dversion=0.0.1-snapshot -
DinteractiveMode=false
  • 创建web工程
mvn archetype:generate -DgroupId=com.itheima -DartifactId=web-project -
DarchetypeArtifactId=maven-archetype-webapp -Dversion=0.0.1-snapshot -
DinteractiveMode=false

第一个Maven项目(IDEA生成)

配置Maven

Idea 和 Maven两家公司做的,所以有可能会出现兼容性问题

手工创建java项目



写些代码
src\main\java下创建一个Demo类

public class Demo {
    public String say(String name) {
        System.out.println("hello" + name);
        return "hello" + name;
    }
}

src\main\test下创建一个DemoTest类

import org.junit.Assert;
import org.junit.Test;

public class DemoTest {

    @Test
    public void testSay() {
        Demo d = new Demo();
        String ret = d.say("dy");
        Assert.assertEquals("hellody",ret);
    }
}

下图所示区域,双击就能用 maven了

另一种方式

原型创建Java项目

原型创建Web项目

插件


    
    
        
        
            
            
                

                org.apache.tomcat.maven
                tomcat7-maven-plugin
                2.2

            
        
    


也可以改端口和访问路径


<?xml version="1.0" encoding="UTF-8"?>


    4.0.0

    war


    webtest

    com.dy

    webtest

    1.0-SNAPSHOT


    

        
          junit
          junit
          4.12
        
    

    
    
        
        
            
            
                

                org.apache.tomcat.maven
                tomcat7-maven-plugin
                2.2
                
                    80
                    /
                

            
        
    


依赖管理

依赖配置

依赖指当前项目运行所需的jar,一个项目可以设置多个依赖



	
	
		
		junit
		
		junit
		
		4.12
	


依赖传递

依赖具有传递性

  • 直接依赖:在当前项目中通过依赖配置建立的依赖关系
  • 间接依赖:被依赖的资源如果依赖其他资源,当前项目间接依赖其他资源

依赖年底冲突问题

  • 路径优先:当依赖中出现相同的资源时,层级越深,优先级越低,层级越浅,优先级越高
  • 声明优先:当资源在相同层级被依赖时,配置顺序靠前的覆盖配置顺序靠后的
  • 特殊优先:当同级配置了相同资源的不同版本,后配置的覆盖先配置的

可选依赖

可选依赖指对外隐藏当前所依赖的资源 -- 不透明

比如A依赖B,B里面设置了junit可选依赖,则在A下看不到B依赖的junit


	junit
	junit
	4.12
	true

排除依赖

排除依赖指主动断开依赖的资源,被排除的资源无需指定版本--不需要

比如A依赖B,A里面设置了junit的排除依赖,则不会依赖B的junit


	junit
	junit
	4.12
	
		
			org.hamcrest
			hamcrest-core
		
	

依赖范围


	junit
	junit
	4.12
	compile

  • 依赖的jar默认情况可以在任何地方使用,可以通过scope标签设定其作用范围
  • 作用范围
    • 主程序范围有效(main文件夹范围内)
    • 测试程序范围有效(test文件夹范围内)
    • 是否参与打包(package指令范围内)
scope 主代码 测试代码 打包 范例
compile(默认) Y Y Y log4j
test Y junit
provided Y Y servlet-api
runtime Y jdbc

依赖范围传递性

带有依赖范围的资源在进行传递时,作用范围将受到影响

生命周期与插件

项目构建生命周期

Maven构建生命周期描述的是一次构建过程经历了多少个事件

Maven 对项目构建的生命周期划分为3套

  • clean:清理工作
  • default:核心工作,例如编译,测试,打包,部署等
  • site:产生报告,发布站点等

clean 生命周期

  1. pre-clean 执行一些需要在clean之前完成的工作
  2. clean 移除所有上一次构建生成的文件
  3. post-clean 执行一些需要在clean之后立刻完成的工作

default 构建生命周期

site 构建生命周期

  1. pre-site 执行一些需要在生成站点文档之前完成的工作
  2. site 生成项目的站点文档
  3. post-site 执行一些需要在生成站点文档之后完成的工作,并且为部署做准备
  4. site-deploy 将生成的站点文档部署到特定的服务器上

插件

Maven – Available Plugins (apache.org)

  • 插件与生命周期内的阶段绑定,在执行到对应生命周期时执行对应的插件功能
  • 默认maven在各个生命周期上绑定有预设的功能
  • 通过插件可以自定义其他功能

	
		
			org.apache.maven.plugins
			maven-source-plugin
			2.2.1
			
				
					
						jar
					
					generate-test-resources
				
			
		
	



以下是高级部分

分模块开发与设计

工程模块与模块划分

ssm_pojo拆分

  • 新建模块
  • 拷贝原始项目中对应的相关内容到ssm_pojo模块中
    • 实体类(User)
    • 配置文件(无)

ssm_dao拆分

  • 新建模块
  • 拷贝原始项目中对应的相关内容到ssm_dao模块中
    • 数据层接口(UserDao)
    • 配置文件:保留与数据层相关配置文件(3个)
      • 注意:分页插件在配置中与SqlSessionFactoryBean绑定,需要保留
    • pom.xml:引入数据层相关坐标即可,删除springmvc相关坐标
      • spring
      • mybatis
      • spring整合mybatis
      • mysql
      • druid
      • pagehelper
      • 直接依赖ssm_pojo(对ssm_pojo模块执行install指令,将其安装到本地仓库)

ssm_service拆分

  • 新建模块
  • 拷贝原始项目中对应的相关内容到ssm_service模块中
    • 业务层接口与实现类(UserService、UserServicelmpl)
    • 配置文件:保留与数据层相关配置文件(1个)
    • pom.xml:引入数据层相关坐标即可,删除springmvc相关坐标
      • spring
      • junit
      • spring整合junit
      • 直接依赖ssm_dao(对ssm_dao模块执行install指令,将其安装到本地仓库)
      • 间接依赖ssm_pojo(由ssm_dao模块负责依赖关系的建立)
    • 修改service模块spring核心配置文件名,添加模块名称,格式:applicationContext-service.xml
    • 修改dao模块spring核心配置文件名,添加模块名称,格式:applicationContext-dap.xml
    • 修改单元测试引入的配置文件名称,由单个文件修改为多个文件

ssm_control拆分

  • 新建模块(使用webapp模板)
  • 拷贝原始项目中对应的相关内容到ssm_controller模块中
    • 表现层控制器类与相关设置类(UserController、异常相关。。。。)
    • 配置文件:保留与表现层相关配置文件(1个)、服务器相关配置文件(1个)
    • pom.xml:引入数据层相关坐标即可,删除springmvc相关坐标
      • spring
      • springmvc
      • jackson
      • servlet
      • tomcat服务器插件
      • 直接依赖ssm_service(对ssm_service模块执行install指令,将其安装到本地仓库)
      • 间接依赖ssm_dao、ssm_pojo
    • 修改web.xml配置文件中加载spring环境的配置文件名称,使用 * 通配,加载所有applicationContext-开始的配置文件

小节

  • 分模块开发
    • 模块中仅包含当前模块对应的功能类与配置文件
    • spring核心配置根据模块功能不同进行独立制作
    • 当前模块所依赖的模块通过导入坐标的形式加入当前模块后才可以使用
    • web.xml需要加载所有的spring核心配置文件

聚合

多模块构建维护

作用:聚合用于快速构建maven工程,一次性构建多个项目/模块

制作方式:

  • 创建一个空模块,打包类型定义为pom
pom
  • 定义当前模块进行构建操作时关联的其他模块名称

    ../ssm_controller
    ../ssm_service
    ../ssm_dao
    ../ssm_pojo

  • 注意事项:参与聚合操作的模块最终执行顺序与模块间的依赖关系有关,与配置顺序无关
<?xml version="1.0" encoding="UTF-8"?>


    4.0.0


    webtest
    com.dy
    webtest
    1.0-SNAPSHOT


    pom

    
    
        
        ../ssm_controller
        ../ssm_service
        ../ssm_dao
        ../ssm_pojo
    

继承

模块依赖关系维护

作用:通过集成可以实现在子工程中沿用父工程中的配置(maven中的继承与java中的继承相似,在子工程中配置继承关系)

制作方式:

  • 在子工程中声明其父工程坐标与对应的位置


	com.itheima
	ssm
	1.0-SNAPSHOT
	
	../ssm/pom.xml


继承依赖定义

  • 在父工程中定义依赖管理


	
	
		
		
			org.springframework
			spring-context
			5.1.9.RELEASE
		
	

继承依赖使用

在子工程中定义依赖关系,无需声明依赖版本,版本参照父工程中依赖的版本


	
	
		org.springframework
		spring-context
	


具体使用

parent的pom

<?xml version="1.0" encoding="UTF-8"?>

    4.0.0

    com.itheima
    ssm
    1.0-SNAPSHOT
    
    pom

    
    
        
        ../ssm_controller
        ../ssm_service
        ../ssm_dao
        ../ssm_pojo
    

    
    
        
        
            
            
                com.itheima
                ssm_pojo
                1.0-SNAPSHOT
            

            
                com.itheima
                ssm_dao
                1.0-SNAPSHOT
            

            
                com.itheima
                ssm_service
                1.0-SNAPSHOT
            


            
            
            
            
                org.springframework
                spring-context
                5.1.9.RELEASE
            


            
            
            
            
                org.mybatis
                mybatis
                3.5.3
            
            
            
                mysql
                mysql-connector-java
                5.1.47
            
            
            
                org.springframework
                spring-jdbc
                5.1.9.RELEASE
            
            
            
                org.mybatis
                mybatis-spring
                2.0.3
            
            
            
                com.alibaba
                druid
                1.1.16
            
            
            
                com.github.pagehelper
                pagehelper
                5.1.2
            

            
            
            
            
                org.springframework
                spring-webmvc
                5.1.9.RELEASE
            
            
            
                com.fasterxml.jackson.core
                jackson-databind
                2.9.0
            
            
            
                javax.servlet
                javax.servlet-api
                3.1.0
                provided
            


            
            
            
            
            
                junit
                junit
                4.12
            
            
            
                org.springframework
                spring-test
                5.1.9.RELEASE
            
        

    

    
        
            
            
                
                
                    org.apache.tomcat.maven
                    tomcat7-maven-plugin
                    2.1
                    
                        80
                        /
                    
                
            
        
    


其中一个子项目的pom

<?xml version="1.0" encoding="UTF-8"?>


    
    
      com.itheima
      ssm
      1.0-SNAPSHOT
      
      ../ssm/pom.xml
    

    4.0.0

    ssm_controller
    war

    
        UTF-8
        1.8
        1.8
    

    

        
            com.itheima
            ssm_service
        

        
        
        
        
            org.springframework
            spring-webmvc
        
        
        
            com.fasterxml.jackson.core
            jackson-databind
        
        
        
            javax.servlet
            javax.servlet-api
            provided
        

    

    
        
        
            
            
                org.apache.tomcat.maven
                tomcat7-maven-plugin
            
        
    


继承的资源

继承与聚合

作用

  • 聚合用于快速构建项目
  • 继承用于快速配置

相同点

  • 聚合与继承的pom.xml文件打包方式均为pom,可以将两种关系制作到同一个pom文件中
  • 聚合与继承均属于设计型模块,并无实际的模块内容

不同点

  • 聚合是在当前模块中配置关系,聚合可以感知到参与聚合的模块有哪些
  • 继承是在子模块中配置关系,父模块无法感知哪些子模块继承了自己

# 属性

版本统一的重要性

属性类别

  1. 自定义属性
  2. 内置属性
  3. Setting属性
  4. Java系统属性
  5. 环境变量属性

属性类别:自定义属性

作用

  • 等同于定义变量,方便同意维护

定义格式



	5.1.9.RELEASE
	4.12

调用格式


	org.springframework
	spring-context
	${spring.version}


属性类别:内置属性

作用

  • 使用maven内置属性,快速配置

调用格式

${basedir}
${version}

属性类别:Setting属性

作用

  • 使用Maven配置文件setting.xml中的标签属性,用于动态配置

调用格式

${settings.localRepository}

属性类别:Java系统属性

作用

  • 读取Java系统属性

调用格式

${user.home}

系统属性查询方式

mvn help:system

属性类别:环境变量属性

作用

  • 使用Maven配置文件setting.xml中的标签属性,用于动态配置

调用格式

${env.JAVA_HOME}

环境变量属性查询方式

mvn help:system

版本管理

工程版本

  • SNAPSHOT(快照版本)
    • 项目开发过程中,为方便团队成员合作,解决模块间相互依赖和时时更新的问题,开发者对每个模块进行构建的时候,输出的临时性版本叫快照版本(测试阶段版本)
    • 快照版本会随着开发的进展不断更新
  • RELEASE(发布版本)
    • 项目开发到进入阶段里程碑后,向团队外部发布较为稳定的版本,这种版本所对应的构建文件是稳定的

工程版本号约定

  • 约定规范
    • <主版本>.<次版本>.<增量版本>.<里程碑版本>
    • 主版本:表示项目重大架构的变更,如:spring5相较于spring4的迭代
    • 次版本:表示有较大的功能增加和变化,或者全面系统地修复漏洞
    • 增量版本:表示有重大漏洞的修复
    • 里程碑版本:表明一个版本的里程碑(版本内部)。这样的版本同下一个正式版本相比,相对来说不是很稳定,有待更多的测试
  • 范例
    • 5.4.3.RELEASE

资源配置

资源配置多文件维护

配置文件引用pom属性

作用

  • 在任意配置文件中加载pom文件中定义的属性

调用格式

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=${jdbc.url}
jdbc.username=root
jdbc.password=123456

开启配置文件加载pom属性



	
		
		${project.basedir}/src/main/resources
		
		true
	


多环境开发配置

多环境配置



	
	
		
		pro_env
		
		
			jdbc:mysql://127.1.1.1:3306/ssm_db
		
		
		
			true
		
	
	
	
		dev_env
		……
	


加载指定环境

作用

  • 加载指定环境配置

调用格式

mvn 指令 –P 环境定义id

范例

mvn install –P pro_env

跳过测试

使用命令跳过测试

mvn 指令 –D skipTests

使用界面操作跳过测试

使用配置跳过测试


	maven-surefire-plugin
	2.22.1
	
    	
		true
        
		
    		
			**/User*Test.java
		
    	
		
			**/User*TestCase.java
		
	


私服

分模块合作开发

Nexus

下载地址:https://help.sonatype.com/repomanager3/product-information/download

安装、启动与配置

启动服务器(命令行启动)

nexus.exe /run nexus

访问服务器(默认端口:8081)

http://localhost:8081

修改基础配置信息

  • 安装路径下 etc 目录中 nexus-default.properties 文件保存有 nexus 基础配置信息,例如默认访问端口

修改服务器运行配置信息

  • 安装路径下bin目录中 nexus.vmoptions 文件保存有 nexus 服务器启动对应的配置信息,例如默认占用内存空间

私服资源获取

仓库分类

  • 宿主仓库 hosted
    • 保存无法从中央仓库获取的资源
      • 自主研发
      • 第三方非开源项目(比如orcale的jar包)
  • 代理仓库proxy
    • 代理远程仓库,通过nexus访问其他公共仓库,例如中央仓库
  • 仓库组group
    • 将若干个仓库组成一个群组,简化配置
    • 仓库组不能保存资源,属于设计型仓库

idea环境中资源上传与下载

访问私服配置(本地仓库访问私服)

配置本地仓库访问私服的权限(setting.xml)


	
		heima-release
		admin
		admin
	
	
		heima-snapshots
		admin
		admin
	

配置本地仓库资源来源(setting.xml)


	
		nexus-heima
		*
		http://localhost:8081/repository/maven-public/
	


访问私服配置(项目工程访问私服)

配置当前项目访问私服上传资源的保存位置(pom.xml)


	
		heima-release
		http://localhost:8081/repository/heima-release/
	
	
		heima-snapshots
		http://localhost:8081/repository/heima-snapshots/
	


发布资源到私服命令

mvn deploy

附件1:POM文件总体配置说明

 

     
     
         
        xxx

        
        xxx 

         
        xxx

         
        xxx 
     

     
     4.0.0  

     
    xxx 

     
    xxx 

     
     jar  

     
     1.0-SNAPSHOT  

     
     xxx-maven  

     
     http://maven.apache.org  

     
     A maven project to study maven.  

     
     
         
         
     

     
     
         
         jira  

         
         http://jira.baidu.com/banseon  
     

     
     
         
         

         
         

         
         
             
             
                 
                 

                 
                 

                 
                 

                 
                 

                 
                 

                 
                
Demo banseon@126.com banseon@126.com banseon@126.com http:/hi.baidu.com/banseon/demo/dev/ HELLO WORLD banseon banseon@126.com Project Manager Architect demo http://hi.baidu.com/xxx No -5 Project Manager Architect No Apache 2 http://www.baidu.com/banseon/LICENSE-2.0.txt repo A business-friendly OSS license scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk) scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk http://svn.baidu.com/banseon demo http://www.baidu.com/banseon true/false true/false true/false true/false true/false true/false true/false jdk版本,如:1.7 Windows XP Windows x86 5.1.2600 mavenVersion 2.0.3 /usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/ /usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/ true/false true/false true/false true/false true/false true/false banseon-repository-proxy banseon-repository-proxy http://192.168.1.169:9999/repository/ default org.apache.maven maven-artifact 3.8.1 jar test spring-core org.springframework true true/false true/false banseon-maven2 banseon maven2 file://${basedir}/target/deploy banseon-maven2 Banseon-maven2 Snapshot Repository scp://svn.baidu.com/banseon:/usr/local/maven-snapshot banseon-site business api website scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web value

附件2:POM文件单项配置说明

localRepository

 
 usr/local/maven

interactiveMode

 
 true

usePluginRegistry


 false

offline

 
 false

pluginGroups


 
  
  org.codehaus.mojo
 

proxies


 
  
  
   
   myproxy
   
   true
   
   http
   
   proxy.somewhere.com
   
   8080
   
   proxyuser
   
   somepassword
   
   *.google.com|ibiblio.org
  
 

servers


 
  
  
   
   server001
   
   my_login
   
   my_password
   
   ${usr.home}/.ssh/id_dsa
   
   some_passphrase
   
   664
   
   775
  
 

mirrors


 
  
  
   
   planetmirror.com
   
   PlanetMirror Australia
   
   http://downloads.planetmirror.com/pub/maven2
   
   central
  
 

profiles

 
 
  
  
   
   test

Activation


   
    
    false
    
    1.5
    
    
     
     Windows XP
     
     Windows
     
     x86
     
     5.1.2600
    
    
    
     
     mavenVersion
     
     2.0.3
    
    
    
     
     ${basedir}/file2.properties
     
     ${basedir}/file1.properties
    
   

Repositories

  
   
    
    
     
     codehausSnapshots
     
     Codehaus Snapshots
     
     
      
      false
      
      always
      
      warn
     
     
     
      
     
     
     http://snapshots.maven.codehaus.org/maven2
     
     default
    
   
   
   
    
                     
           
      
     
     
      
     
     
          
        
  
 

activeProfiles


   
    env-test