maven总结(七)--使用插件将maven项目编译成jar包

「爱情、让人受尽委屈。」 2022-10-31 04:23 180阅读 0赞

[来自][Link 1]，插件配置方式可参考如下博客，该博客完整内容如下。

# [Maven自动部署（SCM-SVN/Git）（maven-scm-plugin/maven-release-plugin插件的使用）][Link 1] #

以下内容引用自[https://ayayui.gitbooks.io/tutorialspoint-maven/content/book/maven\_deployment\_automation.html][https_ayayui.gitbooks.io_tutorialspoint-maven_content_book_maven_deployment_automation.html]：

注意：Maven自动构建和自动部署的区别在于，构建只是编译代码阶段，而部署是一整套代码获取到编译再到打包发布的完整流程。

提示：其实本文提到的场景可能有一些矛盾，但只是出于演示效果，主要目的是实现Maven中利用POM进行代码获取、更新、提交、编译再到部署的过程。

**一、场景**

在项目开发中，通常开发阶段包含下面几个步骤：

*  将所有进行的项目的代码提交到**SVN/Git**或者代码库中并打上标签。
 *  从**SVN/Git**下载完整的源代码。
 *  构建应用。
 *  存储构建输出的**WAR**或者**EAR**文件到一个常用的网络位置下。
 *  从网络上获取文件并且部署文件到生产站点上。
 *  及时更新文档并且更新应用的版本号。

**二、问题说明**

通常情况下上面提到开发过程中会涉及到多群人。一个团队可能负责提交代码，另一个团队负责构建等等。很有可能由于涉及的人为操作和多团队环境的原因，任意步骤都可能出错。比如，较早的构建版本没有在网络计算机上被替换，然后部署团队又重新部署了较早的构建版本。

**三、解决方法**

通过下面的方法自动化部署：

*  使用**SubVersion/Git**，源码仓库来管理源代码
 *  使用**Maven**构建和发布项目
 *  使用远程仓库管理软件（Jfrog或者Nexus） 来管理项目二进制文件。

**四、实现步骤**

1、使用**SCM**实现从**SVN**上获取代码

说明：

①这里演示的效果为第一次从SVN获取下来的代码（也就是说本机要安装SVN客户端），然后在pom.xml文件中加入SCM支持，使其能通过Maven的命令去实现代码的提交等操作，即不用SVN客户端的参与了。

②如果想要实现第一次获取代码不用SVN客户端的参与，可以这样操作，先新建pom.xml文件，并配置SCM的节点支持SVN，然后使用SCM的checkout命令去获取一次代码，也就是用Maven去第一次从SVN中checkout代码，然后在pom.xml文件中加入SCM支持，使其能通过Maven的命令去实现代码的提交等操作。（也就是将第①步中用SVN客户端获取代码的步骤省略了，后面都和第①步的一样）

假设第一次已经从SVN获取了代码，然后按如下方式修改项目中的pom.xml文件：

提示：通过<connection>配置SVN的地址，其中地址上包含了账号和密码，然后再添加maven-scm-plugin插件，并配置<connectionType>对应上面的节点，这里配置的devloperConnection是跟<devloperConnection>对应的。<connection>，<developerConnection>都是连接字符串，其后者是具有write权限的SCM连接。

SCM还有很多配置的细节，上面精简的是为了演示基本功能基本够用了，如要更深入的了解，可以参考以下网站：

maven-scm-plugin：[http://maven.apache.org/scm/maven-scm-plugin/index.html][http_maven.apache.org_scm_maven-scm-plugin_index.html]

插件使用：[http://maven.apache.org/scm/maven-scm-plugin/usage.html][http_maven.apache.org_scm_maven-scm-plugin_usage.html]

<scm>节点完整属性配置：[http://maven.apache.org/pom.html\#SCM][http_maven.apache.org_pom.html_SCM]

插件配置源代码管理系统的支持（SVN/Git等）：[http://maven.apache.org/scm/scms-overview.html][http_maven.apache.org_scm_scms-overview.html]

maven-scm-plugin命令行：[http://maven.apache.org/scm/maven-scm-plugin/plugin-info.html][http_maven.apache.org_scm_maven-scm-plugin_plugin-info.html]

配置好之后可以在命令行上运行进行测试，比如提交代码和更新代码的命令如下：

mvn scm:checkin -Dmessage="代码提交日志" #代码提交
    mvn scm:update #代码更新

![b8a41b5cd866370d6d0f0914eef2bf0c.png][]

接下来将使用maven-release-plugin进行版本的发布、回滚等操作，maven-release-plugin的用途是帮助自动化项目版本发布，它依赖于POM中的SCM信息。修改项目的pom.xml文件如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
      <modelVersion>4.0.0</modelVersion>
      <groupId>com.jsoft.test</groupId>
      <artifactId>bus-core-api</artifactId>
      <packaging>jar</packaging>
      <version>1.0-SNAPSHOT</version>
      <name>bus-core-api</name>
      <url>http://maven.apache.org</url>
      <scm>
        <developerConnection>scm:svn:https://jim:1@127.0.0.1:5443/svn/Test/trunk/bus-core-api/</developerConnection>
      </scm>
      <dependencies>
        <dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <version>3.8.1</version>
          <scope>test</scope>
        </dependency>
      </dependencies>
      <build>
        <plugins>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-scm-plugin</artifactId>
            <version>1.9.5</version>
            <configuration>
              <connectionType>developerConnection</connectionType>
            </configuration>
          </plugin>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-release-plugin</artifactId>
            <version>2.5.3</version>
            <configuration>
            　　<username>jim</username>
            　　<password>1</password>
            　　<tagBase>https://127.0.0.1:5443/svn/Test/tags</tagBase>
            　　<releaseProfiles>release</releaseProfiles>
         　　</configuration>
          </plugin>
        </plugins>
      </build>
    </project>

注意：在使用maven-release-plugin时，如果你是一个不标准的SVN目录（没有trunk/tags/branches）的，那么必须配置<tagBase>属性，再配置SCM的用户名密码（即SVN账号密码）。

通过以下命令行测试：

mvn release:clean #发布前的清理
    mvn release:prepare #发布版本
    mvn release:rollback #回滚版本

注意：在运行发布版本时，如果代码修改过没有迁入是不能通过的。当发布好版本之后会在上面定义的tag目录中有一份代码，如下所示：

[![1004f11f6ae96c5d24587dc83cd55f79.png][]][1004f11f6ae96c5d24587dc83cd55f79.png 1]

maven-release-plugin插件还有很多命令，比如创建分支等（当然这一切都可以使用SVN客户端操作，但是人为操作在大型多模块项目来说就显得过于庞大，使用插件的方式能节省很多人为操作的时间等），可以参考以下网站：

maven-release-plugin：[http://maven.apache.org/maven-release/maven-release-plugin/index.html][http_maven.apache.org_maven-release_maven-release-plugin_index.html]

使用方法：[http://maven.apache.org/maven-release/maven-release-plugin/usage.html][http_maven.apache.org_maven-release_maven-release-plugin_usage.html]

命令行参数（同时也是配置节点的说明）：[http://maven.apache.org/maven-release/maven-release-plugin/plugin-info.html][http_maven.apache.org_maven-release_maven-release-plugin_plugin-info.html]

接下来是配置提交到Nexus的私有仓库，修改pom.xml如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
      <modelVersion>4.0.0</modelVersion>
      <groupId>com.jsoft.test</groupId>
      <artifactId>bus-core-api</artifactId>
      <packaging>jar</packaging>
      <version>1.0-SNAPSHOT</version>
      <name>bus-core-api</name>
      <url>http://maven.apache.org</url>
      <distributionManagement>
        <repository>
            <id>oss</id>
            <url>http://127.0.0.1:8081/repository/maven-releases/</url>
        </repository>
        <snapshotRepository>
            <id>oss</id>
            <url>http://127.0.0.1:8081/repository/maven-snapshots/</url>
        </snapshotRepository>
      </distributionManagement>
      <scm>
        <developerConnection>scm:svn:https://jim:1@127.0.0.1:5443/svn/Test/trunk/bus-core-api/</developerConnection>
      </scm>
      <dependencies>
        <dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <version>3.8.1</version>
          <scope>test</scope>
        </dependency>
      </dependencies>
      <build>
        <plugins>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-scm-plugin</artifactId>
            <version>1.9.5</version>
            <configuration>
              <connectionType>developerConnection</connectionType>
            </configuration>
          </plugin>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-release-plugin</artifactId>
            <version>2.5.3</version>
            <configuration>
            　　<username>jim</username>
            　　<password>1</password>
            　　<tagBase>https://127.0.0.1:5443/svn/Test/tags</tagBase>
            　　<releaseProfiles>release</releaseProfiles>
         　　</configuration>
          </plugin>
        </plugins>
      </build>
    </project>

其中上面的id对应%M2\_HOME%\\conf\\settings.xml的<service>节点，配置如下：

<servers>
        ...
        <server>
            <id>oss</id>
            <username>admin</username>
            <password>admin123</password>
        </server>
        ...
    </servers>

运行以下命令进行发布

mvn release:clean release:prepare release:perform

注意：运行命令前一定要把所有代码都迁入，不然会报错。当发布完成后，id会自动更新，并且是存放在Release库中。

测试工程：[https://github.com/easonjim/5\_java\_example/tree/master/maventest/test6/bus-core-api][https_github.com_easonjim_5_java_example_tree_master_maventest_test6_bus-core-api]

[Link 1]: https://www.cnblogs.com/EasonJim/p/6854746.html
[https_ayayui.gitbooks.io_tutorialspoint-maven_content_book_maven_deployment_automation.html]: https://ayayui.gitbooks.io/tutorialspoint-maven/content/book/maven_deployment_automation.html
[http_maven.apache.org_scm_maven-scm-plugin_index.html]: http://maven.apache.org/scm/maven-scm-plugin/index.html
[http_maven.apache.org_scm_maven-scm-plugin_usage.html]: http://maven.apache.org/scm/maven-scm-plugin/usage.html
[http_maven.apache.org_pom.html_SCM]: http://maven.apache.org/pom.html#SCM
[http_maven.apache.org_scm_scms-overview.html]: http://maven.apache.org/scm/scms-overview.html
[http_maven.apache.org_scm_maven-scm-plugin_plugin-info.html]: http://maven.apache.org/scm/maven-scm-plugin/plugin-info.html
[b8a41b5cd866370d6d0f0914eef2bf0c.png]: /images/20221024/76b7b78e692743d6a09417286fbeeab1.png
[1004f11f6ae96c5d24587dc83cd55f79.png]: /images/20221024/40a1ea2e94da423f96132420c110e888.png
[1004f11f6ae96c5d24587dc83cd55f79.png 1]: https://images2015.cnblogs.com/blog/417876/201705/417876-20170515175023010-68115361.png
[http_maven.apache.org_maven-release_maven-release-plugin_index.html]: http://maven.apache.org/maven-release/maven-release-plugin/index.html
[http_maven.apache.org_maven-release_maven-release-plugin_usage.html]: http://maven.apache.org/maven-release/maven-release-plugin/usage.html
[http_maven.apache.org_maven-release_maven-release-plugin_plugin-info.html]: http://maven.apache.org/maven-release/maven-release-plugin/plugin-info.html
[https_github.com_easonjim_5_java_example_tree_master_maventest_test6_bus-core-api]: https://github.com/easonjim/5_java_example/tree/master/maventest/test6/bus-core-api