maven使用心得

天下无敌笨笨熊

已于 2024-03-01 15:40:50 修改

阅读量805

点赞数

分类专栏： java 工具文章标签： maven java

于 2023-03-04 16:24:52 首次发布

本文链接：https://blog.csdn.net/tlxamulet/article/details/129335618

版权

java 同时被 2 个专栏收录

11 篇文章 0 订阅

订阅专栏

工具

4 篇文章 0 订阅

订阅专栏

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

设置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访问的第一个仓库只有部分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>