Java知其所以然 · 2019年08月24日

maven 打包资源文件需要注意的问题

初衷

我写这篇博客的目的是想让大家了解一些 maven 项目的结构以及打包后是什么样子的,方便大家在实际项目中去排查问题。比如:我明明在 src/main/java 下把 mybatis 的 xml 写上了,为什么项目报错读不到呢?我配置了多种环境的配置文件,真正运行时只会选择一个,所以不想把 src/main/resources 下的所以文件都打包到 target/classes 下,那该怎么办?

maven 的标准的目录结构

构建Maven项目的时候,如果没有进行特殊的配置,Maven会按照标准的目录结构查找和处理各种类型文件。
标准的目录结构如下:

  • src

    • main

      • java 源文件
      • resources 资源文件
    • test

      • java 测试源文件
  • pom.xml

在这里插入图片描述

maven 资源的相关配置

src/main/java和src/test/java

这两个目录中的所有 .java 文件会分别在 comile 和 test-comiple 阶段被编译,编译结果分别放到了target/classes 和 targe/test-classes 目录中,但是这两个目录中的其他文件(比如:.xml 等)都会被忽略掉。

src/main/resouces和src/test/resources

这两个目录中的文件也会分别被复制到target/classes和target/test-classes目录中。

target/classes

maven 打包插件默认会把这个目录中的所有内容打入到 jar 包或者 war 包中。

resource

maven resource 需要注意的问题。默认情况下 maven 会根据标准路径去把对应的文件全部复制到 target 下。如果需要选择性打包某些文件的话,就需要用到 resource。

下面以我创建的 maven 项目 mavenDemo 为例。

在 mavenDemo 项目的 pom.xml 中加入下面配置,目的是:只将 src/main/resources 下的后缀为 properties、xml 的文件打包到 classes 文件下。效果如图 1。

使用 maven 的 clean package 命令就可以打包我们的项目到 target 文件下。注意一定要先执行 maven 的 clean 命令,后执行 package 命令。 直接使用 package 命令可能会存在缓存,使得我们看不到最新的修改。
<build>
    .......
      <resources>
        <resource>
            <directory>src/main/resources</directory>
            <!-- 设置需要打包的文件,可以使用正则表达式 -->
            <includes>
                    <include>**/*.yml</include>
                    <include>**/*.xml</include>
            </includes>
            <!-- 开启资源打包过滤 -->
            <filtering>true</filtering>
        </resource>
      </resources>
    ......
</build>

我们可以看到项目打包后,src/main/resources 下的 .sql 文件就被过滤掉了,只留下了 .yml、.xml 的配置文件。

图 1
图 1

微信公众号

喜欢的话可以关注公众号 :Java知其所以然

推荐阅读
关注数
0
文章数
4
微信公众号:Java知其所以然
目录
极术微信服务号
关注极术微信号
实时接收点赞提醒和评论通知
安谋科技学堂公众号
关注安谋科技学堂
实时获取安谋科技及 Arm 教学资源
安谋科技招聘公众号
关注安谋科技招聘
实时获取安谋科技中国职位信息