当java应用打包成jar文件后，使用`fileinputstream`结合`class.getclassloader().getresource(...).getfile()`加载内部资源会失败，因为jar内部资源并非文件系统路径。正确的做法是使用`class.getresourceasstream()`方法，它能直接返回一个输入流，从而确保资源在ide和jar环境中均能被正确访问。同时，应采用try-with-resources结构管理流，并明确指定字符编码，以提高代码的健壮性和可移植性。
理解JAR中资源加载的挑战
在开发Java应用程序时，我们经常需要加载存储在项目内部的资源文件，例如配置文件、图片、着色器代码等。在集成开发环境（IDE）中运行应用程序时，这些资源通常作为独立文件存在于文件系统上，因此使用FileInputStream结合Class.getClassLoader().getResource(...).getFile()来获取资源路径并创建文件输入流通常能够正常工作。
然而，当应用程序被打包成一个可执行的JAR（Java Archive）文件后，情况就发生了变化。JAR文件本质上是一个压缩包，内部的资源文件不再是操作系统可见的独立文件。getResource(...).getFile()方法旨在返回一个文件系统路径，但对于JAR内部的资源，它会返回一个指向JAR内部条目的URL，例如file:/path/to/OpenGL.jar!/engine/vs.glsl。这个URL带有!分隔符，明确指出资源位于JAR内部。此时，如果直接将这个URL的路径部分（file:/path/to/OpenGL.jar!/engine/vs.glsl）传递给FileInputStream，FileInputStream会尝试将其解析为一个真实的文件系统路径，但由于它不是一个标准的文件路径，就会导致FileNotFoundException。
简而言之，FileInputStream只能操作实际存在于文件系统中的文件，而不能直接读取JAR文件内部的资源。
正确加载JAR内部资源的方法：getResourceAsStream()
为了解决这个问题，Java提供了Class.getResourceAsStream()（或ClassLoader.getResourceAsStream()）方法。这个方法不会尝试将资源转换为文件系统路径，而是直接返回一个InputStream，允许你读取JAR内部的资源内容。这使得资源加载方式与文件系统无关，从而在IDE和打包后的JAR环境中都能保持一致性。
立即学习“Java免费学习笔记（深入）”；
getResourceAsStream()的优势：
- 跨环境兼容性： 无论资源是作为独立文件存在于文件系统，还是打包在JAR内部，getResourceAsStream()都能正常工作。
- 直接获取输入流： 它直接提供一个InputStream，省去了将URL转换为文件路径的中间步骤，避免了不必要的复杂性和潜在错误。
- 避免FileNotFoundException： 由于不再依赖文件系统路径，因此不会出现因资源不在文件系统上而导致的FileNotFoundException。
如何使用getResourceAsStream()
以下是使用getResourceAsStream()加载资源并读取其内容的正确示例：
import java.io.InputStream;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
public class Shader {
public void init() throws IOException {
String sourceVertexPath = "engine/vs.glsl"; // 相对于当前类的路径
// 或者如果资源在JAR的根目录下的imgs文件夹中
// String sourceVertexPath = "/imgs/foo.png"; // 绝对路径，以'/'开头
String sourceVertexContent;
// 使用try-with-resources确保InputStream被正确关闭
try (InputStream in = Shader.class.getResourceAsStream(sourceVertexPath)) {
if (in == null) {
// 如果资源未找到，getResourceAsStream会返回null
throw new IOException("Resource not found: " + sourceVertexPath);
}
// 读取输入流的所有字节，并指定字符编码
sourceVertexContent = new String(in.readAllBytes(), StandardCharsets.UTF_8);
} catch (IOException e) {
System.err.println("Error loading shader resource: " + sourceVertexPath);
throw e;
}
// 现在 sourceVertexContent 包含了着色器文件的内容
System.out.println("Loaded shader content:\n" + sourceVertexContent);
// ... 后续处理 ...
}
// 假设这是你的main方法或某个调用init()的地方
public static void main(String[] args) {
Shader shader = new Shader();
try {
shader.init();
} catch (IOException e) {
e.printStackTrace();
}
}
}资源路径的约定
- 相对路径： 如果资源路径不以/开头，它会被视为相对于调用getResourceAsStream()的类的包路径。例如，如果Shader类在en.toshaessential.timusengine.render包中，"vs.glsl"将会在该包内查找。"engine/vs.glsl"则会在en.toshaessential.timusengine.render.engine包内查找。
- 绝对路径： 如果资源路径以/开头，它会被视为相对于类路径的根目录（即JAR文件的根目录或项目源码目录的根目录）。例如，"/engine/vs.glsl"会在JAR的根目录下的engine文件夹中查找vs.glsl。
为了避免混淆，通常建议使用以/开头的绝对路径，这样资源查找的位置更加明确。
最佳实践与注意事项：
- try-with-resources： 始终使用Java 7引入的try-with-resources语句来处理InputStream。这能确保流在不再需要时自动关闭，有效防止资源泄漏。
- 字符编码： 在将字节数组转换为字符串时，务必指定正确的字符编码（例如StandardCharsets.UTF_8）。如果不指定，将使用平台默认编码，这可能导致在不同操作系统上出现乱码问题。
- 避免getClassLoader()： 在大多数情况下，直接使用Class.getResourceAsStream()而不是Class.getClassLoader().getResourceAsStream()是更简洁和推荐的做法。Class对象的getResourceAsStream()方法内部通常会委托给其对应的ClassLoader，但在某些复杂的类加载场景下，直接使用Class的方法可以避免一些潜在的问题。
- 空值检查： getResourceAsStream()在找不到资源时会返回null。因此，在使用返回的InputStream之前，务必进行空值检查，以避免NullPointerException。
- 资源放置： 确保资源文件正确地放置在项目的src/main/resources（Maven/Gradle项目）或与Java类文件一同打包到JAR中的相应位置。
总结
在Java应用程序中，正确加载JAR内部资源是确保应用程序在不同环境中稳定运行的关键。避免使用依赖文件系统路径的方法（如FileInputStream结合getFile()），而应优先选择Class.getResourceAsStream()。结合try-with-resources、明确的字符编码和适当的路径管理，可以构建出健壮且可移植的资源加载机制。
