1.pom.xml文件 - pom.xml说明

布满荆棘的人生 2022-10-05 05:42 172阅读 0赞

史上最全的 pom.xml 文件详解：[https://blog.csdn.net/jk418756/article/details/87917776][https_blog.csdn.net_jk418756_article_details_87917776]

参考：[https://blog.csdn.net/tomato\_\_/article/details/13625497][https_blog.csdn.net_tomato_article_details_13625497]

## **说明：** ##

1.  maven – 为什么pom.xml的modelVersion是必要的,并且始终设置为4.0.0？  
    <modelVersion>4.0.0</modelVersion>  
    它总是设置为4.0.0在Maven 2和3，因为，目前，没有其他模型。  
    Notice that modelVersion contains 4.0.0 . That is currently the only supported POM version for Maven 2 and is always required  
    但如果有另一个版本的模型，它不一定需要总是设置为4.0.0。 POM必须遵守一个模型。让我们说Maven 4提出了4.1版本。如果你写你的pom符合4.1，它不会与Maven 3和模型4.0.0兼容。  
    它被定义为强制性的，可能强制实施特定的XML模型，以便在定义新模型的情况下。
2.  指定打包后的名字
    
            <build>
                
                <finalName>iiot-ident-provider</finalName>
            </build>
    
      
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lpZ3VhbmdfODIw_size_16_color_FFFFFF_t_70][]

## **plugins 插件：** ##

### 1.maven-compiler-plugin 插件 ###

maven是个项目管理工具，如果我们不告诉它我们的代码要使用什么样的jdk版本编译的话，它就会用maven-compiler-plugin默认的jdk版本来进行处理，这样就容易出现版本不匹配，以至于可能导致编译不通过的问题。  
maven的默认编译使用的jdk版本貌似很低，使用maven-compiler-plugin插件可以指定项目源码的jdk版本，编译后的jdk版本，以及编码。  
详解：[https://www.cnblogs.com/east7/p/13363069.html?utm\_source=tuicool][https_www.cnblogs.com_east7_p_13363069.html_utm_source_tuicool]

<plugin>                                                                                                                                      
                                                                                   
        <groupId>org.apache.maven.plugins</groupId>                                                                                               
        <artifactId>maven-compiler-plugin</artifactId>                                                                                            
        <version>3.1</version>                                                                                                                    
        <configuration>                                                                                                                           
                                
            <source>1.8</source>                                                                                              
            <target>1.8</target>                                                                                      
            <encoding>UTF-8</encoding>
            <skipTests>true</skipTests>                                                                             
            <verbose>true</verbose>
            <showWarnings>true</showWarnings>                                                                                                               
            <fork>true</fork>                                                        
            <executable></executable>           
            <compilerVersion>1.3</compilerVersion>                                                                         
            <meminitial>128m</meminitial>                                                                                      
            <maxmem>512m</maxmem>                                                                                              
            <compilerArgument>-verbose -bootclasspath ${java.home}\lib\rt.jar</compilerArgument>               
        </configuration>                                                                                                                          
    </plugin>

一般如此就行：

<plugin>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <configuration>
                        <source>1.8</source>
                        <target>1.8</target>
                        <encoding>UTF-8</encoding>
                    </configuration>
                </plugin>

### 2.Maven插件系列之spring-boot-maven-plugin ###

Spring Boot的Maven插件（Spring Boot Maven plugin）能够以Maven的方式为应用提供Spring Boot的支持，即为Spring Boot应用提供了执行Maven操作的可能。  
Spring Boot Maven plugin能够将Spring Boot应用打包为可执行的jar或war文件，然后以通常的方式运行Spring Boot应用。  
Spring Boot Maven plugin的最新版本为2017.6.8发布的1.5.4.RELEASE，要求Java 8, Maven 3.2及以后。

<build>
          <plugins>
              <plugin>
                  <groupId>org.springframework.boot</groupId>
                  <artifactId>spring-boot-maven-plugin</artifactId>
                  <version>2.0.1.RELEASE</version>
                  
                  <executions>
                      <execution>
                          <goals>
                              <goal>repackage</goal>
                          </goals>
                      </execution>
                  </executions>
              </plugin>
          </plugins>
      </build>

**注意：可以指定启动类：**[https://www.cnblogs.com/acm-bingzi/p/mavenSpringBootPlugin.html][https_www.cnblogs.com_acm-bingzi_p_mavenSpringBootPlugin.html]

**1.作用：**springboot默认使用**spring-boot-maven-plugin** 来打包，这个插件会将项目所有的依赖打入项目**jar** 包里面。  
spring-boot-maven-plugin插件的作用：  
![20210607100852486.png][]

**2.Spring Boot Maven plugin的5个Goals**

1.  spring-boot:repackage，默认goal。在mvn package之后，再次打包可执行的jar/war，同时保留mvn package生成的jar/war为.origin
2.  spring-boot:run，运行Spring Boot应用
3.  spring-boot:start，在mvn integration-test阶段，进行Spring Boot应用生命周期的管理
4.  spring-boot:stop，在mvn integration-test阶段，进行Spring Boot应用生命周期的管理
5.  spring-boot:build-info，生成Actuator使用的构建信息文件build-info.properties

**3.mvn package spring-boot:repackage说明**  
Spring Boot Maven plugin的最主要goal就是repackage，其在Maven的package生命周期阶段，能够将mvn package生成的软件包，再次打包为可执行的软件包，并将mvn package生成的软件包重命名为\*.original。  
基于上述配置，对一个生成Jar软件包的项目执行如下命令：

mvn package spring-boot:repackage

可以看到生成的两个jar文件，一个是\*.jar，另一个是\*.jar.original。

![f4b0f4eda499cc688e2151208df8814b.png][]

在执行上述命令的过程中，Maven首先在package阶段打包生成\*.jar文件；然后执行spring-boot:repackage重新打包，查找Manifest文件中配置的Main-Class属性，如下所示：

Manifest-Version: 1.0  
    Implementation-Title: gs-consuming-rest  
    Implementation-Version: 0.1.0  
    Archiver-Version: Plexus Archiver  
    Built-By: exihaxi  
    Implementation-Vendor-Id: org.springframework  
    Spring-Boot-Version: 1.5.3.RELEASE  
    Implementation-Vendor: Pivotal Software, Inc.  
    Main-Class: org.springframework.boot.loader.JarLauncher  
    Start-Class: com.ericsson.ramltest.MyApplication  
    Spring-Boot-Classes: BOOT-INF/classes/  
    Spring-Boot-Lib: BOOT-INF/lib/  
    Created-By: Apache Maven 3.5.0  
    Build-Jdk: 1.8.0_131

注意，其中的Main-Class属性值为org.springframework.boot.loader.JarLauncher；

Start-Class属性值为com.ericsson.ramltest.MyApplication。

其中com.ericsson.ramltest.MyApplication类中定义了main()方法，是程序的入口。

通常，Spring Boot Maven plugin会在打包过程中自动为Manifest文件设置Main-Class属性，事实上该属性究竟作用几何，还可以受Spring Boot Maven plugin的配置属性layout控制的，示例如下

注意，其中的Main-Class属性值为org.springframework.boot.loader.JarLauncher；

Start-Class属性值为com.ericsson.ramltest.MyApplication。

其中com.ericsson.ramltest.MyApplication类中定义了main()方法，是程序的入口。

<plugin>  
      <groupId>org.springframework.boot</groupId>  
      <artifactId>spring-boot-maven-plugin</artifactId>  
      <version>1.5.4.RELEASE</version>  
      <configuration>  
        <mainClass>${start-class}</mainClass>  
        <layout>ZIP</layout>  
      </configuration>  
      <executions>  
        <execution>  
          <goals>  
            <goal>repackage</goal>  
          </goals>  
        </execution>  
      </executions>  
    </plugin>

注意，这里的layout属性值为ZIP。layout属性的值可以如下：

1.  JAR，即通常的可执行jar，Main-Class: org.springframework.boot.loader.JarLauncher
2.  WAR，即通常的可执行war，需要的servlet容器依赖位于WEB-INF/lib-provided，Main-Class: org.springframework.boot.loader.warLauncher
3.  ZIP，即DIR，类似于JAR
    
    1.  MODULE，将所有的依赖库打包（scope为provided的除外），但是不打包Spring Boot的任何Launcher
    2.  NONE，将所有的依赖库打包，但是不打包Spring Boot的任何Launcher
    3.  Main-Class: org.springframework.boot.loader.PropertiesLaunche

**4.integration-test阶段中的Spring Boot Maven plugin的start/stop**

<properties>  
      <it.skip>false</it.skip>  
    </properties>  
    <build>  
      <plugins>  
        <plugin>  
          <groupId>org.apache.maven.plugins</groupId>  
          <artifactId>maven-failsafe-plugin</artifactId>  
          <configuration>  
            <skip>${it.skip}</skip>  
          </configuration>  
        </plugin>  
        <plugin>  
          <groupId>org.springframework.boot</groupId>  
          <artifactId>spring-boot-maven-plugin</artifactId>  
          <version>1.5.4.RELEASE</version>  
          <executions>  
            <execution>  
              <id>pre-integration-test</id>  
              <goals>  
                <goal>start</goal>  
              </goals>  
              <configuration>  
                <skip>${it.skip}</skip>  
              </configuration>  
            </execution>  
            <execution>  
              <id>post-integration-test</id>  
              <goals>  
                <goal>stop</goal>  
              </goals>  
              <configuration>  
                <skip>${it.skip}</skip>  
              </configuration>  
            </execution>  
          </executions>  
        </plugin>  
      </plugins>  
    </build>

注意，it.skip变量用作是否跳过integration-test的标志位。

maven-failsafe-plugin用作integration-test的主要执行目标。

spring-boot-maven-plugin用以为integration-test提供支持。

执行integration-test的Maven命令如下：

mvn verify

或者

mvn verify -Dit.skip=false

参考链接：[68. Spring Boot Maven Plugin][]

[https://docs.spring.io/spring-boot/docs/2.5.0/maven-plugin/reference/htmlsingle/\#?.?][https_docs.spring.io_spring-boot_docs_2.5.0_maven-plugin_reference_htmlsingle_.]

[http://docs.spring.io/spring-boot/docs/1.5.4.RELEASE/maven-plugin/][http_docs.spring.io_spring-boot_docs_1.5.4.RELEASE_maven-plugin]

[https://docs.spring.io/spring-boot/docs/current/reference/html/build-tool-plugins-maven-plugin.html][68. Spring Boot Maven Plugin]

### **3.maven-dependency-plugin**插件 ###

之前介绍了使用spring-boot-maven-plugin插件打jar包，会把所有的依赖文件都导入，然后变成了一个可执行的jar包。这样的不好的地方就是，我实际上并不需要把依赖的jar包也打入到生成的jar包里面去，仅仅需要把当前项目的代码打包。生成的jar包只要能引用到它所依赖的jar包，并且可以执行就好了。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lpZ3VhbmdfODIw_size_16_color_FFFFFF_t_70 1][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lpZ3VhbmdfODIw_size_16_color_FFFFFF_t_70 2][]

作用：这个maven-dependency-plugin依赖的作用就是自动拷贝jar包到target目录（和eclipse  打包 runnable jar file的第三种方式类似 [https://blog.csdn.net/yiguang\_820/article/details/117601689][https_blog.csdn.net_yiguang_820_article_details_117601689]）

参考：[https://www.cnblogs.com/acm-bingzi/p/mavenJarDependency.html][https_www.cnblogs.com_acm-bingzi_p_mavenJarDependency.html]

### 4.maven-resources-plugin ###

作用：拷贝资源文件 到指定的resource目录

<plugin>
    			    <artifactId>maven-resources-plugin</artifactId>
    			    <executions>
    			        <execution>
    			            <id>copy-dependencies</id>
    			            <phase>package</phase>
    			            <goals>
    			                <goal>copy-resources</goal>
    			            </goals>
    			            <configuration>
    			                
    			               <outputDirectory>${project.build.directory}/resources</outputDirectory>
    			                <resources>
    			                    <resource>
    			                        <directory>src/main/resources</directory>
    			                        <filtering>true</filtering>
    			                        
    			                        <includes>
    			                            <include>*/**</include>
    			                        </includes>
    			                    </resource>
    			                </resources>
    			            </configuration>
    			        </execution>
    			    </executions>
    			</plugin>

### 5.maven-war-plugin插件 ###

作用：Maven打war包时，排除和包含指定文件或目录

参考：[https://blog.csdn.net/fly910905/article/details/84946029?utm\_medium=distribute.pc\_relevant\_bbs\_down.none-task--2~all~first\_rank\_v2~rank\_v29-9.nonecase&depth\_1-utm\_source=distribute.pc\_relevant\_bbs\_down.none-task--2~all~first\_rank\_v2~rank\_v29-9.nonecase][https_blog.csdn.net_fly910905_article_details_84946029_utm_medium_distribute.pc_relevant_bbs_down.none-task--2_all_first_rank_v2_rank_v29-9.nonecase_depth_1-utm_source_distribute.pc_relevant_bbs_down.none-task--2_all_first_rank_v2_rank_v29-9.nonecase]

<plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-war-plugin</artifactId>
                    <version>3.0.0</version>
                    <configuration>
                        <archiveClasses>false</archiveClasses>
                        <packagingIncludes>
                            WEB-INF/lib/common-core-1.0.0.jar,
                            WEB-INF/lib/common-util-1.0.0.jar,
                            WEB-INF/lib/service-api-1.0.0.jar,
                            WEB-INF/lib/iiot-redis-1.0.0.jar,
                            WEB-INF/lib/iiot-amq-1.0.0.jar,
                            WEB-INF/lib/iiot-oss-1.0.0.jar,
                            WEB-INF/lib/iiot-entity-1.0.0.jar,
                            WEB-INF/classes/cn/**,
                            WEB-INF/classes/mapping/**,
                            WEB-INF/classes/*.properties,
                            WEB-INF/classes/*.conf,
                            WEB-INF/jsp/**,
                            static/**
                        </packagingIncludes>
                        <archive>
    		              <manifest>
    		                <mainClass>cn.rntd.IdentApp</mainClass>
    		              </manifest>
    		            </archive>
                    </configuration>
                </plugin>

# #

## resources ##

<resources>
                
                <resource>
                    <directory>src/main/webapp</directory>
                    <targetPath>META-INF/resources</targetPath>
                    <includes>
                        <include>**/*.*</include>
                    </includes>
                </resource>
                <resource>
                    <directory>src/main/resources</directory>
                </resource>
            </resources>

[https_blog.csdn.net_jk418756_article_details_87917776]: https://blog.csdn.net/jk418756/article/details/87917776
[https_blog.csdn.net_tomato_article_details_13625497]: https://blog.csdn.net/tomato__/article/details/13625497
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lpZ3VhbmdfODIw_size_16_color_FFFFFF_t_70]: /images/20221005/2ed833fffe4e4a6a9fe7b86df7924edc.png
[https_www.cnblogs.com_east7_p_13363069.html_utm_source_tuicool]: https://www.cnblogs.com/east7/p/13363069.html?utm_source=tuicool
[https_www.cnblogs.com_acm-bingzi_p_mavenSpringBootPlugin.html]: https://www.cnblogs.com/acm-bingzi/p/mavenSpringBootPlugin.html
[20210607100852486.png]: /images/20221005/68d4fadb78c8420a9774d08e7d5010dc.png
[f4b0f4eda499cc688e2151208df8814b.png]: /images/20221005/7e017b7bfe614ffebc4664f67e24bb4a.png
[68. Spring Boot Maven Plugin]: https://docs.spring.io/spring-boot/docs/current/reference/html/build-tool-plugins-maven-plugin.html
[https_docs.spring.io_spring-boot_docs_2.5.0_maven-plugin_reference_htmlsingle_.]: https://docs.spring.io/spring-boot/docs/2.5.0/maven-plugin/reference/htmlsingle/#?.?
[http_docs.spring.io_spring-boot_docs_1.5.4.RELEASE_maven-plugin]: http://docs.spring.io/spring-boot/docs/1.5.4.RELEASE/maven-plugin/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lpZ3VhbmdfODIw_size_16_color_FFFFFF_t_70 1]: /images/20221005/4aa2235a40154c6a9536c5f249372e07.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lpZ3VhbmdfODIw_size_16_color_FFFFFF_t_70 2]: /images/20221005/e1057867b66c4f8b87166a2f92489ef3.png
[https_blog.csdn.net_yiguang_820_article_details_117601689]: https://blog.csdn.net/yiguang_820/article/details/117601689
[https_www.cnblogs.com_acm-bingzi_p_mavenJarDependency.html]: https://www.cnblogs.com/acm-bingzi/p/mavenJarDependency.html
[https_blog.csdn.net_fly910905_article_details_84946029_utm_medium_distribute.pc_relevant_bbs_down.none-task--2_all_first_rank_v2_rank_v29-9.nonecase_depth_1-utm_source_distribute.pc_relevant_bbs_down.none-task--2_all_first_rank_v2_rank_v29-9.nonecase]: https://blog.csdn.net/fly910905/article/details/84946029?utm_medium=distribute.pc_relevant_bbs_down.none-task--2~all~first_rank_v2~rank_v29-9.nonecase&depth_1-utm_source=distribute.pc_relevant_bbs_down.none-task--2~all~first_rank_v2~rank_v29-9.nonecase