如何给 Java 文件打成独立的 JAR 包

2024-09-02 23:44
文章标签 java 独立 jar 打成

本文主要是介绍如何给 Java 文件打成独立的 JAR 包,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

如何给 Java 文件打成独立的 JAR 包

在 Java 开发中,打包 JAR(Java ARchive)文件是将编译后的 .class 文件、资源文件(如配置文件、图片等)以及依赖的库文件打包成一个压缩文件,便于分发和运行的常见操作。本文将详细介绍如何将 Java 文件打成独立的 JAR 包,包括各个步骤的详细说明(包括maven项目和非maven项目)。


一、 非Maven项目如何单独打成JAR包

1. 准备工作

在开始打包之前,确保你已经具备以下环境和文件:

  • Java Development Kit (JDK):确保已经安装了 JDK 并正确配置了环境变量(JAVA_HOME)。
  • Java 源代码:已编写并通过编译的 Java 程序,通常存放在 src 目录下。
  • Manifest 文件(可选):用于指定主类和其他 JAR 文件的元数据文件(MANIFEST.MF)。

假设你有一个简单的 Java 项目结构如下:

MyProject/
│
├── src/
│   └── com/
│       └── example/
│           └── MyApp.java
│
└── manifest/└── MANIFEST.MF

其中,MyApp.java 是你的主程序文件,MANIFEST.MF 是你的可选 manifest 文件。


2. 编译 Java 文件

首先,你需要将 .java 源文件编译成 .class 字节码文件。假设你当前位于项目的根目录(即 MyProject/ 目录下)。

命令:

javac -d out/production/classes src/com/example/MyApp.java
  • -d 参数指定了编译后的 .class 文件存放目录。
  • out/production/classes 是编译后 .class 文件的输出目录。

执行后,你将得到如下的项目结构:

MyProject/
│
├── out/
│   └── production/
│       └── classes/
│           └── com/
│               └── example/
│                   └── MyApp.class
│
├── src/
│   └── com/
│       └── example/
│           └── MyApp.java
│
└── manifest/└── MANIFEST.MF

3. 创建 Manifest 文件(可选)

Manifest 文件可以指定 JAR 包的入口类以及其他元数据。如果没有提供 manifest 文件,JAR 包将无法通过命令行直接运行。

示例 MANIFEST.MF 文件内容:

Manifest-Version: 1.0
Main-Class: com.example.MyApp
  • Main-Class 指定了 JAR 包的入口类,也就是 public static void main(String[] args) 方法所在的类。

4. 打包成 JAR 文件

在编译完成和(可选的)manifest 文件准备好后,你可以使用 jar 命令将项目打包成 JAR 文件。

命令:

jar cvfm MyApp.jar manifest/MANIFEST.MF -C out/production/classes/ .
  • c 选项表示创建一个新的 JAR 文件。
  • v 选项表示生成详细输出。
  • f 选项表示指定 JAR 文件的名称。
  • m 选项表示将 manifest 文件添加到 JAR 文件中。
  • -C 选项表示切换到指定目录并添加该目录下的文件到 JAR 文件中。
  • MyApp.jar 是生成的 JAR 文件的名称。

执行后,你将得到如下的项目结构:

MyProject/
│
├── MyApp.jar
│
├── out/
│   └── production/
│       └── classes/
│           └── com/
│               └── example/
│                   └── MyApp.class
│
├── src/
│   └── com/
│       └── example/
│           └── MyApp.java
│
└── manifest/└── MANIFEST.MF

MyApp.jar 就是你打包好的 JAR 文件。


5. 运行 JAR 文件

生成 JAR 文件后,你可以通过以下命令来运行它:

命令:

java -jar MyApp.jar

如果 JAR 包包含正确的 Main-Class 信息,它将直接执行主程序。


6. 常见问题与解决方法
6.1 找不到主类

如果在运行 JAR 包时出现 Error: Could not find or load main class 错误,通常是因为 Main-Class 未正确配置或路径错误。确保 MANIFEST.MF 文件中的 Main-Class 指向正确的类,并且在打包时使用了 -m 选项将 manifest 文件包含在 JAR 包中。

6.2 打包后缺少依赖库

如果你的项目依赖于外部库,需要将这些库打包到 JAR 文件中。可以使用 fat JARuber JAR 的方法,将所有依赖库打包到一个 JAR 文件中。常见工具如 Maven 的 shade 插件或 Gradle 的 shadow 插件都可以实现这一点。


二、Maven项目如何单独打成JAR包

在使用Maven进行项目管理时,将项目打包成JAR文件是一项非常常见的操作。Maven通过提供内置的生命周期阶段,极大地简化了代码的编译和打包过程。接下来我们详细讲解如何使用Maven将一个电商系统的项目单独打包成JAR文件。

2.1 配置pom.xml文件

首先,确保你的pom.xml文件中已经正确配置了相关依赖和插件。通常,我们需要使用Maven的maven-jar-plugin来帮助我们完成打包操作。

<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.ecommerce</groupId><artifactId>ecommerce-system</artifactId><version>1.0-SNAPSHOT</version><packaging>jar</packaging><dependencies><!-- 这里添加项目所需的依赖 --></dependencies><build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-jar-plugin</artifactId><version>3.2.0</version><configuration><archive><manifest><mainClass>com.ecommerce.MainApplication</mainClass></manifest></archive></configuration></plugin></plugins></build>
</project>
  • artifactId:表示项目的唯一标识符,通常与项目名保持一致。
  • version:项目的版本号,通常是SNAPSHOT(开发中版本)或者特定的发布版本号。
  • packaging:指定打包类型为jar
  • mainClass:指定项目的主类路径,这个类包含main方法,是程序的入口。
2.2 使用Maven命令打包

配置好pom.xml文件后,可以使用Maven命令来打包项目。

mvn clean package

执行该命令后,Maven会进行以下步骤:

  1. 清理阶段:删除之前编译生成的目标目录下的内容。
  2. 编译阶段:编译源代码,将Java文件编译为字节码文件(.class)。
  3. 测试阶段:执行测试用例,确保代码功能正常(如果有测试用例)。
  4. 打包阶段:将编译生成的文件和资源文件打包成一个JAR文件。

打包成功后,JAR文件会生成在target目录下,文件名通常为artifactId-version.jar,例如ecommerce-system-1.0-SNAPSHOT.jar

2.3 运行生成的JAR包

打包完成后,可以通过以下命令运行生成的JAR文件:

java -jar target/ecommerce-system-1.0-SNAPSHOT.jar

如果pom.xml文件配置正确,程序将会顺利启动。

2.4 使用maven-shade-plugin合并依赖

有时候,我们可能需要将所有依赖一起打包进JAR文件中,这时可以使用maven-shade-plugin插件。

pom.xml中添加以下配置:

<build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-shade-plugin</artifactId><version>3.2.4</version><executions><execution><phase>package</phase><goals><goal>shade</goal></goals><configuration><createDependencyReducedPom>false</createDependencyReducedPom></configuration></execution></executions></plugin></plugins>
</build>

然后再次执行mvn clean package命令,生成的JAR文件将包含所有依赖,方便直接运行。

这样,你就成功将Maven项目打包成了一个可执行的JAR文件,接下来可以继续深入部署和运行这个JAR文件。

这篇关于如何给 Java 文件打成独立的 JAR 包的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1131414

相关文章

Java学习手册之Filter和Listener使用方法

《Java学习手册之Filter和Listener使用方法》:本文主要介绍Java学习手册之Filter和Listener使用方法的相关资料,Filter是一种拦截器,可以在请求到达Servl... 目录一、Filter(过滤器)1. Filter 的工作原理2. Filter 的配置与使用二、Listen

Spring Boot中JSON数值溢出问题从报错到优雅解决办法

《SpringBoot中JSON数值溢出问题从报错到优雅解决办法》:本文主要介绍SpringBoot中JSON数值溢出问题从报错到优雅的解决办法,通过修改字段类型为Long、添加全局异常处理和... 目录一、问题背景:为什么我的接口突然报错了?二、为什么会发生这个错误?1. Java 数据类型的“容量”限制

Java对象转换的实现方式汇总

《Java对象转换的实现方式汇总》:本文主要介绍Java对象转换的多种实现方式,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧... 目录Java对象转换的多种实现方式1. 手动映射(Manual Mapping)2. Builder模式3. 工具类辅助映

SpringBoot请求参数接收控制指南分享

《SpringBoot请求参数接收控制指南分享》:本文主要介绍SpringBoot请求参数接收控制指南,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录Spring Boot 请求参数接收控制指南1. 概述2. 有注解时参数接收方式对比3. 无注解时接收参数默认位置

SpringBoot基于配置实现短信服务策略的动态切换

《SpringBoot基于配置实现短信服务策略的动态切换》这篇文章主要为大家详细介绍了SpringBoot在接入多个短信服务商(如阿里云、腾讯云、华为云)后,如何根据配置或环境切换使用不同的服务商,需... 目录目标功能示例配置(application.yml)配置类绑定短信发送策略接口示例:阿里云 & 腾

SpringBoot项目中报错The field screenShot exceeds its maximum permitted size of 1048576 bytes.的问题及解决

《SpringBoot项目中报错ThefieldscreenShotexceedsitsmaximumpermittedsizeof1048576bytes.的问题及解决》这篇文章... 目录项目场景问题描述原因分析解决方案总结项目场景javascript提示:项目相关背景:项目场景:基于Spring

Spring Boot 整合 SSE的高级实践(Server-Sent Events)

《SpringBoot整合SSE的高级实践(Server-SentEvents)》SSE(Server-SentEvents)是一种基于HTTP协议的单向通信机制,允许服务器向浏览器持续发送实... 目录1、简述2、Spring Boot 中的SSE实现2.1 添加依赖2.2 实现后端接口2.3 配置超时时

解决Maven项目idea找不到本地仓库jar包问题以及使用mvn install:install-file

《解决Maven项目idea找不到本地仓库jar包问题以及使用mvninstall:install-file》:本文主要介绍解决Maven项目idea找不到本地仓库jar包问题以及使用mvnin... 目录Maven项目idea找不到本地仓库jar包以及使用mvn install:install-file基

Spring Boot读取配置文件的五种方式小结

《SpringBoot读取配置文件的五种方式小结》SpringBoot提供了灵活多样的方式来读取配置文件,这篇文章为大家介绍了5种常见的读取方式,文中的示例代码简洁易懂,大家可以根据自己的需要进... 目录1. 配置文件位置与加载顺序2. 读取配置文件的方式汇总方式一:使用 @Value 注解读取配置方式二

一文详解Java异常处理你都了解哪些知识

《一文详解Java异常处理你都了解哪些知识》:本文主要介绍Java异常处理的相关资料,包括异常的分类、捕获和处理异常的语法、常见的异常类型以及自定义异常的实现,文中通过代码介绍的非常详细,需要的朋... 目录前言一、什么是异常二、异常的分类2.1 受检异常2.2 非受检异常三、异常处理的语法3.1 try-