A.4.1 使 Java 类可用¶

Java 通过搜索classpath（类路径）来查找类，classpath是 Java 归档文件（JAR 文件）和/或包含类文件的目录列表。在 Octave 中，classpath由以下两部分组成：

• 静态类路径（static classpath）：在 JVM 启动时初始化一次，之后无法更改。
• 动态类路径（dynamic classpath）：可以在运行时被修改。

Octave 首先搜索静态类路径，然后搜索动态类路径。因此，同时出现在静态类路径和动态类路径中的类，将会在静态类路径中被找到并从该位置加载。频繁使用或必须对所有用户都可用的类，应添加到静态类路径。静态类路径在 Java 虚拟机启动时一次性从纯文本文件 javaclasspath.txt（或历史上的 classpath.txt）的内容中填充。该文件中的每一行对应一个要添加到静态类路径的类路径。这些行可以指向包含类文件的目录，或包含完整类文件层次结构的 Java 归档文件。以 ‘#’ 或 ‘%’ 字符开头的注释行将被忽略。

javaclasspath.txt（或 classpath.txt）的搜索规则如下：

• 首先，Octave 会尝试在当前目录（启动 Octave 的目录）中寻找该文件。如果找到，则读取该文件并定义初始的静态类路径。因此，可以在"每次 Octave 调用"的基础上定义静态类路径。
• 接下来，Octave 在用户的主目录中进行搜索。如果该目录下存在 javaclasspath.txt 文件，其内容会被追加到静态类路径中（如果已有的话）。因此，可以在"每个用户"的基础上构建初始静态类路径。
• 最后，Octave 会在 Octave Java 函数所在的 m 文件目录中查找 javaclasspath.txt。该目录是函数 javaclasspath.m 所在的位置，通常类似于 OCTAVE_HOME/share/octave/OCTAVE_VERSION/m/java/。您可以通过执行以下命令找到该目录：

  which javaclasspath
  

  如果此文件存在于此处，则其内容也会附加到静态类路径。请注意，在最后一步中定义的归档文件和类目录将影响所有用户。

仅由特定脚本使用的类应放置在动态类路径中。类路径的这一部分可以在运行时使用javaaddpath和javarmpath函数进行修改。

示例：

octave> base_path = "C:/Octave/java_files";

octave> # add two JAR archives to the dynamic classpath
octave> javaaddpath ([base_path, "/someclasses.jar"]);
octave> javaaddpath ([base_path, "/moreclasses.jar"]);

octave> # check the dynamic classpath
octave> p = javaclasspath;
octave> disp (p{1});
C:/Octave/java_files/someclasses.jar
octave> disp (p{2});
C:/Octave/java_files/moreclasses.jar

octave> # remove the first element from the classpath
octave> javarmpath ([base_path, "/someclasses.jar"]);
octave> p = javaclasspath;
octave> disp (p{1});
C:/Octave/java_files/moreclasses.jar

octave> # provoke an error
octave> disp (p{2});
error: A(I): Index exceeds matrix dimension.

另一种仅为您的用户账户将文件添加到动态类路径的方法是使用存储在主目录中的 .octaverc 文件。每次启动 Octave 新实例时，都会执行此文件中的所有 Octave 命令。以下示例将 octave 目录添加到 Octave 的搜索路径，并将该目录中的 myclasses.jar 归档文件添加到 Java 搜索路径。

# contents of .octaverc:
addpath ("~/octave");
javaaddpath ("~/octave/myclasses.jar");