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的某些依赖

传递律

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

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

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

查找顺序

1. system 依赖，从本地查找
2. 从本地仓库查找
3. 从远程仓库查找
4. 如果是RELEASE 依赖，则读取远程 groupId/artifactId/version/maven-metadata.xml 确定最新发布版
5. 如果是LATEST, 同上，查找包括snapshot 的最新版
6. 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 构件