mavan开发要点总结（一）

本文基于企业内部开发时使用到的maven知识点总结，便于开发时查阅使用，非权威文档，仅供参考。

一、初识pom.xml

每个pom文件开头一般都有如下一段配置

    
    4.0.0
    com.pxjy.puxin.preferential
    puxin-preferential
    0.0.1-SNAPSHOT
    war
    demo

project pom文件顶层元素
modelVersion pom本身版本号一般很少变
groupId 项目的公司或组织一般为公司域名倒序
artifactId 一般指项目的唯一标志
version 项目版本号
packaging 打包方式，一般为jar或war
name 项目名称，一般生成项目的描述文档时需要
url 项目文档下载的站点url
description 项目描述

二、maven依赖管理基础

再上一段配置


 
 org.springframework.boot
 spring-boot-starter-web
 
 
 org.mybatis.spring.boot
 mybatis-spring-boot-starter
 2.1.1
 
 
 org.springframework.boot
 spring-boot-starter-activemq
 
 
 mysql
 mysql-connector-java
 runtime
 
 
 org.projectlombok
 lombok
 true
 
 
 
 com.alibaba
 fastjson
 1.2.62

1、理解maven的坐标

groupId + artifactId + version + packaging + classifier，五个维度的坐标，唯一定位一个依赖包，

实际中后面两个维度使用较少，99%的场景下groupId + artifactId + version

在pom文件的dependency标签中配置了groupId,artifactId,version后maven会自动从中央仓库或镜像仓库下载坐标对应的jar包到本地缓存中

企业级坐标设置
- groupId 一般设置为公司或组织的域名倒序 如www.baidu.com就是com.baidu开头
- artfactId 某个项目、服务、模块，依据项目大小而定
- version 版本号
- classifier 某个项目的附属项目 如hello-world.jar的hello-world-source.jar
- packaging jar包或war包
坐标设置的意义
- 便于依赖方定位并下载已发布的jar包

2、dependency属性详解

前三项上面已做说明
type 一般不使用
scope 依赖包在不同的classpath下的作用范围，有如下几种配置
- compile
  
  不配置时默认的作用范围，对test、provided、runtime三个classpath都有效
- test
  
  仅对运行测试代码的classpath有用，单元测试依赖的包使用，如junit
- provided
  
  对编译和测试的classpath有效，线上运行时不需要，如servlet-api，在线上运行时一般web容器会自带，所以不需要
- runtime
  
  对测试和运行的classpath有效，编译的时候不需要，如jdbc驱动包，测试和运行的时候需要访问，但编译的时候是基于javax.sql包下的标准接口编译
- optional
  
  true 依赖不向上传递，默认是传递不用设置，详见下边说明

依赖传递和依赖调解

maven依赖的传递性

自动递归解析并下载每个包及其依赖包的依赖，不管依赖有多少层级

依赖范围对于依赖传递的影响

下面的表格详细列出了影响，第一列是一级依赖，第一行是二级依赖，依赖范围对依赖传递产生影响

	compile	provided	runtime
compile	compile		runtime
test	test		test
provided	provided	provided	provided
runtime	runtime		runtime

依赖调解
- 产生原因
  
  由于循环依赖，自动下载依赖包，可能导致下载到同一个包的不同版本，可能会产生冲突
- maven解决依赖冲突的机制——依赖调解
  - 短路径优先原则
    
    如：A-B-C-X1.0和A-D-X2.0，此时判断A-D-X2.0路径段，使用X2.0
  - 申明优先选择
    
    如：A-B-X1.0,A-D-X2.0，此时从pom中标签判断谁配置靠前使用谁的依赖
可选依赖（补充）

补充说明dependency标签的optional属性，一般不用设置，如果特殊情况下需要阻止依赖传递，则可手动设置为true，这个也使用的比较少
依赖冲突解决
- 产生原因
  
  由于依赖传递+依赖调解导致有时候可能会依赖到不正确的版本（一般是低版本的包）
- 解决办法
  - 使用mvn depedency:tree命令查看项目依赖树，也可以使用IDE工具查看版本依赖
  - 找到包问题的包依赖的jar版本，查找正常情况下应该依赖的版本
  - 手动排除掉当前依赖的低版本包，此时会自动依赖高版本包
    
    注意需要在依赖低版本的jar包里排除掉
    
    如：A-D1.0、B-C-D2.0此时需要在A包里排除，具体的排除语法如下
```
A
A
1.0

      
          D
          D
      
```

三、理解maven的各级仓库及配置

maven1.PNG

1、本地仓库

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    
    C:\Users\renpb\.m2\repository

在maven自己的settings.xml文件中指定，windows系统中一般配置在用户目录.m2\repository

2、内网私服

公司内部使用nexus搭建的一套服务，便于集中下载和管理jar包以及将自己开发的共用jar发布到私服供其他团队使用，管理内网私服下面单独做更详细的讲解

3、中央仓库

maven的jar包里自带一个超级pom，里面默认配置了一个中央仓库，如果不做任何设置，拉取依赖包时就会从该超级pom配置的中央仓库去下载


    
        central
        Maven Repository Switchboard
        http://repo1.maven.org/maven2
        default
        
            false

4、其他仓库

某些厂商的jar并没有在maven中央仓库提供，此时需要从厂商自己提供的地址去下载，需要注意

5、镜像仓库

由于maven中央仓库服务器在国外，有时候下载依赖会非常慢，国内部分大厂提供镜像仓库，里边存放与中央仓库一模一样的资源，代理中央仓库，满足国内用户快速下载需求，一般都使用阿里云镜像仓库

一般配置在settings.xml里，配置如下，注意如果有内网私服可能会将镜像仓库直接配置在私服里，本地统一走私服即可


    
        nexus-aliyun
        *
        Nexus aliyun
        http://maven.aliyun.com/nexus/content/groups/public