maven使用心得

maven

配置文件默认在 ~/.m2/settings.xml

maven命令行

mvn clean install -Dmaven.test.skip=true -s ~/.m2/settings.xml

往本地仓库加jar包

命令形如：

mvn install:install-file -DgroupId=com.lee.net -DartifactId=MyToolIdl -Dversion=1.0.0-SNAPSHOT -Dpackaging=jar -Dfile=E:/view/net/FunctionCenter/3rdlib/MyToolIdl.jar

往远端maven仓加jar包

jar包不多的话，可用nexus的界面来添加，参考：

https://www.cnblogs.com/xyfer1018/archive/2018/12/29/10193467.html

设置maven代理

在maven的settings.xml里加入这么一段：

<settings ...> 
<proxies> <proxy><id>myproxy</id><active>true</active><protocol>http</protocol><username>user</username><password>pass</password><host>proxy.xxx.com</host><port>8080</port><nonProxyHosts>xxx,xxx2</nonProxyHosts></proxy>
</proxies>
......
</settings>

注意：nonProxyHosts里如有多个host，用|隔开。

snapshot版本与release版本

快照版本：即使本地仓库有缓存，也会去服务器拿。适用于开发中的版本。
正式版本：本地仓库有缓存，则不会去服务器拿。适用于比较稳定的版本。

预定义变量

project.version：当前pom的版本号，如为快照版本，会包含-SNAPSHOT后缀。

查看某个工程的依赖树

mvn dependency:tree

查看底层jar包是如何引入的

使用mvn dependency:tree即可找出引入底层jar包的最顶层依赖。可使用exclusions排除之，例如：

<dependency><groupId>com.lee.omc</groupId><artifactId>com.lee.omc.common</artifactId><version>1.0.0.100-SNAPSHOT</version><exclusions><exclusion><groupId>org.slf4j</groupId><artifactId>slf4j-log4j12</artifactId></exclusion></exclusions></dependency>

execution说明

一个execution的例子：

<execution><id>copy_war</id><phase>package</phase><configuration><tasks><copy file="${project.build.directory}/${project.artifactId}-${project.version}.war"tofile="${project.build.directory}/${project.artifactId}-1.2.2.jar" /></tasks></configuration><goals><goal>run</goal></goals></execution>

phase就是maven的liftcycle，指定合适的阶段非常重要。

id取一个有意义的名字即可，goal相当于插件提供的api，输出的格式为：

${插件名}:${goal} (${id})

比如上述配置的输出为：

maven-antrun-plugin:1.3:run (copy_war)

排除依赖

给一个例子就清楚了：

    <dependency><groupId>org.onap.ccsdk.sli.core</groupId><artifactId>sli-common</artifactId><version>${project.version}</version><scope>compile</scope><exclusions>  <exclusion>  <groupId>org.onap.ccsdk.sli.core</groupId> <artifactId>dblib-provider</artifactId></exclusion>  </exclusions></dependency>

dependencyManagement与dependencies的区别

dependencies即使在子项目中不写该依赖项，那么子项目仍然会从父项目中继承该依赖项（全部继承）

dependencyManagement里只是声明依赖，并不实现引入，因此子项目需要显示的声明需要用的依赖。如果不在子项目中声明依赖，是不会从父项目中继承下来的；只有在子项目中写了该依赖项，才会从父项目中继承该项，且version和scope都读取自父pom；另外如果子项目中指定了版本号，那么会使用dependencyManagement里的版本覆盖子项目自己的版本。

jar无法下载的问题

原因一：服务端仓库确实没有这个jar包

原因二：有多个服务端仓库，但maven访问的第一个仓库只有部分jar信息（例如只有pom文件），这样会导致组件只下了一半，但maven认为本地组件已经就绪，随后访问的仓库即使有完整组件，也无济于事了。

信任证书问题

有时会遇到这样的错误：

[ERROR] Non-resolvable parent POM for org.onap.appc:appc:1.3.0-SNAPSHOT: Could not transfer artifact org.onap.ccsdk.parent:odlparent:pom:1.0.3 from/to openecomp-release (https://nexus.onap.org/content/repositories/releases/): sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target and ‘parent.relativePath’ points at wrong local POM @ line 25, column 13 -> [Help 2]

我们在浏览器上访问https://nexus.onap.org/content/repositories/releases/网址，是可以看到odlparent1.0.3的pom的，但在服务器上编译时却报证书错误。

原因如下：从maven仓库下东西时，需要仓库的身份证书以确保我是从合法的数据源下载，因此本地会用信任证书对身份证书做校验，以确认身份证书的合法性。浏览器是有这个信任证书的，我们的编译服务器却没有，所以报错：
unable to find valid certification path

我们可以从浏览器上把信任证书导出来，上传到服务器，再把该信任证书加到java的信任证书仓库里去。使用命令:
cd /usr/lib/jvm/java-8-openjdk-amd64/jre/lib/security &&
keytool -import -file /export/home/root/work/onap/my.cer -keystore cacerts -alias onap_server

上述是linux系统，windows系统java的信任证书仓库路径为：
C:\Program Files\Java\jdk1.8.0_72\jre\lib\security
注意，是在jdk的jre目录下！
进入该目录，执行命令：
keytool -import -file E:\Work\ONAP\02src\my.cer -keystore cacerts -alias onap_server

我们看一下证书是否加上：
keytool -list -keystore cacerts | grep onap_server
要求输入密码，输入默认密码即可。
能查看到onap_server，说明信任证书加成功了。

【注意】信任证书的添加一定要到/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/security目录下进行，否则生成的cacerts文件会放在当前目录。

显示有效pom

mvn help:effective-pom

scope

compile
默认就是compile，什么都不配置也就是意味着compile。compile表示被依赖项目需要参与当前项目的编译，后续的测试，运行周期也参与其中，是一个比较强的依赖。打包的时候通常需要包含进去。

test
scope为test表示依赖项目仅仅参与测试相关的工作，包括测试代码的编译，执行。比较典型的如junit。

runntime
runntime表示被依赖项目无需参与项目的编译，不过后期的测试和运行周期需要其参与。与compile相比，跳过编译而已，说实话和compile区别不是很大。比较常见的如JSR×××的实现，对应的API jar是compile的，具体实现是runtime的，compile只需要知道接口就足够了。oracle jdbc驱动架包就是一个很好的例子，一般scope为runntime。另外runntime的依赖通常和optional搭配使用，optional为true。我可以用A实现，也可以用B实现。

provided
provided意味着打包的时候可以不用包进去，别的设施(Web Container)会提供。事实上该依赖理论上可以参与编译，测试，运行等周期。相当于compile，但是在打包阶段做了exclude的动作。

system
从参与度来说，也provided相同，不过被依赖项不会从maven仓库抓，而是从本地文件系统拿，一定需要配合systemPath属性使用。

总结：

compile：编译、测试、运行test：测试runtime：测试、运行provided：编译、测试system：编译、测试，不依赖maven

build resources

参考：

https://blog.csdn.net/fz13768884254/article/details/85088616

按profile打包

使用-P选项：

mvn clean install -Dmaven.test.skip=true -s D:/work/apache-maven-3.6.0/conf/settings_all.xml -P sit

按profile打包时，如下配置：

<profile><id>sit</id><activation><activeByDefault>true</activeByDefault></activation><build><resources><resource><directory>${project.basedir}/src/main/resources/needed_dir</directory></resource><resource><directory>${project.basedir}/src/main/resources</directory><excludes><exclude>no_need1/*</exclude><exclude>no_need2/*</exclude></excludes></resource></resources></build>

会将src/main/resources/needed_dir下的内容都拷贝到src/main/resources下，而排除掉no_need1和no_need2俩文件夹。