如何给 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中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流(parallelStream)的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS

Java中Redisson 的原理深度解析

《Java中Redisson的原理深度解析》Redisson是一个高性能的Redis客户端,它通过将Redis数据结构映射为Java对象和分布式对象,实现了在Java应用中方便地使用Redis,本文... 目录前言一、核心设计理念二、核心架构与通信层1. 基于 Netty 的异步非阻塞通信2. 编解码器三、

SpringBoot基于注解实现数据库字段回填的完整方案

《SpringBoot基于注解实现数据库字段回填的完整方案》这篇文章主要为大家详细介绍了SpringBoot如何基于注解实现数据库字段回填的相关方法,文中的示例代码讲解详细,感兴趣的小伙伴可以了解... 目录数据库表pom.XMLRelationFieldRelationFieldMapping基础的一些代

一篇文章彻底搞懂macOS如何决定java环境

《一篇文章彻底搞懂macOS如何决定java环境》MacOS作为一个功能强大的操作系统,为开发者提供了丰富的开发工具和框架,下面:本文主要介绍macOS如何决定java环境的相关资料,文中通过代码... 目录方法一:使用 which命令方法二:使用 Java_home工具(Apple 官方推荐)那问题来了,

Java HashMap的底层实现原理深度解析

《JavaHashMap的底层实现原理深度解析》HashMap基于数组+链表+红黑树结构,通过哈希算法和扩容机制优化性能,负载因子与树化阈值平衡效率,是Java开发必备的高效数据结构,本文给大家介绍... 目录一、概述:HashMap的宏观结构二、核心数据结构解析1. 数组(桶数组)2. 链表节点(Node

Java AOP面向切面编程的概念和实现方式

《JavaAOP面向切面编程的概念和实现方式》AOP是面向切面编程,通过动态代理将横切关注点(如日志、事务)与核心业务逻辑分离,提升代码复用性和可维护性,本文给大家介绍JavaAOP面向切面编程的概... 目录一、AOP 是什么?二、AOP 的核心概念与实现方式核心概念实现方式三、Spring AOP 的关

详解SpringBoot+Ehcache使用示例

《详解SpringBoot+Ehcache使用示例》本文介绍了SpringBoot中配置Ehcache、自定义get/set方式,并实际使用缓存的过程,文中通过示例代码介绍的非常详细,对大家的学习或者... 目录摘要概念内存与磁盘持久化存储:配置灵活性:编码示例引入依赖:配置ehcache.XML文件:配置

Java 虚拟线程的创建与使用深度解析

《Java虚拟线程的创建与使用深度解析》虚拟线程是Java19中以预览特性形式引入,Java21起正式发布的轻量级线程,本文给大家介绍Java虚拟线程的创建与使用,感兴趣的朋友一起看看吧... 目录一、虚拟线程简介1.1 什么是虚拟线程?1.2 为什么需要虚拟线程?二、虚拟线程与平台线程对比代码对比示例:三

Java中的.close()举例详解

《Java中的.close()举例详解》.close()方法只适用于通过window.open()打开的弹出窗口,对于浏览器的主窗口,如果没有得到用户允许是不能关闭的,:本文主要介绍Java中的.... 目录当你遇到以下三种情况时,一定要记得使用 .close():用法作用举例如何判断代码中的 input

Spring Gateway动态路由实现方案

《SpringGateway动态路由实现方案》本文主要介绍了SpringGateway动态路由实现方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随... 目录前沿何为路由RouteDefinitionRouteLocator工作流程动态路由实现尾巴前沿S