目录
- 引言
- JAR文件简介
- 创建JAR文件
- 使用JDK的
jar工具 - 使用IDE创建JAR文件
- 使用JDK的
- 指定Main-Class属性
- 在
MANIFEST.MF文件中指定 - 使用
jar工具指定
- 在
- 运行可执行JAR文件
- 在Maven项目中创建可执行JAR文件
- 配置
pom.xml - 使用
maven-jar-plugin
- 配置
- 在Gradle项目中创建可执行JAR文件
- 配置
build.gradle - 使用
application插件
- 配置
- 包含依赖库的可执行JAR文件
- 使用Maven Shade插件
- 使用Gradle Shadow插件
- 多模块项目中的可执行JAR文件
- 总结
引言
JAR文件是Java应用程序打包和分发的标准格式。特别是可执行JAR文件，它可以将Java应用程序的所有必要组件（包括类文件、资源文件和依赖库）打包在一起，使得分发和运行应用程序变得更加便捷。在本文中，我们将详细介绍创建、配置和使用可执行JAR文件的各种方法和最佳实践。
JAR文件简介
JAR文件是一种基于ZIP文件格式的归档文件，它可以包含多个Java类文件、元数据和资源文件。JAR文件可以用于：
- 打包Java类文件和相关资源。
- 分发Java应用程序或库。
- 提高下载速度和减少存储空间。
JAR文件的主要优势在于它们可以将多个文件打包成一个归档文件，简化了应用程序的分发和部署。
创建JAR文件
使用JDK的jar工具
JDK提供了一个命令行工具jar，可以用于创建和操作JAR文件。以下是创建JAR文件的基本步骤：
-
编译Java源文件：
javac MyApp.java -
创建JAR文件：
jar cvf MyApp.jar MyApp.class这里的
c表示创建新的JAR文件，v表示生成详细输出，f表示指定JAR文件名。
使用IDE创建JAR文件
大多数IDE，如Eclipse和IntelliJ IDEA，都提供了创建JAR文件的图形界面工具。以下是使用Eclipse创建JAR文件的步骤：
- 选择项目并右键点击，选择
Export...。 - 在弹出的对话框中选择
Java->JAR file。 - 指定输出路径和文件名，点击
Finish。
指定Main-Class属性
为了使JAR文件可执行，我们需要在JAR文件的MANIFEST.MF文件中指定主类（包含main方法的类）。
在MANIFEST.MF文件中指定
MANIFEST.MF文件是JAR文件中的一个特殊文件，它包含了JAR文件的元数据。以下是一个示例MANIFEST.MF文件：
Manifest-Version: 1.0
Main-Class: com.example.MyApp
使用jar工具指定
我们可以在创建JAR文件时使用jar工具的e选项指定主类：
jar cvfe MyApp.jar com.example.MyApp MyApp.class
这里的e选项用于指定主类。
运行可执行JAR文件
创建好可执行JAR文件后，可以使用以下命令运行它：
java -jar MyApp.jar
该命令会启动JAR文件中指定的主类，并执行其main方法。
在Maven项目中创建可执行JAR文件
配置pom.xml
在Maven项目中，我们可以通过配置pom.xml文件来创建可执行JAR文件。
使用maven-jar-plugin
以下是一个配置示例：
<project>
...
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>3.2.0</version>
<configuration>
<archive>
<manifest>
<mainClass>com.example.MyApp</mainClass>
</manifest>
</archive>
</configuration>
</plugin>
</plugins>
</build>
</project>
配置好后，运行以下命令生成JAR文件：
mvn package
在Gradle项目中创建可执行JAR文件
配置build.gradle
在Gradle项目中，我们可以通过配置build.gradle文件来创建可执行JAR文件。
使用application插件
以下是一个配置示例：
plugins {
id 'java'
id 'application'
}
mainClassName = 'com.example.MyApp'
jar {
manifest {
attributes(
'Main-Class': mainClassName
)
}
}
配置好后，运行以下命令生成JAR文件：
gradle build
包含依赖库的可执行JAR文件
可执行JAR文件通常需要包含应用程序的依赖库。我们可以使用Maven Shade插件或Gradle Shadow插件来创建包含所有依赖库的可执行JAR文件。
使用Maven Shade插件
以下是一个Maven Shade插件的配置示例：
<project>
...
<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>
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
<mainClass>com.example.MyApp</mainClass>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
配置好后，运行以下命令生成包含所有依赖库的可执行JAR文件：
mvn package
使用Gradle Shadow插件
以下是一个Gradle Shadow插件的配置示例：
plugins {
id 'java'
id 'application'
id 'com.github.johnrengelman.shadow' version '6.1.0'
}
mainClassName = 'com.example.MyApp'
shadowJar {
manifest {
attributes(
'Main-Class': mainClassName
)
}
}
配置好后，运行以下命令生成包含所有依赖库的可执行JAR文件：
gradle shadowJar
多模块项目中的可执行JAR文件
在多模块项目中，我们需要确保所有模块的类文件和资源文件都包含在可执行JAR文件中。以下是一个多模块Maven项目的示例配置：
<project>
...
<modules>
<module>module1</module>
<module>module2</module>
</modules>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>3.2.0</version>
<configuration>
<archive>
<manifest>
<mainClass>com.example.MyApp</mainClass>
</manifest>
</archive>
</configuration>
</plugin>
</plugins>
</build>
</project>
在多模块项目中，确保所有子模块都已打包并包含在最终的可执行JAR文件中。
总结
本文详细介绍了
Java可执行JAR文件的创建、结构和使用方法。我们探讨了如何使用JDK的jar工具、IDE、Maven和Gradle来创建和配置可执行JAR文件，以及如何在JAR文件中包含依赖库。通过掌握这些技术，您可以更高效地打包和分发Java应用程序，简化部署流程，提升开发效率。
希望本文能帮助您深入理解Java可执行JAR文件的相关知识。如果您有任何问题或建议，欢迎在评论区留言讨论。
Happy Coding!
