深入理解Java可执行JAR文件

引言
JAR文件简介
创建JAR文件
- 使用JDK的jar工具
- 使用IDE创建JAR文件
指定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>