标签 maven 下的文章

在项目开发时，我们用的是本地搭建的开发dev环境，开发完成打包部署到服务器时，用到的是服务器prod环境。可以借用Maven的profiles、filters和resources，在运行或打包时指定选用的环境，实现不同环境自动使用各自环境的配置文件或配置信息。

  • profiles：定义环境变量的id；
  • filters:定义了变量配置文件的地址，其中地址中的环境变量就是上面profile中定义的值；
  • resources：定义哪些目录下的文件会被配置文件中定义的变量替换，另外可以指定目录下的文件打包到classes目录下。

定义环境变量profiles

一般环境变量分：dev开发环境、prod发布环境，当然也可以类比添加其他的环境标志。
此处详细可参看：maven profile动态选择配置文件、maven profile切换正式环境和测试环境

    <profiles>
        <!-- 开发测试环境 -->
        <profile>
            <id>dev</id>
            <activation>
                <!-- 设置默认激活dev环境的配置 -->
                <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
                <profile.env>dev</profile.env>
            </properties>
        </profile>
        <!-- 产品发布环境 -->
        <profile>
            <id>prod</id>
            <properties>
                <profile.env>prod</profile.env>
            </properties>
        </profile>
    </profiles>

- 阅读剩余部分 -

Maven运行参数

运行VM参数

-Xms128m -Xmx256m -Xmn32m -XX:PermSize=32M -XX:MaxPermSize=256m
  • Xms和Xmx:程序运行进程堆内存能占用的最小大小和最大大小；
  • Xmn:用来设置堆内新生代的大小。通过这个值我们也可以得到老生代的大小：-Xmx减去-Xmn;
  • Xss:设置每个线程可使用的内存大小
  • XX:PermSize和XX:MaxPermSize：设置永久代的最小大小和最大大小。注意：Java 8移除该参数，而是用本地元空间Metaspace，大小由-XX:MetaspaceSize和-XX:MaxMetaspaceSize进行设置。

常规参数

  • -o：是否离线
  • -U：是否更新Snapshots
  • -X -e：Debug Output
  • -DskipTests=true：编译test，但是忽略允许test(compiles the tests, but skips running them)
  • -Dmaven.test.skip=true：是否忽略test（skips compiling the tests and does not run them）
命令参数命令全称备注
mvn -am--also-make表示同时处理选定模块所依赖的模块
mvn -amd--also-make-dependents表示同时处理依赖选定模块的模块
mvn -B--batch-mode在非交互（批处理）模式下运行(该模式下,当Mven需要输入时,它不会停下来接受用户的输入,而是使用合理的默认值)
mvn -b--builder 设置build构建时的参数
mvn -C--strict-checksums如果校验码不匹配的话,构建失败
mvn -c--lax-checksums如果校验码不匹配的话,产生告警
mvn -cpu--check-plugin-updates对任何相关的注册插件,强制进行最新检查（无效，只保留向后兼容）
mvn -D--define 定义系统属性
mvn -e--errors控制Maven的日志级别,产生执行错误相关消息
mvn -emp--encrypt-master-password 加密主安全密码,存储到Maven settings文件里
mvn -ep--encrypt-password 加密服务器密码,存储到Maven settings文件里
mvn -f--file 强制使用备用的POM文件（或者目录下的pom.xml）
mvn -fae--fail-at-end仅影响构建结果,允许不受影响的构建继续
mvn -ff--fail-fast遇到构建失败就直接退出
mvn -fn--fail-never无论项目结果如何,构建从不失败
mvn -gs--global-settings 全局配置文件的备用路径
mvn -gt--global-toolchains 全局构建链文件的备用路径
mvn -h--help显示帮助信息
mvn -l--log-file 设置构建输出的日志文件（禁用输出颜色）
mvn -llr--legacy-local-repository使用Maven 2遗留的本地存储库行为，即不使用_remote. Repository。也可以使用-Dmaven.legacyLocalRepo=true来激活
mvn -N--non-recursive不递归到子项目中
mvn -npr--no-plugin-registry无效，只保留向后兼容
mvn -npu--no-plugin-updates无效，只保留向后兼容
mvn -o--offline离线模式
mvn -P--activate-profiles 激活的profile，如果多个以逗号分隔
mvn -pl--projects 选项后可跟随{groupId}:{artifactId}或者所选模块的相对路径(多个模块以逗号分隔)
mvn -q--quiet静默输出，仅显示错误信息
mvn -rf--resume-from 表示从指定模块开始继续处理
mvn -s--settings 用户设置文件的替代路径
mvn -t--toolchains 用户构建链文件的备用路径
mvn -T--threads 构建的线程数
mvn -U--update-snapshots强制更新snapshot类型的插件或依赖库(否则maven一天只会更新一次snapshot依赖)
mvn -up--update-plugins无效，只保留向后兼容
mvn -v--version显示版本信息
mvn -V--show-version显示版本信息后继续执行Maven其他目标
mvn -X--debug控制Maven的日志级别,产生执行调试信息

打包成可执行jar

方法一：maven-jar-plugin和maven-dependency-plugin插件

<groupId>your-groupid</groupId>
<artifactId>your-artifactid</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>

<build>
    <plugins>
        <plugin>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>${maven.compiler.source}</source>
                <target>${maven.compiler.target}</target>
                <compilerVersion>${maven.compiler.compilerVersion}</compilerVersion>
                <encoding>${project.build.sourceEncoding}</encoding>
            </configuration>
        </plugin>
        <plugin>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <archive>
                    <manifest>
                        <addClasspath>true</addClasspath>
                        <classpathPrefix>libs/</classpathPrefix>
                        <mainClass>your.MainClass</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
        <plugin>
            <artifactId>maven-dependency-plugin</artifactId>
            <version>3.2.0</version>
            <executions>
                <execution>
                    <id>copy-dependencies</id>
                    <phase>prepare-package</phase>
                    <goals>
                        <goal>copy-dependencies</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${project.build.directory}/libs</outputDirectory>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

maven-jar-plugin插件

配置mainClass和指定classpath

addClasspath: 是否在manifest文件中添加classpath。默认为false。如果为true，则会在manifest文件中添加classpath，这样在启动的时候就不用再手动指定classpath了。如下所示，文件中增加了Class-Path一行

maven-dependency-plugin插件

将所依赖的jar包复制到指定目录。

# 打包
mvn package

# 启动
java -jar your-target.jar

方法二：maven-assembly-plugin插件

<groupId>your-groupid</groupId>
<artifactId>your-artifactid</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>

<build>
    <plugins>
        <plugin>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>${maven.compiler.source}</source>
                <target>${maven.compiler.target}</target>
                <compilerVersion>${maven.compiler.compilerVersion}</compilerVersion>
                <encoding>${project.build.sourceEncoding}</encoding>
            </configuration>
        </plugin>
        <plugin>
            <artifactId>maven-assembly-plugin</artifactId>
            <version>3.3.0</version>
            <configuration>
                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>
                <archive>
                    <manifest>
                        <mainClass>your.MainClass</mainClass>
                    </manifest>
                </archive>
            </configuration>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

maven-assembly-plugin插件

将所有的东西都打包到一个jar包中。

mvn package打包完成后，会在target文件夹下生成两个jar包，一个是不带依赖的jar包，一个是后缀有-dependencies带有依赖的jar包
# 打包
mvn package

# 启动
java -jar your-target-dependencies.jar

常用插件

Jetty

  • 指定端口： -Djetty.port=xxx（更改xxx设置为自定义端口，比如：8081）

Maven的仓库和索引

  1. 中央仓库：Maven的中央仓库http://repo1.maven.org/maven2/，该地址是内置与Maven源码中。其他的仓库，都是镜像。
  2. 索引：中央仓库带有索引文件以方便用户对其进行搜索，索引每周更新一次。
  3. 本地仓库：是建立在本地机器上的Maven仓库，本地仓库是中央仓库（或者说远程仓库）的一个缓冲和子集，当你构建Maven项目的时候，首先会从本地仓库查找资源，如果没有，那么Maven会从远程仓库下载到你本地仓库。这样在你下次使用的时候就不需要从远程下载了。如果你所需要的Jar包版本在本地仓库没有，而且也不存在于远程仓库，Maven在构建的时候会报错，这种情况可能发生在有些Jar包的新版本没有在Maven仓库中及时更新。Maven缺省的本地仓库地址为${user.home}/.m2/repository。也就是说，一个用户会对应的拥有一个本地仓库。当然你可以通过修改${user.home}/.m2/settings.xml配置这个地址，也可以通过修改的Maven目录下${MAVEN_HOME}/conf/settings.xml配置本机全局本地仓库地址。
<settings>
    <localRepository>D:/work/resources/repository</localRepository>
</settings>

- 阅读剩余部分 -