MAVEN打包这一篇就够了

article/2025/9/19 13:10:46

Maven打包说明

IDEA目录结构

Java代码从编码到最后运行到两个核心步骤为"编译"和"执行"。"编译"会根据"源代码"产出对应的".class"文件,而"执行"就是让程序运行起来,运行的对象就是这些".class"文件。

那么,“源代码”也好,“.class”文件也好被放到了哪里呢?目录结构是怎样的呢?

  • 如图所示:“quark-net”是一个module的根目录,也就是工程目录。

  • “quark-net”的下一级有两个目录,一个是“src”,一个是“target”。简单的理解,“src”就是常规的“源代码”存在的最上级目录,而“target”就是“编译”后生成的文件位置的最上级目录。

  • “src”的下一级也有两个目录,一个是“main”,一个是“test”。简单的理解,“main”内是项目正式文件,而“test”内是项目测试文件。

  • “src/main”的下一级也有两个目录,一个是“java”,一个是“resources”。简单理解,“java”内就是项目源代码,而“resources”内是程序运行所需要的资源文件(一般以配置文件居多)。

  • “target”内部需要关注的就是“classes”目录,“src/main”内的文件编译后就是到“target/classes”内。

MAVEN打包

默认打包思路

mvn clean install

  • 以上命令为默认MAVEN打包的命令

  • 使用该命令打包时,项目工程也会先被“编译”,“target/classes”下会有重新编译的内容。包括源代码编译后的“.class”文件,以及resources目录下的资源文件。

  • “编译”完成后,就会打包。所有“target/classes”下的内容会被打进最后形成的JAR包内(这也证明了JAVA程序的特点,一次编译,多处运行。因为JAR包内的文件已经是“编译”后的内容)。

定制打包思路

这个用到了插件,需要先理解下述的配置以及原理

mvn clean package assembly:single

默认打包方式,最后会把“target/classes”内的所有文件放到JAR包内,包括resources下的文件。思考这样一个问题,如果resources里面有项目启动时的配置文件,那么如果我们在运行jar包的时候,想修改配置文件内的内容怎么办呢?按照默认打包方式,我们需要先修改配置文件,然后再重新打包,这样每一次对配置文件的修改,都依附于一次重新打包。此时,就需要有一种方法来支持所谓的“配置文件外置”的需求。

  1. 定制“编译”

“编译”的时候会把“src/main”内的文件编译后放到“target/classes”下,打包会把“target/classes”下的文件放进JAR包。既然如此,想要实现“配置文件外置”的需求,就要找一种方式,让“src/main/resources”下的文件不被编译进“target/classes”下就可以了,这就需要用到项目pom文件中的“resource”标签了。

  • 在pom文件中增加上述配置即可自定义指定编译后文件的存放位置。

  • 上述配置之后,“src/main/resources”下的文件会被放到“target/resources”目录下。

  • 此时再打包时,“target/classes”下就不会有“src/main/resources”的内容,那么对应的JAR包内也不会有这部分文件了。

  • 此处只是用一个例子作为介绍,实际上理解了本质,pom中的该标签可以根据需求做出很多配置。此处不对该标签做过多的介绍,但其实际功能远不止此。

  1. 定制“打包”

经过上述定制“编译”后,如果使用maven打包,JAR包内是不会有配置文件的(src/main/resources下的文件都不会有)。虽然解决了这个问题,但是此时直接执行JAR包,肯定无法运行,因为JAR包内没有了配置文件,那么程序也就找不到配置文件了。所以,需要一种方式,告诉JAR包,配置文件去哪里读取。这里,介绍使用MAVEN插件的方式,指定配置文件。

  • pom文件增加上述插件的配置,如图所标识的配置,就是告诉JAR包,你执行的时候去这个路径下读取配置文件,这个路径是相对于JAR包位置的路径。例子中配置的就是JAR包同级目录下的resources文件夹下去读配置文件。

  • 该插件的其他配置可以参考注释,此处不做过多解释,只需要知道标注的位置告诉了JAR包读取配置文件的路径即可。

  1. 形成“压缩包”

有了定制编译后,我们分离了JAR包和配置文件。有了定制打包后,我们告诉了JAR包读取外置配置文件的路径。思考一个问题,难道每次我们都要手动拷贝src/main/resources内的文件,然后放到JAR包同目录下的位置(也可以配置其他位置,此处以上述例子中的配置做介绍)吗?此时我们可以在打包的时候除了形成JAR包,同时也将其他我们想要的内容也进行打包,最后将这全部的内容全部打进一个整体的包内。此处还是介绍一种MAVEN插件的形式。

  • 如图所示,pom中配置此插件,进行整体打包。

  • 该插件需要assembly.xml的配置文件,如图标识为改配置文件的路径。

  • 如上图所示,第一个标注为最终整体包的压缩方式,此处配置的是zip包。

  • 而第二个标注就是将“src/main/resources”里的内容打进zip包的根目录的resources目录下。

  • fileSets中的第二个fileSet的配置是将JAR包也放到zip包的根目录下。至此,JAR包和外置配置文件的相对路径就形成了。

本地读取不到配置文件问题

在进行上述的配置后,已经成功解决了“resources”资源文件外置的问题,这样只要打包一次后,每次运行的时候都可以修改配置文件,并且让修改后的配置文件生效了。但是,如果你真的这么配置了,当你在某些时候使用本地IDEA运行自己的工程代码的时候,会提示找不到配置文件的错误。

如果理解JAVA程序资源路径的配置这个问题就会很容易理解。如上图所示,我们程序中配置文件的路径可以直接使用相对路径,那么这个相对路径在使用ClassLoader去load的时候,其实就是target/calsses里面去找。也就是说,“.class”文件执行时候的相对位置的相对路径就是“target/classes”路径。图中直接在源代码中使用的配置文件虽然直接写的是“robot.properties”,但其实是“target/classes/robot.properties”,因为源代码编译后的路径是“target/classes”目录。

理解了JAVA程序资源路径的配置后,这个问题就会很容易理解。我们在pom中定制编译的时候重新指定了资源文件的位置,那么“target/classes”中已经没有了资源文件,自然就找不到了。

一种简单的解决方式,就是程序中写的路径,需要指定为pom中定制编译时重新指定的路径。另一种简单的方式是,每次本地IDEA编译执行的时候,将pom中<resource>标签注释掉,打包的时候再启用。无论是哪种方式都不太理想,这里提供一种新的思路。

该思路为,定制编译的时候还是将src/main/resources下的内容编译进target/classes中,这样保证了本地执行的时候可以找到配置文件。然后插件配置的时候使用includes标签,只将.class文件打进jar包,这样依然保证了JAR包内不会打进资源文件,然后资源文件仍旧是使用插件打进zip包内配置的相对路径下即可!


http://chatgpt.dhexx.cn/article/jNZraq3V.shtml

相关文章

Maven项目的简单打包

最简单的方法 首先是在maven项目的pom.xml中添加打包的插件&#xff0c;这里有很多种方式的。最最简单的就是只使用maven-compiler-plugin、maven-jar-plugin插件&#xff0c;并且指定程序入口。相关代码如下&#xff1a; pom.xml文件&#xff1a; <?xml version"1…

关于maven打包出错解决

今天在使用maven打包时出现错误&#xff0c;因此记录一下。。 出现错误的原因是因为maven中的指定的java版本与项目使用的java版本不一致导致的。。 maven中的java版本为11 而项目使用版本为1.8 因此会出现如下错误 解决版本有两种&#xff0c;一种是修改maven中对应的java版本…

maven打包步骤

1&#xff1a;配置maven环境 2、项目中进行打包配置 3、先进行mvn clean 4、进行打包 5、通过cmd进行项目启动 6、测试项目是否已启动 结束&#xff0c;验证ok

SpringBoot - Maven方式打包

SpringBoot 为当前最流行的JAVA框架 , 内嵌了 Tomcat 服务器 , 我们不用再像以前 Spring 那样打包成 war , 然后将 war 扔到 tomcat 中运行 。 我们现在可以直接将 SpringBoot 项目打包为一个内置 tomcat 的可运行 jar , 通过 java -jar xxx.jar 直接运行 (方便易用) 。 打包 S…

Maven打包操作

对于企业级项目&#xff0c;无论是进行本地测试&#xff0c;还是测试环境测试以及最终的项目上线&#xff0c;都会涉及项目的打包操作。对于每个环境下的项目打包&#xff0c;对应的项目所需要的配置资源都会有所区别&#xff0c;实现打包的方式有很多种&#xff0c;可以通过an…

Maven打包时指定配置文件

springboot项目通常会有部署到测试、演示、生产等多个环境&#xff0c;每次打包时都需要修改配置文件或指定配置文件&#xff0c;既麻烦&#xff0c;也不便于war包部署和版本管理。可以在maven打包时指定配置文件&#xff0c;实现打包配置文件零修改。 1、修改pom文件&#xff…

Maven打包插件介绍

文章目录 1. maven介绍2. 生命周期及插件2.1 总览生命周期2.2 打包插件2.2.1 maven-jar-plugin2.2.2 maven-assembly-plugin2.2.3 maven-shade-plugin2.2.4 maven-war-plugin2.2.4.1 jar和war 2.2.5 maven-source-plugin 3. springboot打包插件4.实际操作4.1 一个可用的打包插件…

maven项目如何打包

说明(java)&#xff1a; &#xff08;1&#xff09;胖包&#xff1a;将maven项目中的依赖包和项目打为一个包 。 &#xff08;2&#xff09;瘦包&#xff1a;直接打包&#xff0c;不打包依赖包&#xff0c;仅打包出项目中的代码到JAR包中。 1.打瘦包 2.只打胖包 2-1.快捷键…

Maven工程打包jar

Maven打包一般可以生成两种包一种是可以直接运行的包&#xff0c;一种是依赖包&#xff08;只是编译包&#xff09;。Maven默认打包时jar&#xff0c;如果需要修改其他类型。可以修改pom.xml <packaging>jar/ear/ejb</packaging> Maven工程默认引入的插件: 1.一般…

Maven打包的三种方式

Maven可以使用mvn package指令对项目进行打包&#xff0c;如果使用Java -jar xxx.jar执行运行jar文件&#xff0c;会出现"no main manifest attribute, in xxx.jar"&#xff08;没有设置Main-Class&#xff09;、ClassNotFoundException&#xff08;找不到依赖包&…

maven命令行打包

maven打包项目 maven项目打包命令行maven打包本地资源文件夹使用命令行打包(maven) maven项目打包 当前的Java项目中我们都习惯使用maven来管理项目中的jar包的依赖关系&#xff0c;同时通过maven我们也可以将项目打包到"本地" 或者 “自己远程的maven仓库中” 命令…

maven打包三种方式

方法一&#xff1a;cmd 控制台打包&#xff08;比较不推荐&#xff09; 首先安装maven插件百度下载一个&#xff0c;配置环境变量什么的~在cmd控制台能mvn version能有数据出现。 打包只需要到项目的根目录下~在cmd敲入mvn package.不推荐原因&#xff1a;报错后的报错信息比…

Maven------打包

1.软件工程 软件工程的核心思路:写代码也是一件工程,也是一件非常复杂的事情,正因为复杂,所以容易出现问题,想一些办法来进行预防和解决问题,我们就要使用一些第三方库; 如何使用库和框架来进行解决问题? 软件开发中也会有很多的常见问题和常见的场景,针对这些场景和问题也…

探究maven项目的打包方式

目录 前言 概念 准备 打包方式 idea自带的maven工具 小包打包第一种方式 小包打包第二种方式 小包总结 大包打包 maven-compiler-plugin 依赖配置 打包测试 效果 maven-jar-plugin 和 maven-dependency-plugin maven-jar-plugin maven-dependency-plugin 依赖配…

6.Maven打包操作

对于企业级项目&#xff0c;无论是进行本地测试&#xff0c;还是测试环境测试以及最终的项目上线&#xff0c;都会涉及项目的打包操作。对于每个环境下的项目打包&#xff0c;对应的项目所需要的配置资源都会有所区别&#xff0c;实现打包的方式有很多种&#xff0c;可以通过an…

Maven 的打包方式

一、前言 刚开始实习不到一个月的时候&#xff0c;从师兄手中接手了团队的项目&#xff0c;当时第一次听到了 “大包”、“小包” 的概念&#xff0c;只见师兄一顿操作&#xff0c;使用 Maven 将项目进行了打包。当时不太理解&#xff0c;只是记得两点&#xff1a; 如果想让项…

Java中main()方法的使用

一、main()方法的使用说明 main()方法作为程序的入口。main()方法也是一个普通的静态方法。main()方法可以作为我们与控制台交互的方式&#xff08;之前&#xff1a;使用Scanner&#xff09;。 二、main()方法使用举例 MainDemo.java public class MainDemo {public static…

JAVA中main方法如何执行。

public class Test{public static void main(String[] args){System.out.println("hello world");}} 上述就是java代码中的一段简单的main函数的代码&#xff0c;代码执行后输出结果为&#xff1a;hello world main函数&#xff1a; 在java中main函数是一个特殊的…

深入理解Java的main方法

一、简单介绍 在我们的Java程序中都会出现一个名称为main的方法&#xff0c;我们发现没有这个方法我们的程序就无法运行。 其实任何一个Java程序的运行入口都是这个main方法&#xff0c;也就是说&#xff0c;程序在运行的时候&#xff0c;第一个执行的方法就是main()方法&#…

main方法详解

学习Java有一段时间了&#xff0c;一直没用过博客来写写自己在学习过程中遇到的问题和学习心得&#xff0c;看到别人在诸如博客这样的社区写一些总结觉得挺好的。索性&#xff0c;今天开始自己也用起博客记录学习。一来呢&#xff0c;能更好的总结学习知识。二来&#xff0c;有…