Maven 常用技巧总结

1. 设置 Java JDK 的版本为「JDK 1.8」

可以修改 pom.xml 添加如下语句实现使用 Java 8 语言特性,共有两种方式,可任选其一:

1.1 添加 property

<project>
  [...]
  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>
  [...]
</project>

1.2 直接配置插件

<project>
  [...]
  <build>
    [...]
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.6.1</version>
        <configuration>
          <source>1.8</source>
          <target>1.8</target>
        </configuration>
      </plugin>
    </plugins>
    [...]
  </build>
  [...]
</project>

2. Maven 构建生成可执行的 Jar

2.1 简单构建可执行的 Jar

<project>
  [...]
  <build>
    [...]
    <plugins>
      <plugin>
        <artifactId>maven-assembly-plugin</artifactId>
        <version>3.0.0</version>
        <configuration>
          [...]
          <archive>
            <manifest>
              <mainClass>org.sample.App</mainClass>
            </manifest>
          </archive>
        </configuration>
        [...]
      </plugin>
      [...]
</project>

此时可使用如下命令构建可执行 Jar

mvn assembly:single

2.2 将 Assembly 的 single 目标绑定到项目的构建生命周期中

可在 pom.xml 文件中添加如下内容:

<project>    
  [...]              
  <build>        
    [...]                            
    <plugins>
        <plugin>
          <artifactId>maven-assembly-plugin</artifactId>
          <version>3.0.0</version>
          <configuration>
            <!-- append assembly id in release file name -->
            <appendAssemblyId>true</appendAssemblyId>
            <!--构建可执行的 Jar-->
            <archive>
              <manifest>
                <mainClass>cc.bitky.fx.Main</mainClass>
              </manifest>
            </archive>
            <!--使用「Jar集成依赖」的描述符-->
            <descriptorRefs>
              <descriptorRef>jar-with-dependencies</descriptorRef>
            </descriptorRefs>
          </configuration>
          <executions>
            <execution>
              <id>make-assembly</id>
              <!-- this is used for inheritance merges -->
              <phase>package</phase>
              <!-- bind to the packaging phase -->
              <goals>
                <goal>single</goal>
              </goals>
            </execution>
          </executions>
        </plugin>
      </plugins>
    [...]  
  </build>
</project>

之后,为了生成项目的 Jar 文件,可以简单地执行如下生命周期阶段命令:

mvn package

构建完毕后,可以看到已经生成了类似于以下名字的文件:

target / sample-1.0-SNAPSHOT-jar-with-dependencies.jar

target / sample-1.0.jar

appendAssemblyId: 控制是否在已生成的文件的文件名中包含「ssembly id」。

execution: 用于将 maven-assembly-plugin 集成至标准的 Maven 构建生命周期中,此时执行 maven package 时就会执行指定的操作,从而实现自定义打包。

2.3 Assembly 插件的 Maven Goals

  • assembly:assembly: 「已弃用」会自动执行 package 生命周期。
  • assembly:single: 仅会装配成 jar-with-dependencies,我们不想让 package 阶段运行两次 package,所以配置为这个。

3. 可执行 Jar 文件执行时出现乱码

使用 Maven 生成的可执行 Jar 文件,在 cmd 中执行时出现乱码,项目编码统一为 UTF-8,日志使用 SLF4J 框架。

3.1 方法 1:windows 默认使用 GBK 编码,执行 Jar 时动态指定编码

运行 java -jar 命令时添加参数

-Dfile.encoding=UTF-8 

格式如下:

java -jar -Dfile.encoding=UTF-8 simpler.jar 

或添加环境变量:

JAVA_TOOL_OPTIONS = -Dfile.encoding=UTF-8

3.2 使用临时的活动代码页运行

在控制台执行命令:

chcp 65001

可将当前 cmd 的编码临时变为 UTF-8,执行 chcp 命令可显示当前 cmd 的编码。

4. Maven 中读取资源文件

在 Maven 项目的根目录下,有如下必要的目录结构:

  • src
    • main
      • resources「存放一些资源文件」
      • java
    • test
      • resources「存放一些资源文件」
      • java
  • pom.xml

在项目的 compile 时期,所有的资源文件和 .class 文件均被复制到 target/classes/ 目录中,获取资源文件,可参考如下语句:

1. this.getClass().getResource("")
   //得到的是当前类 class 文件所在的目录 URL。

2. this.getClass().getResource("/")
3. this.getClass().getClassLoader().getResource("")
4. ClassLoader.getSystemResource("")
5. Thread.currentThread().getContextClassLoader().getResource("")
   //得到的是当前 ClassPath 的绝对 URI 路径。

所以,如若想要获取 resources 文件夹中的资源文件 ky.xml,可使用如下语句之一:

getClass().getClassLoader().getResource("ky.xml")
getClass().getResource("/ky.xml")

5. 参考资料

  1. Setting the -source and -target of the Java Compiler
  2. 关于 Apache Maven 您不知道的 5 件事
  3. Maven 打包可执行 Jar 的方法
  4. 关于创建可执行的 Jar 文件
  5. 初学 Maven - 使用 Assembly Plugin 实现自定义打包
  6. JavaFX and maven: NullPointerException: Location is required
  7. Java 获取文件的路径
  8. Maven 项目打包成 Jar 后执行日志乱码
  9. Console 输出 UTF-8
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 160,277评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,777评论 1 298
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,946评论 0 245
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,271评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,636评论 3 288
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,767评论 1 221
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,989评论 2 315
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,733评论 0 204
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,457评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,674评论 2 249
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,155评论 1 261
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,518评论 3 258
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,160评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,114评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,898评论 0 198
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,822评论 2 280
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,705评论 2 273

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,103评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,377评论 6 343
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,579评论 25 707
  • 母亲是共和国的同龄人,她属牛,生在早晨,注定要操劳一生。 父亲曾给我们说,你妈妈是头老黄牛。多年以来,我一直都觉得...
    今小汐阅读 2,016评论 2 3
  • □宇宙中仿佛有一种冥冥巨大的力量,一股支配人命运的力量,就是惩恶扬善的力量:保护善人。至于恶人,虽然他现在很的得意...
    别必圣阅读 584评论 0 0