如何使用 Gradle 访问 Java 项目中的资源？

我有一个JavaFX https://en.wikipedia.org/wiki/JavaFX我正在使用 Gradle 文件构建项目，并且我正在 IntelliJ 中编写所有内容。在其中，我使用javafx.scene.media.Media and javafx.scene.media.MediaPlayer播放一些音乐。

public SoundPlayer(String filename) {
    String soundLocation = "\\src\\main\\resources\\sound\\" + fileName;
    String absolute = new File("").getAbsolutePath() + soundLocation;
    System.out.println(absolute);
    Media soundMedia = new Media(new File(absolute).toURI().toString());
    mediaPlayer = new MediaPlayer(soundMedia);
}

我一直在工作的项目目录是：

src/

|---主/

|---|---java/

|---|---|---声音.SoundPlayer

|---|---资源/

|---|---|---声音/

|---|---|---|---click.mp3

|---|---|---|---bgm.mp3

然而，当我去编译并将其转换为 JAR 文件时，Gradle 将目录更改为以下内容（在 JAR 文件中，顶层）：

sound/

|---SoundPlayer.class

|---点击.mp3

|---bgm.mp3

这使得它抛出一个媒体异常：媒体不可用。我尝试将文件更改为以下两个内容：

Media soundMedia = new Media(new File("sound\\" + fileName).toURI().toString());

and

Media soundMedia = new Media(new File(fileName).toURI().toString());

...但我总是遇到同样的例外。这是怎么回事？

Gradle 所做的一切完全在意料之中。这src/主/java and src/主/资源目录分别存放代码和资源。 resources 文件夹包含所有非 Java 代码，如图像、声音等。

创建 JAR 文件时，资源目录的内容将按原样复制（保持包结构）。注意点击.mp3 and bgm.mp3是成员sound包裹。

因此，当您想要加载资源时，（通常）不应该使用文件路径来完成。相反，使用包结构来执行此操作。在这里，随着声音和SoundPlayer有相同的包，即sound，您可以使用SoundPlayer类来加载资源，如下所示：

public SoundPlayer(String filename) {
    URL resource = SoundPlayer.class.getResource(filename);
    Media soundMedia = new Media(resource.toExternalForm());
    mediaPlayer = new MediaPlayer(soundMedia);
}

来自Java文档

公共字符串 toExternalForm() 构造此 URL 的字符串表示形式。该字符串是通过调用该对象的流协议处理程序的 toExternalForm 方法创建的。

本质上，toExternalForm() 函数为给定资源创建适当的 URL。

这是一个完整的例子。

// build.gradle
apply plugin: 'java'
apply plugin: 'application'

sourceCompatibility = '1.8'
[compileJava, compileTestJava]*.options*.encoding = 'UTF-8'


mainClassName = 'sound.Main'

repositories {
    mavenCentral()
}

dependencies {
    testCompile group: 'junit', name: 'junit', version: '4.10'
}

jar { manifest { attributes 'Main-Class': 'sound.Main' } }

和修改后的 SoundPlayer

//sound.SoundPlayer
package sound;

import java.net.URL;
import javafx.scene.media.Media;
import javafx.scene.media.MediaPlayer;

public class SoundPlayer {

    private MediaPlayer mediaPlayer;

    public SoundPlayer(String filename) {
        URL resource = SoundPlayer.class.getResource(filename);
        Media soundMedia = new Media(resource.toExternalForm());
        mediaPlayer = new MediaPlayer(soundMedia);
    }

    public void play(){
        mediaPlayer.play();
    }
}

和使用 SoundPlayer 的 Main 类

// sound.Main
// This class does not actually create a JavaFX UI. Instead, it is
// only creating a JavaFX application to use Media
package sound;

import javafx.application.Application;
import javafx.stage.Stage;

/**
 *
 * @author aga53
 */
public class Main extends Application{

    /**
     * @param args the command line arguments
     */
    public static void main(String[] args) {
        launch(args);
    }

    @Override
    public void start(Stage primaryStage) throws Exception {
        SoundPlayer s = new SoundPlayer("test.mp3");
        System.out.println("Hello World");
        s.play();
    }

}