Как сообщить Java правильный путь к файлу в JAR-файле?

Следует помнить, что ресурсы — это не то же самое, что файлы, несмотря на то, что они кажутся очень похожими, особенно перед упаковкой приложения. Когда вы упаковываете приложение, эти файлы ресурсов становятся записями в JAR-файле, который, хотя и может рассматриваться как файлы, не может быть доступен так же, как файлы. В частности, java.io.File API не понимает, как читать эти записи. Однако вы можете получить доступ к этим записям через URL, возвращаемый Class#getResource(String), или InputStream, возвращаемый Class#getResourceAsStream(String). Обратите внимание, что последний в основном просто находит URL и, если он существует, вызывает URL#openStream(). Причина, по которой вы можете получить доступ к записям JAR (т.е. ресурсам) с помощью URL, связана с JarURLConnection и связанными классами; Я не буду вдаваться в подробности о том, как Java обрабатывает URL-адреса, поскольку это выходит за рамки этого ответа.

Теперь, поскольку вы пытаетесь отобразить изображение в JavaFX, я предполагаю, что вы используете класс Image. Есть три основных способа сообщить Image, где находится ресурс изображения.

1. Используйте Image#<init>(String), если URL-адрес аргумента не имеет схемы. В этом случае класс будет рассматривать URL-адрес как путь относительно корня пути к классам и попытается соответствующим образом получить доступ к изображению. По сути, аргумент — это тот же аргумент, который вы бы дали Class#getResource(String), за исключением того, что путь должен быть абсолютным (то есть не относительным ни к какому классу). Это поведение задокументировано классом Image:

   All URLs supported by URL can be passed to the constructor. If the passed string is not a valid URL, but a path instead, the Image is searched on the classpath in that case.

   Примечание. Если вы используете модули, то при использовании этой опции в игру вступает инкапсуляция ресурсов. См. Ошибка GitHub № 441.

2. Используйте тот же конструктор, что и выше, но передайте действительный URL-адрес (т.е. он имеет схему). При использовании ресурса вы можете просто преобразовать URL, возвращаемый Class#getResource(Sring), в String, используя URL#toExternalForm().

   Image image = new Image(getClass().getResource(...).toExternalForm());
   

   Примечание. Вы также можете использовать URL#toString(), который возвращает то же значение.

3. Используйте Image#<init>(InputStream). Здесь вы можете использовать Class#getResourceAsStream(String). Не забудьте закрыть InputStream, когда закончите с этим.

   try (InputStream is = getClass().getResourceAsStream(...)) {
       Image image = new Image(is);
   }
   

Все это предполагает, что ресурсы были правильно упакованы в ваш файл JAR, когда вы его создавали. Если это не так, сначала следуйте совету Хосе Переды в комментариях к вопросу.

Обратите внимание, что доступ к записям файла ZIP/JAR можно получить с помощью java.util.zip.* API, java.util.jar.* API или Java NIO ZipFileSystemProvider. Каждый из них, особенно последний, позволяет вам получить доступ к записям ZIP/JAR-файла, аналогичного реальным файлам, потому что они разработаны специально для этого. Однако при использовании ресурсов в приложении вы должны придерживаться Class#getResource(String) и связанных с ним методов.