maven
配置文件默认在 ~/.m2/settings.xml,也可用-s选项重新指定
maven命令行
mvn clean install -Dmaven.test.skip=true -s ~/.m2/settings.xml -Dmaven.repo.local=D:\maven_repo
这里使用-s选项重新指定了settings文件,使用-Dmaven.repo.local用特定目录覆盖了setting文件里的本地maven仓。
单元测试
mvn test -DfailIfNoTests=false -Dtest=com.lee.MyServiceTest -U -gs ./settings.xml
-Dtest可以指定具体的test类。
往本地仓库加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 -s ~/.m2/settings.xml -Dmaven.repo.local=D:\maven_repo
如果远程仓没有某个包,要解决编译依赖的问题,要么使用scope=system,像这样:
<scope>system</scope>
<systemPath>${pom.basedir}/libs/antlr4-runtime-4.9.1.jar</systemPath>
要么就用install-file命令把包加到本地maven仓里。
使用scope=system会有一些后遗症,比如在使用maven-assembly-plugin打包的时候,scope=system的包是不会打进去的。所以我们更推荐用install-file命令的方式来添加远程仓没有的jar包。
往远端maven仓加jar包
jar包不多的话,可用nexus的界面来添加,参考:
https://www.cnblogs.com/xyfer1018/archive/2018/12/29/10193467.html
mirror设置
settings文件里的mirror代表镜像,亦即将对B仓的访问都转给A
<mirror>
<id>唯一ID</id>
<name>XXX</name>
<url>A仓url</url>
<mirrorOf>B仓id</mirrorOf>
</mirror>
mirrorOf也可以是:
*,代表任意仓请求都转给A。
!central,代表除了central以外的仓请求都转给A。!表示否定的含义。
设置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>
也可用dependency analyzer工具,更直观。
execution说明
execution配置在plugin里,一个execution的例子:
<executions>
<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>
...
</executions>
phase就是maven的liftcycle,指定合适的阶段非常重要。阶段可到IDEA的maven界面的lifecycle里查看。不过那里展示的阶段并不全,还有一些默认阶段是不展示的,比如process-test-resources和process-resources这两个资源打包阶段。
id取一个有意义的名字即可,goal相当于插件提供的api,输出的格式为:
${插件名}:${版本}:${goal} (${id})
比如上述配置的输出为:
maven-antrun-plugin:1.3:run (copy_war)
举个具体例子,如果我们想在两个资源打包阶段执行不同的打包策略,可用如下配置:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<version>3.0.0</version>
<executions>
<execution>
<id>default-resources</id>
<phase>process-resources</phase>
<goals>
<goal>resources</goal>
</goals>
<configuration>
<nonFilteredFileExtensions>
<nonFilteredFileExtension>
xlsx
</nonFilteredFileExtension>
<nonFilteredFileExtension>
xls
</nonFilteredFileExtension>
</nonFilteredFileExtensions>
<resources>
<resource>
<directory>src/main/resources</directory>
<excludes>
<exclude>**/*.sql</exclude>
</excludes>
</resource>
</resources>
</configuration>
</execution>
<execution>
<id>default-testResources</id>
<phase>process-test-resources</phase>
<goals>
<goal>testResources</goal>
</goals>
</execution>
</executions>
</plugin>
正式资源打包要排除sql文件,但测试打包则不做任何处理。
排除依赖
给一个例子就清楚了:
<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 importer使用的java版本不对,可在IntelliJ的Build Tools ---- Maven ---- Importing里修改。
原因三:有多个服务端仓库,但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俩文件夹。