Java 多文件编译打包成 JAR 文件详解

简介

在 Java 开发中，我们常常会有多个 Java 源文件需要编译并打包成一个可执行的或者可复用的 JAR（Java Archive）文件。将多个 Java 文件编译打包成 JAR 文件有助于代码的组织、分发和部署。本文将详细介绍 Java 多文件编译打包成 JAR 文件的基础概念、使用方法、常见实践以及最佳实践。

基础概念

Java 源文件

Java 源文件是以 .java 为扩展名的文本文件，其中包含 Java 代码。一个 Java 项目通常由多个 Java 源文件组成，这些文件可以相互引用和调用。

编译

编译是将 Java 源文件（.java）转换为字节码文件（.class）的过程。Java 编译器（javac）会检查源文件中的语法错误，并生成对应的字节码文件。

JAR 文件

JAR 文件是一种归档文件，它将多个字节码文件（.class）和其他资源文件（如配置文件、图片等）打包成一个单一的文件。JAR 文件可以包含一个或多个 Java 类，也可以包含可执行的 Java 程序。

使用方法

步骤 1：编写 Java 源文件

首先，我们需要编写多个 Java 源文件。以下是两个简单的示例文件：

Hello.java

public class Hello {
    public static void main(String[] args) {
        World world = new World();
        System.out.println("Hello, " + world.getMessage());
    }
}

World.java

public class World {
    public String getMessage() {
        return "World!";
    }
}

步骤 2：编译 Java 源文件

使用 javac 命令编译所有的 Java 源文件。在命令行中执行以下命令：

javac Hello.java World.java

这将在当前目录下生成 Hello.class 和 World.class 两个字节码文件。

步骤 3：创建清单文件（可选）

如果要创建可执行的 JAR 文件，需要创建一个清单文件（Manifest.txt），指定程序的入口点。清单文件的内容如下：

Main-Class: Hello

这里的 Main-Class 指定了程序的入口类。

步骤 4：打包成 JAR 文件

使用 jar 命令将编译后的字节码文件打包成 JAR 文件。

创建普通 JAR 文件

jar cf myproject.jar Hello.class World.class

c：创建新的 JAR 文件
f：指定 JAR 文件的名称

创建可执行 JAR 文件

jar cfm myproject.jar Manifest.txt Hello.class World.class

m：指定清单文件

步骤 5：运行 JAR 文件

运行普通 JAR 文件

java -cp myproject.jar Hello

-cp：指定类路径

运行可执行 JAR 文件

java -jar myproject.jar

常见实践

编译整个目录下的 Java 文件

如果项目中的 Java 源文件分布在多个目录下，可以使用通配符来编译整个目录下的文件：

javac -d . src/**/*.java

-d：指定编译后的字节码文件的输出目录

打包包含资源文件的 JAR 文件

除了字节码文件，JAR 文件还可以包含资源文件（如配置文件、图片等）。假设项目中有一个 config.properties 配置文件，将其打包到 JAR 文件中的命令如下：

jar cf myproject.jar -C src . config.properties

最佳实践

使用构建工具

对于大型项目，手动编译和打包 JAR 文件会变得非常繁琐。可以使用构建工具（如 Maven 或 Gradle）来自动化这个过程。

使用 Maven

在 pom.xml 中配置项目的依赖和打包方式：

<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>myproject</artifactId>
    <version>1.0-SNAPSHOT</version>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.2.0</version>
                <configuration>
                    <archive>
                        <manifest>
                            <mainClass>Hello</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

使用以下命令进行编译和打包：

mvn clean package

使用 Gradle

在 build.gradle 中配置项目的依赖和打包方式：

plugins {
    id 'java'
}

group 'com.example'
version '1.0-SNAPSHOT'

sourceCompatibility = 1.8

repositories {
    mavenCentral()
}

jar {
    manifest {
        attributes 'Main-Class': 'Hello'
    }
}