Java Jar包Manifest文件自定义属性读取：常见陷阱与解决方案

Manifest-Version: 1.0
Created-By: Apache Maven
Deployments-Version: 1.2.3

import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.IOException;
import java.net.URI;
import java.net.URISyntaxException;
import java.nio.file.FileSystem;
import java.nio.file.FileSystems;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.StandardCopyOption;
import java.util.HashMap;
import java.util.Map;
import java.util.jar.JarFile;
import java.util.jar.Manifest;

public class JarManifestModifier {

    public static void main(String[] args) throws IOException, URISyntaxException {
        // 假设要修改的JAR文件路径
        File jar = new File("C:\path\to\your\auth-0.1.3.jar"); // 请替换为实际的JAR文件路径
        String testVersion = "1.2.3";

        // 确保JAR文件存在
        if (!jar.exists()) {
            System.err.println("Error: JAR file not found at " + jar.getAbsolutePath());
            return;
        }

        // 1. 修改JAR包内的Manifest文件
        Map<String, String> env = new HashMap<>();
        env.put("create", "true"); // 允许创建文件系统，如果JAR不存在则创建（此处用于打开现有JAR）

        // 挂载JAR文件系统
        try (FileSystem fileSystem = FileSystems.newFileSystem(jarFileToURI(jar), env)) {
            Path manifestPath = fileSystem.getPath("/META-INF/MANIFEST.MF");

            // 读取原始Manifest内容
            ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
            Files.copy(manifestPath, byteArrayOutputStream);

            // 构建新的Manifest内容
            StringBuilder manifestData = new StringBuilder(byteArrayOutputStream.toString().trim());

            // 确保在添加新属性之前有一个换行符，并且新属性行本身也以换行符结束
            // 这是解决问题的关键所在：新属性行后面必须有一个换行符
            manifestData.append("
"); // 确保前一行结束
            manifestData.append("Deployments-Version: ").append(testVersion).append("
"); // 新属性行及其后的换行符

            // 将修改后的Manifest内容写回JAR包
            Files.copy(new ByteArrayInputStream(manifestData.toString().getBytes()), manifestPath,
                    StandardCopyOption.REPLACE_EXISTING);

            System.out.println("Manifest file updated successfully.");
        } catch (Exception e) {
            System.err.println("Error updating Manifest: " + e.getMessage());
            e.printStackTrace();
            return;
        }

        // 2. 验证并读取修改后的Manifest属性
        System.out.println("
Attempting to read custom attribute from the modified JAR:");
        try (JarFile jarFile = new JarFile(jar)) {
            Manifest manifest = jarFile.getManifest();
            if (manifest != null) {
                String deploymentVersion = manifest.getMainAttributes().getValue("Deployments-Version");
                System.out.println("Deployments-Version: " + deploymentVersion);
                if (testVersion.equals(deploymentVersion)) {
                    System.out.println("Custom attribute read successfully!");
                } else {
                    System.out.println("Custom attribute not read correctly or value mismatch.");
                }
            } else {
                System.out.println("Manifest not found in the JAR.");
            }
        } catch (IOException e) {
            System.err.println("Error reading JAR file: " + e.getMessage());
            e.printStackTrace();
        }
    }

    // 辅助方法：将File对象转换为JAR文件系统URI
    // 来源于java.io.File，并进行了一些修改以适应JAR文件系统URI格式
    private static URI jarFileToURI(File jarFile) throws URISyntaxException {
        String sp = slashify(jarFile.getAbsoluteFile().getPath(), false);
        if (sp.startsWith("//"))
            sp = "//" + sp;
        return new URI("jar:file", null, sp, null);
    }

    // 辅助方法：将路径字符串中的系统分隔符替换为斜杠，并添加前导斜杠
    // 来源于java.io.File
    private static String slashify(String path, boolean isDirectory) {
        String p = path;
        if (File.separatorChar != '/')
            p = p.replace(File.separatorChar, '/');
        if (!p.startsWith("/"))
            p = "/" + p;
        if (!p.endsWith("/") && isDirectory)
            p = p + "/";
        return p;
    }
}

manifestData.append("
"); // 确保前一行结束，如果Manifest文件末尾没有换行符，此行会补上
manifestData.append("Deployments-Version: ").append(testVersion).append("
"); // 新属性行及其后的换行符