如何读取 jar 外部的文件 // getResource 问题与 pom 中的 mysql 依赖关系

how to read a file external to the jar // getResource issue with mysql dependency in pom

我想在我的 jar 之外有一个配置文件。 配置将被读取并且程序应该相应地运行。 我尝试使用:

this.getClass().getResource( file_name );

但是我 运行 遇到了 pom 依赖项的问题。下面的例子说明了这个问题。

src文件结构为:

    main
    ├── java
    │   └── com
    │       └── company
    │             └── App.java
    └── resources
        └── external
            └── input
                 └── external_file.txt

目标文件结构是:

target/
├── classes
│   └── com
│       └── company
│             └── App.class
├── resources
│    └── input
│         └── external_file.txt
│
└── test-file.jar

完整代码:

package com.company;

import java.io.*;
import java.net.URL;

/**
 * Hello world!
 *
 */
public class App 
{
    public void run() {
        //the module options are extended to add the resources folder to the classpath in intelliJ
        String file_name = File.separator + "input" + File.separator + "external_file.txt";
        System.out.println( "file name: " + file_name );
        URL propertiesFileUrl = this.getClass().getResource( file_name );
        String path = propertiesFileUrl.getPath();
        System.out.println( "path: " + path );
        File test_file =  new File( path );

        try{
            FileReader test_fileReader = new FileReader( test_file );
            BufferedReader test_bufferedReader = new BufferedReader( test_fileReader );
            String test_line = test_bufferedReader.readLine();
            test_fileReader.close();
            System.out.println( "First line: " + test_line );
        } catch(FileNotFoundException e){
            e.printStackTrace();
        } catch(IOException e){
            e.printStackTrace();
        }
    }

    public static void main( String[] args )
    {
        new App().run();
    }
}

如果我使用以下 pom.xml

,此代码工作正常
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.company</groupId>
    <artifactId>test-file</artifactId>
    <packaging>jar</packaging>
    <version>1.0-SNAPSHOT</version>
    <name>test-file</name>
    <url>http://maven.apache.org</url>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>8</source>
                    <target>8</target>
                </configuration>
            </plugin>
            <plugin>
                <artifactId>maven-assembly-plugin</artifactId>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <archive>
                        <manifest>
                            <mainClass>com.company.App</mainClass>
                        </manifest>
                        <manifestEntries>
                            <Class-Path>resources/</Class-Path>
                        </manifestEntries>

                    </archive>
                    <descriptorRefs>
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>

                </configuration>
            </plugin>
            <plugin>
                <artifactId>maven-resources-plugin</artifactId>
                <version>3.1.0</version>
                <executions>
                    <execution>
                    <id>copy-resources</id>
                    <!-- here the phase you need -->
                    <phase>validate</phase>
                    <goals>
                        <goal>copy-resources</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${basedir}/target/resources</outputDirectory>
                        <resources>
                            <resource>
                                <directory>${project.basedir}/src/main/resources/external</directory>
                                <filtering>true</filtering>
                            </resource>
                        </resources>
                    </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
        <resources>
            <resource>
                <directory>${project.basedir}/src/main/resources</directory>
                <excludes>
                    <exclude>external/</exclude>
                </excludes>
            </resource>
        </resources>
    </build>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    </project>

我可以使用 IntelliJ 执行代码,因为我在我的模块设置中添加了 target/resources 文件夹作为依赖项。 我也可以从命令行执行 jar 并且输出符合预期:

file name: /input/external_file.txt
path: /Users/amin/Work/testjar/resources/input/external_file.txt
First line: test text!!!

但是一旦我将以下依赖项添加到我的 pom.xml

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.40</version>
            <scope>compile</scope>
        </dependency>

,重新导入并重建一切,我仍然可以从 IntelliJ 成功执行程序,但是从命令行执行的 jar 将输出:

file name: /input/external_file.txt
Exception in thread "main" java.lang.NullPointerException
    at com.company.App.run(App.java:19)
    at com.company.App.main(App.java:39)

以我的理解力来看,这根本说不通 注意:mysql 不是唯一的软件包,它会将结果更改为无效。

资源是 .jar 文件中的一个条目。您不能将其称为文件,因为它不是一个单独的文件。资源应该用getResource或getResourceAsStream读取,而文件不应该用这些方法读取,因为getResource不是用来读取文件的,而是用来读取资源的。

注意 getResource 和 getResourceAsStream 的参数 不是文件名。 它是一个相对的 URL 表示嵌入的资源。这意味着它不能使用 File.separator——URL 总是 在所有平台上使用正斜杠 (/)。

您没有显示您的 test-file.jar 是否实际包含 external_file.txt。您的标题表明 external_file.txt 实际上不在 .jar 中。如果是这种情况,您不应该全部使用 getResource,而应该使用 Files class:

try (BufferedReader reader = Files.newBufferedReader(
        Paths.get(System.getProperty("user.home"),
            "projects", "app", "target", "resources",
            "external", "input", "external_file.txt")) {

    String test_line = reader.readLine();
    System.out.println( "First line: " + test_line ); 
}

(注意 try-with-resources statement 会自动关闭 Reader。)

但是……我不确定您是否真的希望该文件是外部文件。将放置在项目 resources 目录中的文件在构建时打包到 .jar 文件中是一种长期存在的惯例。你检查过test-file.jar的内容,验证里面有没有input/external_file.txt吗?

如果是,您应该使用 getResourceAsStream 读取它:

try (BufferedReader reader = new BufferedReader(
        new InputStreamReader(
            App.class.getResourceAsStream("/input/external_file.txt"))) {

    String test_line = reader.readLine();
    System.out.println( "First line: " + test_line ); 
}

旁注:URL 的 getPath() 方法不会将 URL 转换为有效的文件名。它只是 return 的 URL 的路径部分,这决不能保证是一个有效的文件名。例如:文件 C:\Users\John Doe 将表示为 URL file:/C:/Users/John%20Doe,因为 space 字符不允许出现在 URL 中; getPath() 方法将 return "/C:/Users/John%20Doe".