maven 项目骨架生成工具

 mvn archetype:generate

基本约定

源码 src/main/java
资源 src/main/resources
测试源码 src/test/java
测试资源 src/test/resources
编译输出 target/classes
打包 jar
打吧输出 target/
webapp资源 webapp/.html webapp/.jsp webapp/img/ webapp/css/ webapp/js/
webapp配置 webapp/WEB-INF/web.xml

mvn 构件坐标

通过坐标确定唯一的构件

groupId 实际项目, 如SpringFramework
artificatId 实际项目下的maven项目（模块），一般以实际项目作前缀，如spring-core
version
packaging 默认为jar
classifier

依赖管理

<dependencies>
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-classic</artifactId>
        <version>1.2.3</version>
        <scope>compile</scope>
    </dependency>
</dependencies>

声明依赖的构件的基本坐标

groupId
artificateId
version
其他属性
scope 作用在classpath的范围
optional 构件A 的optional 依赖，不传递给依赖构件A的其他构件
exclusion 构件A 依赖了构件B，但是排除构件B的某些依赖

传递律

依赖遵循传递律。若存在对同一构件不同版本的依赖则

依赖路径最短的优先
最先被读取的依赖优先。

scope

决定依赖是否被添加到对应的编译/测试/运行时的classpath 中。

scope	编译	测试	运行
compile	y	y	y
test		y
provided	y	y
runtime		y	y
system	y	y

provided 适用于运行时的库会存在在环境中，比如servlet-api
runtime 适用于编译时只需要interface, 实际运行时才会引入具体实现
system 适用于引用本机系统相关的依赖，依赖不由maven 管理，需要在systemPath 中声明

变量

内置变量 ${basedir} ${version}
POM属性 ${project.groupId} (通过 . 来访问pom元素)
自定义属性：<properties> 中的属性， ${ 属性名 }
Settings属性：settings 里的属性，通过 ${ settings.??? } 访问
Java 属性：所有Java 属性都可以直接访问, 如 ${ user.home }
环境变量: 通过 ${ env.??? } 访问

生命周期

将生命周期的phase 作为参数传递给mvn 执行

mvn clean install

会顺序执行该phase前所有的phase，如mvn clean 会执行pre-clean, clean两个phase

列举三个生命周期中常见的phase

clean 清理

pre-clean
clean
post-clean

default 构建

validate
process-sources 复制src/main/resources 到classpath
compile 编译src/main/java 到classpath
process-test-sources 复制测试资源 src/test/resources 到classpath
test-compile 编译测试代码 ssrc/test/java 到classpath
test 运行单元测试
package
integration-test
verify
install 安装到本地仓库
deploy 发布到远程仓库

site 建立站点

site 生成站点文件
site-deploy 发布到服务器上

插件

获取插件信息

mvn help:describe -Dplugin=org.apache.maven.plugins:maven-clean-plugin:3.0.0 -Ddetail

插件定义了可执行的goal，可以通过

mvn {插件前缀}:{goal}
// 如 mvn clean:clean

插件:goal 直接执行
或者将插件绑定在phase 上，在执行phase 的时候执行

<build>
    <plugins>
        <plugin>
            <artifactId>maven-sources-plugin</artifactId>
            <version>3.0.2</version>
            <executions>
                <execution>
                    <id>attach-sources</id>
                    <phase>verify</phase>
                    <goals>
                        <goal>jar-no-fork</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

POM 聚合

将多个模块放到同一aggreator pom中，一次构建就可以构建所有模块

<groupId>com.lxian.playground</groupId>
<artifactId>playground-mvn-aggreator</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>pom</packaging>
<modules>
    <module>playground-java</module>
    <module>playground-scala</module>
</modules>

packaging 必须为 pom
model 的值是该模块相对 aggreator pom的相对路径，比如上面配置的aggreator 应在 playground/pom.xml，而playground-java 模块在 playgournd/playground-java/pom.xml

POM 继承

常用的可以继承的元素

groupId
version
各种作者/组织等描述
distributionManagement
properties
dependencies
dependencyManagement 只约束依赖的属性(version, scope)，子POM可以按需要引入依赖
pluginManagement 同上
repositories
build
由于不会继承modules 所以所以父pom和aggreator pom 可以为同一个🌚

父pom packaging 需为pom

<groupId>com.lxian.playground</groupId>
<artifactId>playground-mvn-parent</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>pom</packaging>

子pom 可以指定父pom 的相对路径，默认为 ../pom.xml。如果相对路径上没找到父pom，则会在本地仓库搜索。

<parent>
    <groupId>com.lxian.playground</groupId>
    <artifactId>playground-java</artifactId>
    <version>1.0-SNAPSHOT</version>
    <relativePath>../pom.xml</relativePath>
</parent>

仓库配置

坐标与路径

groupId/artifactId/version/artifactId-version.packaging

本地/远程仓库

本地仓库位置

~/.m2/repository

查找顺序

system 依赖，从本地查找
从本地仓库查找
从远程仓库查找
如果是RELEASE 依赖，则读取远程 groupId/artifactId/version/maven-metadata.xml 确定最新发布版
如果是LATEST, 同上，查找包括snapshot 的最新版
SNAPSHOT 则查找最新的 SNAPSHOT

构件会被先下载到本地再使用

配置

<repositories>
    <repository>
        <id>central</id>
        <name>Maven Central</name>
        <url>http://repo1.maven.org/maven2/</url>
        <releases>
            <enabled>true</enabled>
            <updatePolicy>daily</updatePolicy>
            <checksumPolicy>ignore</checksumPolicy>
        </releases>
        <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
        </snapshots>
    </repository>
</repositories>

updatePolicy 从远程仓库更新的频率 never/always/daily/interval。always会每次都检查更新

认证

配置在settings.xml (密码和代码分离)

<servers>
  <server>
    <id>my-repo</id>
    <username></username>
    <password></password>
  <server>
</servers>

id 需要和pom repositories 里面的id 对应

部署配置

<distributionManagement>
    <repository>
        <id>my-release-repo</id>
        <name>My Release Repo</name>
        <url></url>
    </repository>
    <snapshotRepository>
        ...
    </snapshotRepository>
</distributionManagement>

Snapshot

Snapshot 的发布，会在版本后带上发布时的时间戳
Snapshot 的依赖会拉去最新的Snapshot 构件

Maven总结