Java支持库(1.5-0)

添加时间:2007-11-08 原文发表:2007-11-08 人气:133

Java支持库(1.5-0).zip
下载: zip 文件

支持库名称及版本：Java支持库（1.5#0版）
逆@风@者
所支持语言：中文(大陆)
本支持库使易语言具备了访问Java类库的能力。“Java虚拟机”和“Java本地接口”是本支持库中最重要的两个数据类型。由“Java虚拟机”负责真实Java虚拟机的生命周期管理，而“Java本地接口”则提供Java类库的访问接口。使用时，可直接通过“Java本地接口”的各类方法访问Java类库（即与“Java虚拟机”通信），由支持库本身自动完成“Java虚拟机”的创建和销毁。如果需要特别指定“用户类路径”或“本地库路径”，则必需在使用“Java本地接口”之前显式调用“Java虚拟机.创建()”方法创建Java虚拟机，以传入相关路径参数。
本支持库要求目标机器中已安装“Java运行时环境”-Java Runtime Environment（JRE）。如果在没有配置好Java环境的情况下使用本支持库，所有对象方法都将返回空值（假，0，“”）。
本支持库安装后，将自动在易语言主菜单中添加一项工具菜单，[工具]-[JavaLib：Java类型签名查询]。这是一个查询“Java 类型签名（Type Signature）”的实用工具。
本库为一般支持库，需要易系统3.7版本的支持，需要系统核心支持库3.7版本的支持，提供了3种库定义数据类型，提供了66种命令，提供了1个库定义常量。
操作系统需求： Windows

测试函数() ----
创建() 创建JAVA虚拟机，并同时设置“用户类路径(classpath)”和“本地库路径(librarypath)”。如果不需要特别指定“用户类路径”或“本地库路径”，不必显式调用本方法，“Java虚拟机”会在必要的时机（进入对象作用域时）自动创建。成功返回“真”，失败返回“假”。
销毁() 销毁已创建的JAVA虚拟机。不必显式调用本方法，“Java虚拟机”会在必要的时机（退出对象作用域时）自动销毁。
连接() 将当前线程连接到Java虚拟机。试图连接已经连接的线程将不执行任何操作。本地线程不能同时连接到两个Java虚拟机上。成功返回“真”，失败返回“假”。
断开() 断开当前线程与Java虚拟机之间的连接，释放该线程占用的所有Java监视程序，通知所有等待该线程终止的Java线程。主线程（即创建Java虚拟机的线程）不能使用本方法断开与虚拟机之间的连接，而必须调用“销毁()”方法来卸载整个虚拟机。成功返回“真”，失败返回“假”。
取版本() 取Java本地接口环境的当前版本。返回的文本格式为“A.B”，A、B均为数字，分别表示主、次版本号。
取次版本() 返回Java本地接口环境的次版本号。
加载类() 根据类名称加载指定的Java类。它将搜索由classpath环境变量中指定的目录和jar文件，以及调用“Java虚拟机.创建()”方法时指定的“用户类路径”和“本地库路径”。返回加载后的Java类标志符。如果出错则返回0。
字节集加载类() 从包含原始类数据(.class文件内容)的字节集中加载类，返回加载后的Java类标志符。如果出错则返回0。JNI不允许重复加载同一个类。
取父类() 取指定类的父类（或超类，SuperClass）。返回父类标志符，失败返回0。
分配对象() 分配指定Java类的新对象而不调用该类的任何构造函数。返回分配后的对象标志符，失败返回0。
创建对象() 创建Java对象。返回创建后的对象标志符，失败返回0。
取对象类() 返回“对象所属类”的类标志符，失败返回0。
是否为类实例() 判断指定对象是否为指定类的实例。是则返回“真”，否则返回“假”。
是否相同() 判断两个变量是否引用同一Java对象。是则返回“真”，否则返回“假”。注意：如果两个参数标志符有其一为0，必将返回“假”（这一点与JNI不同）。
可否强制转换() 判断参数一（“将被转换的类”）的对象是否可安全地强制转换为参数二（“将被转换到的类”）。以下情况下将返回“真”：第一及第二个类参数引用同一个 Java 类；第一个类是第二个类的子类；第二个类是第一个类的某个接口。
创建全局引用() 创建指定对象的新全局引用。返回创建后的全局引用对象标志符，失败返回0。全局引用需要通过调用“销毁全局引用()”方法来销毁。
销毁全局引用() 销毁由参数所指定的全局引用对象。成功返回“真”，失败返回“假”。
销毁局部引用() 销毁由参数所指定的局部引用对象。成功返回“真”，失败返回“假”。
取成员标志符() 返回类的实例成员（非静态成员）的成员标志符，该成员由其名称及签名指定。失败返回0。本方法可自动将未初始化的类初始化。本方法不能用于获取数组的长度，应调用“取数组长度()”方法。调用“取成员()”“置成员()”系列方法时都将用到本方法返回的成员标志符。
取成员() 取对象成员的值，结果存到第三个参数“结果”中。成功返回“真”，失败返回“假”。
置成员() 设置对象成员的值。成功返回“真”，失败返回“假”。
取对象成员() 取对象成员的值，取出的是一个对象标志符，结果存到第三个参数“结果”中。成功返回“真”，失败返回“假”。
置对象成员() 设置对象成员的值。成功返回“真”，失败返回“假”。
取静态成员标志符() 返回类的静态成员(static Field)的成员标志符，该成员由其名称及签名指定。失败返回0。本方法可自动将未初始化的类初始化。调用“取静态成员()”“置静态成员()”系列方法时都将用到本方法返回的静态成员标志符。
取静态成员() 取对象静态成员的值，取出的是一个对象标志符，结果存到第三个参数“结果”中。成功返回“真”，失败返回“假”。
置静态成员() 设置对象静态成员的值。成功返回“真”，失败返回“假”。
取静态对象成员() 取对象静态成员的值，结果存到第三个参数“结果”中。成功返回“真”，失败返回“假”。
置静态对象成员() 设置对象静态成员的值。成功返回“真”，失败返回“假”。
取方法标志符() 返回类或接口实例方法（非静态方法）的方法标志符，该方法由其名称及签名指定。失败返回0。方法可在参数“类标志符”所指定的类的超类中定义。本方法可自动将未初始化的类初始化。要获得构造函数的方法标志符，应将<init>作为方法名，同时将void (V)作为返回类型。调用“[非虚拟][对象/空]方法()”系列方法时都将用到本方法返回的方法标志符。
方法() 调用对象的具有基本数据类型返回值方法。调用成功返回“真”，失败返回“假”。
对象方法() 调用对象的具有对象型返回值的方法。调用成功返回“真”，失败返回“假”。
空方法() 调用对象的没有返回值的方法。调用成功返回“真”，失败返回“假”。
非虚拟方法() 根据指定的类和方法标志符调用某对象的具有基本数据类型返回值的实例（非静态）方法。调用成功返回“真”，失败返回“假”。
非虚拟对象方法() 根据指定的类和方法标志符调用某对象的具有对象类型返回值的实例（非静态）方法。调用成功返回“真”，失败返回“假”。
非虚拟空方法() 根据指定的类和方法标志符调用某对象的没有返回值的实例（非静态）方法。调用成功返回“真”，失败返回“假”。
取静态方法标志符() 取指定类的静态方法(static Method)的方法标志符，该方法由其名称和签名指定。失败返回0。本方法可自动将未初始化的类初始化。调用“静态[对象/空]方法()”系列方法时都将用到本方法返回的静态方法标志符。
静态方法() 调用类的具有基本数据类型返回值静态方法。调用成功返回“真”，失败返回“假”。
静态对象方法() 调用类的具有对象型返回值的静态方法。调用成功返回“真”，失败返回“假”。
静态空方法() 调用类的静态无返回值方法，即static void方法。调用成功返回“真”，失败返回“假”。
创建字符串() 使用易语言文本构造新的java.lang.String对象。返回创建后的字符串对象标志符，失败返回0。
取字符串长度() 返回Java字符串的长度（Unicode字符数），数字、字母、汉字等都被当作一个字符。失败返回0。
取字符串文本() 返回与指定Java字符串相对应的易语言文本。
释放字符串() 释放由“取字符串文本()”方法所返回的文本。成功返回“真”，失败返回“假”。注：内存释放由JAVA虚拟机负责，用户不必介入，故通常忽略本方法的返回值。
创建UTF字符串() 使用易语言文本(UTF-8格式)构造新的java.lang.String对象，返回创建后的字符串对象标志符。失败返回0。
取UTF字符串长度() 返回指定UTF字符串的长度，以字节(byte)为单位。
取UTF字符串文本() 返回与指定Java字符串相对应的易语言文本。
释放UTF字符串() 释放由“取UTF字符串文本()”方法所返回的文本。成功返回“真”，失败返回“假”。注：内存释放由JAVA虚拟机负责，用户不必介入，故通常忽略本方法的返回值。
取数组长度() 返回指定Java数组的长度。
创建数组() 返回创建后的数组标志符。失败返回0。
取数组成员() 取出指定数组中指定成员并存放到本方法的第三个参数中。成功返回“真”，失败返回“假”。
置数组成员() 成功返回“真”，失败返回“假”。
创建对象数组() 创建一个可以容纳Java对象(object)的数组。返回创建后的数组标志符，失败返回0。
取对象数组成员() 取指定“对象数组”中的某一个成员，由参数“成员索引”指定取该数组的哪一个成员。返回该成员的对象标志符，失败返回0。
置对象数组成员() 为Java“对象数组”的指定成员赋值。
抛出异常() 向Java虚拟机抛出一个已存在的异常对象。成功返回“真”，失败返回“假”。
抛出新异常() 创建一个异常对象，并向Java虚拟机抛出该异常对象。成功返回“真”，失败返回“假”。
是否有异常() 判断当前是否有正被抛出的异常对象。在调用“清除异常()”方法或Java代码处理该异常前，异常将始终保持抛出状态。如果有异常发生，返回“真”；否则返回“假”。
取异常对象() 返回当前正被抛出的异常对象。在调用“清除异常()”方法或Java代码处理该异常前，异常将始终保持抛出状态。如果有异常发生，返回该异常对象标志符；如果没有异常发生，返回0。
输出异常() 将异常及堆栈的回溯信息文本输出到系统标准错误输出设备（例如stderr）。执行后将清除当前异常对象。成功返回“真”，失败返回“假”。本方法主要用于调试。
取异常文本() 返回当前异常对象的描述文本。执行后将清除当前异常对象。
清除异常() 清除当前抛出的所有异常。如果当前无异常，则不做任何操作。成功返回“真”，失败返回“假”。
致命错误() 抛出致命错误并且不希望Java虚拟机进行修复。成功返回“真”，失败返回“假”。
进入监视() 进入与指定对象所引用的基本Java对象相关联的监视程序。成功返回“真”，失败返回“假”。
每个Java对象都有一个相关联的监视程序。如果当前线程已经拥有与指定对象相关联的监视程序，它将使指示该线程进入监视程序次数的监视程序计数器增1。如果与指定对象相关联的监视程序并非由某个线程所拥有，则当前线程将变为该监视程序的所有者，同时将该监视程序的计数器设置为1。如果另一个线程已拥有与指定对象关联的监视程序，则在监视程序被释放前当前线程将处于等待状态。监视程序被释放后，当前线程将尝试重新获得所有权。
退出监视() 当前线程必须是与指定对象所引用的基本Java对象相关联的监视程序的所有者。线程将使指示进入监视程序次数的计数器减1。如果计数器的值变为0，当前线程释放监视程序。成功返回“真”，失败返回“假”。
确认销毁JVM() 如果尚未销毁已创建的JAVA虚拟机，则销毁之。

• DirectX3D支持库(1.2-2)