java - 如何将资源添加到类路径

Question

如何将文件夹(例如包含 arts 的资源文件夹)添加到 netbeans 项目的类路径中？我设法通过编辑项目的 NB 生成的 jar 文件(即它的 MANIFEST.MF 文件 + 手动复制资源)手动执行此操作，但应该有一种方法可以告诉 netbeans 以及注意资源，不是吗？

文件夹结构如下所示:

/project/art/
/project/dist/lib/
/project/dist/art/
/project/dist/project.jar
/project/lib/
/project/src/

我不想将艺术品打包到 jar 里，因为我希望艺术品可以轻松交换。如果我将艺术文件夹添加到 src 文件夹，那么 NB 可以正常编译，但艺术资源最终会在 jar 中。

将 art 文件夹添加到 netbeans 项目库(属性 -> 库 -> 添加 JAR/文件夹)似乎不起作用，因为我最终得到一个错误 '...\project\art is a directory or can被阅读。不复制图书馆。这反过来甚至可以防止复制真正的库文件夹。

有什么想法吗？

最好的问候克里斯

2 根据 gpeche 的评论做出的观察:a) 与其在项目属性的“编译”选项卡中指定附加资源文件夹，不如在“运行”选项卡中指定 -> 库在 Netbeans 中似乎没有太大区别(我目前使用的是 6.9.1) .输出(以及错误)保持不变，即没有任何内容被复制:

Created dir: C:\Users\Chrisi\Desktop\vocabulary\VocabularyTrainer\dist
C:\Users\Chrisi\Desktop\vocabulary\VocabularyTrainer\art is a directory or can't be read. Not copying the libraries.
Not copying the libraries.
Building jar: C:\Users\Chrisi\Desktop\vocabulary\VocabularyTrainer\dist\VocabularyTrainer.jar

另一个有趣的方面是，在“库”面板的帮助菜单中，没有明确提及将文件夹作为库。 Netbeans 中的按钮是否有可能被错误命名，即只允许使用真正的 jar？

b) 将资源文件夹添加到库列表确实会产生影响，将另一个条目添加到 MANIFEST.MF。虽然 - 这是一个较小的问题 - 类路径条目似乎总是期望资源文件夹是库文件夹的子文件夹(例如“lib/arts”)，但主要问题是似乎缺少斜线。如前所述，在 MANIFEST.MF 中 NB 生成的条目看起来像这样的“lib/arts”(这对我不起作用)，而(手动设置)“lib/arts/”呢？!

我使用文件夹中资源的方式是这样的:

URL resource = getClass().getResource("/gui/refresh.png");
ImageIcon tmp = new ImageIcon(resource);

编辑:

基于 Tushar 的评论和 this posting我发现以下解决方案是功能性和舒适性之间可接受的权衡。

我覆盖了自动生成的“build-impl.xml”文件中的 ANT 目标，该文件在 Netbeans 项目的基本“build.xml”文件中的 MANIFEST.MF 文件中创建了类路径。进入“build.xml”文件的代码如下所示:

  <property name="art.classpath" value="art/" />

  <target name="-post-jar">
    <mkdir dir="${dist.dir}/art"/>
    <copy todir="${dist.dir}/art">
      <fileset dir="${basedir}/art">
        <!-- <exclude name="**/!source/**"/> if you want to exclude something... -->
      </fileset>
    </copy>
  </target>

  <target name="-init-macrodef-copylibs">
    <macrodef name="copylibs" uri="http://www.netbeans.org/ns/j2se-project/3">
      <element name="customize" optional="true"/>
      <sequential>
        <property location="${build.classes.dir}" name="build.classes.dir.resolved"/>
        <pathconvert property="run.classpath.without.build.classes.dir">
          <path path="${run.classpath}"/>
          <map from="${build.classes.dir.resolved}" to=""/>
        </pathconvert>
        <pathconvert pathsep=" " property="jar.classpath">
          <path path="${run.classpath.without.build.classes.dir}"/>
          <chainedmapper>
            <flattenmapper/>
            <globmapper from="*" to="lib/*"/>
          </chainedmapper>
        </pathconvert>
        <taskdef classname="org.netbeans.modules.java.j2seproject.copylibstask.CopyLibs" classpath="${libs.CopyLibs.classpath}" name="copylibs"/>
        <copylibs compress="${jar.compress}" index="${jar.index}" jarfile="${dist.jar}" manifest="${manifest.file}" runtimeclasspath="${run.classpath.without.build.classes.dir}">
          <fileset dir="${build.classes.dir}"/>
          <manifest>
            <attribute name="Class-Path" value="${jar.classpath} ${art.classpath}"/>
            <customize/>
          </manifest>
        </copylibs>
      </sequential>
    </macrodef>
  </target>

权衡是，为了在 Netbeans 中进行开发，我仍然必须将资源文件夹(例如“art”)添加到库列表中，以使项目在 Netbeans 中运行。这将导致在 MANIFEST.MF 文件('lib/art')中增加一个条目，并导致库不会自动复制到 'dist' 文件夹，并显示消息

...\art is a directory or can't be read. Not copying the libraries.
Not copying the libraries.

这种行为是 - afaik - 意图(强制所有东西都捆绑在一个 jar 里)，即使有关于它的讨论正在进行中。要制作真正的分发包，我必须从 NB 的库列表中删除资源文件夹并重建。

关于无需任何权衡的更简化设置的想法当然仍然受到欢迎。 :)

Answer 1

1. 将资源文件夹添加到类路径:

   当您清理并构建基于 NetBeans Ant 的项目时，它会在项目的根目录中创建一个 manifest.mf 文件。该文件也包含在 JAR 文件中。修改此文件并添加如下条目:

   Manifest-Version: 1.0
   X-COMMENT: Main-Class will be added automatically by build
   Class-Path: arts/  
   

   斜线在类路径中的 arts 之后很重要。

2. 在分发中包含艺术资源文件夹

   要么在构建之后将此文件夹复制到 dist 文件夹中，要么添加一个 ANT 目标以将所需的资源复制到 dist 文件夹中。

   在build.xml文件中添加如下目标:

   <target name="-post-jar">
        <mkdir dir="${dist.dir}/resources"/>
        <copy todir="${dist.dir}/resources">
            <fileset dir="${basedir}/resources" />
        </copy>
    </target>
   

3. 访问此类资源的代码:

   访问此类资源文件所需的代码如下:(这在设计时不起作用，但肯定来自 JAR 文件)

   // pay attention to relative path
   URL resource = ClassLoader.getSystemResource("gui/refresh.png"); 
   ImageIcon tmp = new ImageIcon(resource);
   

   注意:位于项目根目录中的文件 manifest.mf 和 build.xml 可以从 NetBeans IDE 的文件面板访问