编译命令

  1. mvn clean install -Dmaven.test.skip=true -Dmaven.javadoc.skip=true -Dcheckstyle.skip=true
  2. mvn clean package -DskipTests -Dfast

说明：

  • -Dmaven.test.skip：跳过测试代码
  • -Dmaven.javadoc.skip：跳过 javadoc 检查

  • -Dcheckstyle.skip：跳过代码风格检查

    编译范围（scope）

    | scope取值 | 有效范围（compile, runtime, test） | 依赖传递 | 例子 | | —- | —- | —- | —- | | compile | all | 是 | spring-core | | provided | compile, test | 否 | servlet-api | | runtime | runtime, test | 是 | JDBC驱动 | | test | test | 否 | JUnit | | system | compile, test | 是 |
    |

  • compile ：为默认的依赖有效范围。如果在定义依赖关系的时候，没有明确指定依赖有效范围的话，则默认采用该依赖有效范围。此种依赖，在编译、运行、测试时均有效。

  • provided ：在编译、测试时有效，但是在运行时无效。例如：servlet-api，运行项目时，容器已经提供，就不需要Maven重复地引入一遍了。
  • runtime ：在运行、测试时有效，但是在编译代码时无效。例如：JDBC驱动实现，项目代码编译只需要JDK提供的JDBC接口，只有在测试或运行项目时才需要实现上述接口的具体JDBC驱动。
  • test ：只在测试时有效，例如：JUnit。

  • system ：在编译、测试时有效，但是在运行时无效。和provided的区别是，使用system范围的依赖时必须通过systemPath元素显式地指定依赖文件的路径。由于此类依赖不是通过Maven仓库解析的，而且往往与本机系统绑定，可能造成构建的不可移植，因此应该谨慎使用。systemPath元素可以引用环境变量，当引用第三方包，且没有源代码时候，可以使用system path。

    1. <dependency>
    2.   <groupId>ctec</groupId>
    3.   <artifactId>xxx-core</artifactId>
    4.   <version>1.0</version>
    5.   <scope>system</scope>
    6.   <systemPath>${project.basedir}/src/main/resources/libs/ctec-xxx-core.jar</systemPath>
    7. </dependency>

    若要将jar包含到war中，需要使用true。

    1. <plugins>
    2.   <plugin>
    3.       <groupId>org.springframework.boot</groupId>
    4.       <artifactId>spring-boot-maven-plugin</artifactId>
    5.       <configuration>
    6.           <includeSystemScope>true</includeSystemScope>
    7.       </configuration>
    8.   </plugin>
    9. </plugins>

    手动安装jar包到仓库

  • cmd

    1. mvn install:install-file -DgroupId=com.mapr.hadoop -DartifactId=maprfs -Dversion=5.2.1-mapr -Dpackaging=jar  -Dfile=/home/hadoop/downloads/maprfs-5.2.1-mapr.jar
    2. mvn install:install-file -DgroupId=com.oracle -DartifactId=ojdbc6 -Dversion=11.2.0.1.0 -Dpackaging=jar -Dfile=ojdbc6.jar

  • bat ```powershell @echo off

call mvn install:install-file -DgroupId=com.mapr.hadoop -DartifactId=maprfs -Dversion=5.2.1-mapr -Dpackaging=jar -DgeneratePom=true -Dfile=/home/hadoop/downloads/maprfs-5.2.1-mapr.jar call mvn install:install-file -DgroupId=com.oracle -DartifactId=ojdbc6 -Dversion=11.2.0.1.0 -Dpackaging=jar -Dfile=ojdbc6.jar

  1. <a name="sCCMN"></a>
  2. # 仓库清理
  3. ```bash
  4. find /home/vagrant/repository* -name "*.lastUpdated" -exec rm -rf {} \;
  5. find /home/vagrant/repository* -name "*_remote.repositories" -exec rm -rf {} \;

Maven冲突解决

  1. # 重定向到文件
  2. mvn dependency:tree>temp/tree.txt
  3. # 参数过滤
  4. mvn dependency:tree -Dincludes=jline
  5. # 将当前所有的依赖关系都展示出来，包括来自不同处的依赖项
  6. mvn dependency:tree -Dverbose -Dincludes=commons-collections

通过Maven创建的工程的JDK版本

  1. 打开settings.xml文件。
  2. 找到profiles标签。

  3. 加入如下配置。

    1. <profile>
    2.  <id>jdk-1.7</id>
    3.  <activation>
    4.      <activeByDefault>true</activeByDefault>
    5.      <jdk>1.7</jdk>
    6.  </activation>
    7.  <properties>
    8.      <maven.compiler.source>1.7</maven.compiler.source>
    9.      <maven.compiler.target>1.7</maven.compiler.target>
    10.      <maven.compiler.compilerVersion>1.7</maven.compiler.compilerVersion>
    11.  </properties>
    12. </profile>

    Eclipse配置Maven仅连接本地仓库

  4. 设置Settings.xml。 ```xml <?xml version=”1.0” encoding=”UTF-8”?>

    E:\bigdataenv\m2\repository

    true 

  2. 2. 修改本机host文件，禁止外网仓库连接，将其指向本机，这样Maven可以快速判断连接失败。

127.0.0.1 repository.apache.org 127.0.0.1 repo.maven.apache.org

  2. 3. 更新index，window => preferences => maven  选中“download repository index updates on startup”项（同时建议也勾选上：“Download Artifact Sources”、“Download Artifact JavaDoc”），重启eclipse即可。
  3. <a name="q8TVo"></a>
  4. # 输出日志
  5. ```bash
  6. mvn -X -U clean package -l build.log

控制依赖传递（optional）

optional是maven依赖jar时的一个选项，表示该依赖是可选的，不会被依赖传递。

  1. <dependency>
  2.     <groupId>org.apache.logging.log4j</groupId>
  3.     <artifactId>log4j-api</artifactId>
  4.     <optional>true</optional>
  5. </dependency>
  7. <dependency>
  8.     <groupId>org.apache.logging.log4j</groupId>
  9.     <artifactId>log4j-core</artifactId>
  10.     <optional>true</optional>
  11. </dependency>

Maven常用插件

  • maven-jar-plugin

  • maven-assembly-plugin

    1. <plugin>
    2. <groupId>org.apache.maven.plugins</groupId>
    3. <artifactId>maven-assembly-plugin</artifactId>
    4. <executions>
    5.   <execution>
    6.     <phase>package</phase>
    7.     <goals>
    8.       <goal>single</goal>
    9.     </goals>
    10.     <configuration>
    11.       <archive>
    12.         <manifest>
    13.           <mainClass>
    14.             com.github.kongwu.mavenbuild.BuildExample
    15.           </mainClass>
    16.         </manifest>
    17.       </archive>
    18.       <descriptorRefs>
    19.         <descriptorRef>jar-with-dependencies</descriptorRef>
    20.       </descriptorRefs>
    21.     </configuration>
    22.   </execution>
    23. </executions>
    24. </plugin>

  • maven-shade-plugin

管理依赖冲突、依赖隔离（maven-assembly-plugin依赖和资源文件都打入最终的Jar包，有同名覆盖问题）、可执行jar（设置MainClass）、依赖排除（最小化，将不用的类排除）、打包所有依赖（常规打包是不会将所依赖jar包打进来的）

  1. <plugin>
  2.   <groupId>org.apache.maven.plugins</groupId>
  3.   <artifactId>maven-shade-plugin</artifactId>
  4.   <executions>
  5.     <execution>
  6.       <goals>
  7.         <goal>shade</goal>
  8.       </goals>
  9.       <configuration>
  10.         <shadedArtifactAttached>true</shadedArtifactAttached>
  11.         <transformers>
  12.           <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
  13.             <mainClass>com.github.kongwu.mavenbuild.BuildExample</mainClass>
  14.           </transformer>
  15.         </transformers>
  16.       </configuration>
  17.     </execution>
  18.   </executions>
  19. </plugin>

重命名jar：

  1. <plugin>
  2.   <groupId>org.apache.maven.plugins</groupId>
  3.   <artifactId>maven-shade-plugin</artifactId>
  4.   <version>3.2.3</version>
  5.   <executions>
  6.     <execution>
  7.       <phase>package</phase>
  8.       <goals>
  9.         <goal>shade</goal>
  10.       </goals>
  11.       <configuration>
  12.         <minimizeJar>true</minimizeJar>
  13.         <createDependencyReducedPom>false</createDependencyReducedPom>
  14.         <outputFile>${project.basedir}/target/${project.artifactId}.jar</outputFile>
  15.         <transformers>
  16.           <transformer 
  17. implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
  18.             <mainClass>com.github.test.Main</mainClass>
  19.           </transformer>
  20.           <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
  21.         </transformers>
  22.         <artifactSet>
  23.           <excludes>
  24.             <exclude>junit:junit</exclude>
  25.           </excludes>
  26.         </artifactSet>
  27.       </configuration>
  28.     </execution>
  29.   </executions>
  30. </plugin>
  • maven-compiler-plugin

  • maven-dependency-plugin

    1. <plugin>
    2. <groupId>org.apache.maven.plugins</groupId>
    3. <artifactId>maven-dependency-plugin</artifactId>
    4. <executions>
    6.   <execution>
    7.     <id>unpack-dependencies</id>
    8.     <!-- 绑定到 prepare-package 阶段 -->
    9.     <phase>prepare-package</phase>
    10.     <goals>
    11.       <goal>unpack-dependencies</goal>
    12.     </goals>
    13.     <configuration>
    14.       <includeScope>runtime</includeScope>
    15.       <outputDirectory>${project.build.outputDirectory}</outputDirectory>
    16.     </configuration>
    17.   </execution>
    18. </executions>
    19. </plugin>

    |
    | dependency | shade | assembly | | —- | —- | —- | —- | | 优点 | goals丰富，除了unpack还有很多其他的功能，比如清理/查看依赖树等等 | 专为uber-jar而生，而且支持shade功能，如果有重定位的需求，只能选它 | 功能最强，配置非常灵活，但没有shade功能 | | 缺点 | 毕竟只是个处理依赖的插件，在构建方面的功能比较弱 | 复杂的构建需求下，功能会有些不足 | 没有shade功能，而且配置比较复杂 | | 应用场景 | 适合简单的uber-jar功能 | 最适合uber-jar的构建，配合shade功能简直完美 | 适合复杂场景下的构建，不止是uber jar |

常见问题

  1. Java命令运行时提示“*.jar中没有主清单属性”**。

解决：在pom中添加maven插件maven-shade-plugin 即可。

  1. <build>
  2.         <plugins>
  3.             <plugin>
  4.                 <groupId>org.apache.maven.plugins</groupId>
  5.                 <artifactId>maven-shade-plugin</artifactId>
  6.                 <version>2.3</version>
  7.                 <executions>
  8.                     <execution>
  9.                         <phase>package</phase>
  10.                         <goals>
  11.                             <goal>shade</goal>
  12.                         </goals>
  13.                         <configuration>
  14.                             <transformers>
  15.                                 <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
  16.                                     <mainClass>org.polaris.PlatformMain</mainClass>
  17.                                 </transformer>
  18.                             </transformers>
  19.                         </configuration>
  20.                     </execution>
  21.                 </executions>
  22.             </plugin>
  23.         </plugins>
  24. </build>

对于SpringBoot：

  1. <build>
  2.   <plugins>
  3.     <plugin>
  4.       <groupId>org.springframework.boot</groupId>
  5.       <artifactId>spring-boot-maven-plugin</artifactId>
  6.     </plugin>
  7.   </plugins>
  8. </build>

参考

码经笔记：SpringBoot项目集成maven-shade-plugin
https://majing.io/posts/10000050811155
博文：Maven各种花式构建，不用SpringBoot也能打出可执行Jar包
http://www.soiiy.com/java/11841.html