Jar包中读取资源文件非法参数异常：解决之道

2024-03-24 07:36:26

解决Jar包中读取资源文件时的非法参数异常

问题

各位亲爱的读者，你们在从Java中的Jar包读取资源文件时是否遇到过讨厌的 IllegalArgumentException: URI is not hierarchical 异常？当在开发环境中一切正常，但导出为Jar包后却突然出现这个问题，真是让人抓狂。别担心，今天我就来分享一种解决此问题的简单方法。

原因分析

该异常通常出现在URI中缺少层次结构时，比如不包含分隔符（如“/”）。File类的构造函数要求URI为分层URI。在开发环境中，类路径包含文件所在的文件夹，所以 getClass().getResource("/file.txt") 正常工作。然而，导出为Jar包时，类路径只包含Jar包本身，文件所在的文件夹就不存在了。因此，“/file.txt”不再是有效的URI，因为它不包含任何层次结构。

解决方法

现在，让我们来解决这个问题。有两种方法可以确保URI在导出为Jar包后仍然有效：

1. 使用绝对路径

File file = new File(getClass().getResource("/folder/file.txt").toURI());

这种方法更通用，因为它不需要修改Jar包结构。

2. 添加资源文件到Jar包根目录

File file = new File(getClass().getResource("/file.txt").toURI());

这种方法更简单，但需要修改Jar包结构。

代码示例

为了更好地理解，让我们看一个代码示例：

// 方法 1：使用绝对路径
File file = new File(getClass().getResource("/folder/file.txt").toURI());

// 方法 2：将资源文件添加到Jar包根目录
File file = new File(getClass().getResource("/file.txt").toURI());