Runtime类详解

2018-01-12 11:13:02来源:oschina作者:时光流转人点击

分享

前言:Java的类库日益庞大,所包含的类和接口也不计其数。但其中有一些非常重要的类和接口,是Java类库中的核心部分。常见的有String、Object、Class、Collection、ClassLoader、Runtime、Process...,熟悉这些类是学好Java的基础。而这些类一般不容易理解,需要做深入的研究和实践才能掌握。下面是我对这些类理解和使用的一些总结。欢迎你在阅读后将你宝贵的意见和读后感留下!

一、概述Runtime类封装了运行时的环境。每个 Java 应用程序都有一个 Runtime 类实例,使应用程序能够与其运行的环境相连接。一般不能实例化一个Runtime对象,应用程序也不能创建自己的 Runtime 类实例,但可以通过 getRuntime 方法获取当前Runtime运行时对象的引用。一旦得到了一个当前的Runtime对象的引用,就可以调用Runtime对象的方法去控制Java虚拟机的状态和行为。当Applet和其他不被信任的代码调用任何Runtime方法时,常常会引起SecurityException异常。

二、API预览addShutdownHook(Thread hook)注册新的虚拟机来关闭挂钩。availableProcessors()向 Java 虚拟机返回可用处理器的数目。exec(String command)在单独的进程中执行指定的字符串命令。exec(String[] cmdarray)在单独的进程中执行指定命令和变量。exec(String[] cmdarray, String[] envp)在指定环境的独立进程中执行指定命令和变量。exec(String[] cmdarray, String[] envp, File dir)在指定环境和工作目录的独立进程中执行指定的命令和变量。exec(String command, String[] envp)在指定环境的单独进程中执行指定的字符串命令。exec(String command, String[] envp, File dir)在有指定环境和工作目录的独立进程中执行指定的字符串命令。exit(int status)通过启动虚拟机的关闭序列,终止当前正在运行的 Java 虚拟机。freeMemory()返回 Java 虚拟机中的空闲内存量。gc()运行垃圾回收器。InputStream getLocalizedInputStream(InputStream in)已过时。 从 JDK 1.1 开始,将本地编码字节流转换为 Unicode 字符流的首选方法是使用 InputStreamReader 和 BufferedReader 类。OutputStream getLocalizedOutputStream(OutputStream out)已过时。 从 JDK 1.1 开始,将 Unicode 字符流转换为本地编码字节流的首选方法是使用 OutputStreamWriter、BufferedWriter 和 PrintWriter 类。getRuntime()返回与当前 Java 应用程序相关的运行时对象。halt(int status)强行终止目前正在运行的 Java 虚拟机。load(String filename)加载作为动态库的指定文件名。loadLibrary(String libname)加载具有指定库名的动态库。maxMemory()返回 Java 虚拟机试图使用的最大内存量。removeShutdownHook(Thread hook)取消注册某个先前已注册的虚拟机关闭挂钩。runFinalization()运行挂起 finalization 的所有对象的终止方法。runFinalizersOnExit(value)已过时。 此方法本身具有不安全性。它可能对正在使用的对象调用终结方法,而其他线程正在操作这些对象,从而导致不正确的行为或死锁。totalMemory()返回 Java 虚拟机中的内存总量。traceInstructions(on)启用/禁用指令跟踪。traceMethodCalls(on)启用/禁用方法调用跟踪。

三、常见的应用


1、内存管理: Java提供了无用单元自动收集机制。通过totalMemory()和freeMemory()方法可以知道对象的堆内存有多大,还剩多少。 Java会周期性的回收垃圾对象(未使用的对象),以便释放内存空间。但是如果想先于收集器的下一次指定周期来收集废弃的对象,可以通过调用gc()方法来根据需要运行无用单元收集器。一个很好的试验方法是先调用gc()方法,然后调用freeMemory()方法来查看基本的内存使用情况,接着执行代码,然后再次调用freeMemory()方法看看分配了多少内存。下面的程序演示了这个构想。


//此实例来自《java核心技术》卷一 class MemoryDemo{public static void main(String args[]){Runtime r = Runtime.getRuntime();long mem1,mem2;Integer someints[] = new Integer[1000];System.out.println("Total memory is :" + r.totalMemory());mem1 = r.freeMemory();System.out.println("Initial free is : " + mem1);r.gc();mem1 = r.freeMemory();System.out.println("Free memory after garbage collection : " + mem1);//allocate integersfor(int i=0; i<1000; i++) someints[i] = new Integer(i);


mem2 = r.freeMemory();System.out.println("Free memory after allocation : " + mem2);System.out.println("Memory used by allocation : " +(mem1-mem2));


//discard Intergersfor(int i=0; i<1000; i++) someints[i] = null;r.gc(); //request garbage collectionmem2 = r.freeMemory();System.out.println("Free memory after collecting " + "discarded integers : " + mem2);} }


编译后运行结果如下(不同的机器不同时间运行的结果也不一定一样): Total memory is :2031616 Initial free is : 1818488 Free memory after garbage collection : 1888808 Free memory after allocation : 1872224 Memory used by allocation : 16584 Free memory after collecting discarded integers : 1888808

2、执行其他程序 在安全的环境中,可以在多任务操作系统中使用Java去执行其他特别大的进程(也就是程序)。ecec()方法有几种形式命名想要运行的程序和它的输入参数。ecec()方法返回一个Process对象,可以使用这个对象控制Java程序与新运行的进程进行交互。ecec()方法本质是依赖于环境。 下面的例子是使用ecec()方法启动windows的记事本notepad。这个例子必须在Windows操作系统上运行。


//此实例来自《Java核心技术》卷一 class ExecDemo {public static void main(String args[]){Runtime r = Runtime.getRuntime();Process p = null;try{p = r.exec("notepad");} catch (Exception e) {System.out.println("Error executing notepad.");}} }


ecec()还有其他几种形式,例子中演示的是最常用的一种。ecec()方法返回Process对象后,在新程序开始运行后就可以使用Process的方法了。可以用destory()方法杀死子进程,也可以使用waitFor()方法等待程序直到子程序结束,exitValue()方法返回子进程结束时返回的值。如果没有错误,将返回0,否则返回非0。下面是关于ecec()方法的例子的改进版本。例子被修改为等待,直到运行的进程退出:


//此实例来自《Java核心技术》卷一 class ExecDemoFini {public static void main(String args[]){Runtime r = Runtime.getRuntime();Process p = null;try{p = r.exec("notepad");p.waitFor();} catch (Exception e) {System.out.println("Error executing notepad.");}System.out.println("Notepad returned " + p.exitValue());} } 下面是运行的结果(当关闭记事本后,会接着运行程序,打印信息): Notepad returned 0 请按任意键继续. . .

当子进程正在运行时,可以对标准输入输出进行读写。getOutputStream()方法和getInPutStream()方法返回对子进程的标准输入和输出。


四、来自SUN公司的java.long.Runtime类的API文档,网上有chm中文版的,很好找。为了查阅方便,我从SUN公司的JavaDoc站点上复制出来了Runtime类的API文档。


java.lang 类 Runtime
java.lang.Object
java.lang.Runtime
public class Runtime

extendsObject


每个 Java 应用程序都有一个Runtime类实例,使应用程序能够与其运行的环境相连接。可以通过getRuntime方法获取当前运行时。


应用程序不能创建自己的 Runtime 类实例。


从以下版本开始:JDK1.0另请参见:getRuntime()

方法摘要



void
addShutdownHook(Threadhook) 注册新的虚拟机来关闭挂钩。


int
availableProcessors() 向 Java 虚拟机返回可用处理器的数目。


Process
exec(Stringcommand) 在单独的进程中执行指定的字符串命令。


Process
exec(String[]cmdarray) 在单独的进程中执行指定命令和变量。


Process
exec(String[]cmdarray,String[]envp) 在指定环境的独立进程中执行指定命令和变量。


Process
exec(String[]cmdarray,String[]envp,Filedir) 在指定环境和工作目录的独立进程中执行指定的命令和变量。


Process
exec(Stringcommand,String[]envp) 在指定环境的单独进程中执行指定的字符串命令。


Process
exec(Stringcommand,String[]envp,Filedir) 在有指定环境和工作目录的独立进程中执行指定的字符串命令。


void
exit(intstatus) 通过启动虚拟机的关闭序列,终止当前正在运行的 Java 虚拟机。


long
freeMemory() 返回 Java 虚拟机中的空闲内存量。


void
gc() 运行垃圾回收器。


InputStream
getLocalizedInputStream(InputStreamin) 已过时。从 JDK1.1 开始,将本地编码字节流转换为 Unicode 字符流的首选方法是使用InputStreamReader和BufferedReader类。


OutputStream
getLocalizedOutputStream(OutputStreamout) 已过时。从 JDK1.1 开始,将 Unicode 字符流转换为本地编码字节流的首选方法是使用OutputStreamWriter、BufferedWriter和PrintWriter类。


staticRuntime
getRuntime() 返回与当前 Java 应用程序相关的运行时对象。


void
halt(intstatus) 强行终止目前正在运行的 Java 虚拟机。


void
load(Stringfilename) 加载作为动态库的指定文件名。


void
loadLibrary(Stringlibname) 加载具有指定库名的动态库。


long
maxMemory() 返回 Java 虚拟机试图使用的最大内存量。


boolean
removeShutdownHook(Threadhook) 取消注册某个先前已注册的虚拟机关闭挂钩。


void
runFinalization() 运行挂起 finalization 的所有对象的终止方法。


staticvoid
runFinalizersOnExit(booleanvalue) 已过时。此方法本身具有不安全性。它可能对正在使用的对象调用终结方法,而其他线程正在操作这些对象,从而导致不正确的行为或死锁。


long
totalMemory() 返回 Java 虚拟机中的内存总量。


void
traceInstructions(booleanon) 启用/禁用指令跟踪。


void
traceMethodCalls(booleanon) 启用/禁用方法调用跟踪。

从类 java.lang.Object继承的方法



clone,equals,finalize,getClass,hashCode,notify,notifyAll,toString,wait,wait,wait

方法详细信息


getRuntime
public static Runtime getRuntime()

返回与当前 Java 应用程序相关的运行时对象。Runtime类的大多数方法是实例方法,并且必须根据当前的运行时对象对其进行调用。

返回:与当前 Java 应用程序相关的Runtime对象。


exit
public void exit(intstatus)

通过启动虚拟机的关闭序列,终止当前正在运行的 Java 虚拟机。此方法从不正常返回。可以将变量作为一个状态码;根据惯例,非零的状态码表示非正常终止。


虚拟机的关闭序列包含两个阶段。在第一个阶段中,会以某种未指定的顺序启动所有已注册的关闭挂钩(如果有的话),并且允许它们同时运行直至结束。在第二个阶段中,如果已启用退出终结,则运行所有未调用的终结方法。一旦完成这个阶段,虚拟机就会暂停。


如果在虚拟机已开始其关闭序列后才调用此方法,那么若正在运行关闭挂钩,则将无限期地阻断此方法。如果已经运行完关闭挂钩,并且已启用退出终结 (on-exit finalization),那么此方法将利用给定的状态码(如果状态码是非零值)暂停虚拟机;否则将无限期地阻断虚拟机。


System.exit方法是调用此方法的一种传统而便捷的方式。


参数:status- 终止状态。按照惯例,非零的状态码表明非正常终止。抛出:SecurityException- 如果安全管理器存在,并且其checkExit方法不允许存在指定的状态另请参见:SecurityException,SecurityManager.checkExit(int),addShutdownHook(java.lang.Thread),removeShutdownHook(java.lang.Thread),runFinalizersOnExit(boolean),halt(int)


addShutdownHook
public void addShutdownHook(Threadhook)

注册新的虚拟机来关闭挂钩。


Java 虚拟机会为了响应以下两类事件而关闭

程序正常退出,这发生在最后的非守护线程退出时,或者在调用exit(等同于System.exit)方法时。或者,

为响应用户中断而终止虚拟机,如键入^C;或发生系统事件,比如用户注销或系统关闭。


关闭挂钩只是一个已初始化但尚未启动的线程。虚拟机开始启用其关闭序列时,它会以某种未指定的顺序启动所有已注册的关闭挂钩,并让它们同时运行。运行完所有的挂钩后,如果已启用退出终结,那么虚拟机接着会运行所有未调用的终结方法。最后,虚拟机会暂停。注意,关闭序列期间会继续运行守护线程,如果通过调用exit方法来发起关闭序列,那么也会继续运行非守护线程。


一旦开始了关闭序列,则只能通过调用halt方法来停止这个序列,此方法可强行终止虚拟机。


一旦开始了关闭序列,则不可能注册新的关闭挂钩或取消注册先前已注册的挂钩。尝试执行这些操作会导致抛出IllegalStateException。


关闭挂钩可在虚拟机生命周期中的特定时间运行,因此应保护性地对其进行编码。特别是应将关闭挂钩编写为线程安全的,并尽可能地避免死锁。关闭挂钩还应该不盲目地依靠某些服务,这些服务可能已注册了自己的关闭挂钩,所以其本身可能正处于关闭进程中。


关闭挂钩应该快速地完成其工作。当程序调用exit时,虚拟机应该迅速地关闭并退出。由于用户注销或系统关闭而终止虚拟机时,底层的操作系统可能只允许在固定的时间内关闭并退出。因此在关闭挂钩中尝试进行任何用户交互或执行长时间的计算都是不明智的。


与其他所有线程一样,通过调用线程ThreadGroup对象的uncaughtException方法,可在关闭挂钩中处理未捕获的异常。此方法的默认实现是将该异常的堆栈跟踪 (stack trace) 打印至System.err并终止线程;它不会导致虚拟机退出或暂停。


仅在很少的情况下,虚拟机可能会中止,也就是没有完全关闭就停止运行。虚拟机被外部终止时会出现这种现象,比如在 Unix 上使用SIGKILL信号或者在 Microsoft Windows 上调用TerminateProcess。如果由于内部数据结构损坏或试图访问不存在的内存而导致本机方法执行错误,那么可能也会中止虚拟机。如果虚拟机中止,则无法保证是否将运行关闭挂钩。


参数:hook- 一个已初始化但尚未启动的Thread对象抛出:IllegalArgumentException- 如果指定的挂钩已注册,或者可以确定挂钩正在运行或者已运行完毕IllegalStateException- 如果虚拟机已经处于关闭进程中SecurityException- 如果安全管理器存在并且拒绝RuntimePermission("shutdownHooks")从以下版本开始:1.3另请参见:removeShutdownHook(java.lang.Thread),halt(int),exit(int)


removeShutdownHook
public boolean removeShutdownHook(Threadhook)

取消注册某个先前已注册的虚拟机关闭挂钩。


参数:hook- 要删除的挂钩返回:如果指定的挂钩先前已注册并且成功地取消注册,则返回true,其他情况返回false。抛出:IllegalStateException- 如果虚拟机已经处于关闭进程中SecurityException- 如果安全管理器存在并且拒绝RuntimePermission("shutdownHooks")从以下版本开始:1.3另请参见:addShutdownHook(java.lang.Thread),exit(int)


halt
public void halt(intstatus)

强行终止目前正在运行的 Java 虚拟机。此方法从不正常返回。


应小心使用此方法。与exit方法不同,此方法不会启动关闭挂钩,并且如果已启用退出终结,此方法也不会运行未调用的终结方法。如果已经发起关闭序列,那么此方法不会等待所有正在运行的关闭挂钩或终结方法完成其工作。


参数:status- 终止状态。按照惯例,非零的状态码表明非正常终止。如果已经调用了exit(System.exit也一样)方法,那么该状态码将重写已传递至此方法的状态码。抛出:SecurityException- 如果安全管理器存在,并且其checkExit方法不允许具有指定状态时退出从以下版本开始:1.3另请参见:exit(int),addShutdownHook(java.lang.Thread),removeShutdownHook(java.lang.Thread)


runFinalizersOnExit
@Deprecated
public static void runFinalizersOnExit(booleanvalue)

已过时。此方法本身具有不安全性。它可能对正在使用的对象调用终结方法,而其他线程正在操作这些对象,从而导致不正确的行为或死锁。

在退出时启用或禁用终结;这样做可指定拥有未被自动调用终结方法的所有对象的终结方法,并将在退出 Java 运行时前运行此终结方法。默认情况下,禁用退出终结。


如果有安全管理器,则首先使用 0 作为变量来调用其checkExit方法,以确保允许退出。这可能会导致 SecurityException。

参数:value- 如果启用退出时终结,则该参数为 true,如果禁用退出时终结,则该参数为 false抛出:SecurityException- 如果安全管理器存在并且其checkExit方法不允许退出。从以下版本开始:JDK1.1另请参见:exit(int),gc(),SecurityManager.checkExit(int)


exec
public Process exec(Stringcommand)
throws IOException

在单独的进程中执行指定的字符串命令。


这是一个很有用的方法。对于exec(command)形式的调用而言,其行为与调用exec(command, null, null)完全相同。

参数:command- 一条指定的系统命令。返回:一个新的Process对象,用于管理子进程抛出:SecurityException- 如果安全管理器存在,并且其checkExec方法不允许创建子进程IOException- 如果发生 I/O 错误NullPointerException- 如果command为nullIllegalArgumentException- 如果command为空另请参见:exec(String[], String[], File),ProcessBuilder


exec
public Process exec(Stringcommand,
String[]envp)
throws IOException

在指定环境的单独进程中执行指定的字符串命令。


这是一个很有用的方法。对于exec(command, envp)形式的调用而言,其行为与调用exec(command, envp, null)完全相同。

参数:command- 一条指定的系统命令。envp- 字符串数组,其中每个元素的环境变量的设置格式为name=value;如果子进程应该继承当前进程的环境,或该参数为null。返回:一个新的Process对象,用于管理子进程抛出:SecurityException- 如果安全管理器存在,并且其checkExec方法不允许创建子进程IOException- 如果发生 I/O 错误NullPointerException- 如果command为null,或envp的元素之一为nullIllegalArgumentException- 如果command为空另请参见:exec(String[], String[], File),ProcessBuilder


exec
public Process exec(Stringcommand,
String[]envp,
Filedir)
throws IOException

在有指定环境和工作目录的独立进程中执行指定的字符串命令。


这是一个很有用的方法。对于exec(command, envp, dir)形式的调用而言,其行为与调用exec(cmdarray, envp, dir)完全相同,其中cmdarray是command中所有标记的数组。


更准确地说,可以使用通过调用newStringTokenizer(command)创建的StringTokenizer将command字符串拆解成标记,调用时不对字符类别做进一步的修改。然后将标记生成器所生成的标记以相同的顺序放入新的字符串数组cmdarray中。

参数:command- 一条指定的系统命令。envp- 字符串数组,其中每个元素的环境变量的设置格式为name=value;如果子进程应该继承当前进程的环境,或该参数为null。dir- 子进程的工作目录;如果子进程应该继承当前进程的工作目录,则该参数为null。返回:一个新的Process对象,用于管理子进程抛出:SecurityException- 如果安全管理器存在,并且其checkExec方法不允许创建子进程IOException- 如果发生 I/O 错误NullPointerException- 如果command为null,或者envp的某个元素为nullIllegalArgumentException- 如果command为空从以下版本开始:1.3另请参见:ProcessBuilder


exec
public Process exec(String[]cmdarray)
throws IOException

在单独的进程中执行指定命令和变量。


这是一个很有用的方法。对于exec(cmdarray)形式的调用而言,其行为与调用exec(cmdarray, null, null)完全相同。

参数:cmdarray- 包含所调用命令及其参数的数组。返回:一个新的Process对象,用于管理子进程抛出:SecurityException- 如果安全管理器存在,并且其checkExec方法不允许创建子进程IOException- 如果发生 I/O 错误NullPointerException- 如果cmdarray为null,或者cmdarray的某个元素为nullIndexOutOfBoundsException- 如果cmdarray是一个空数组(长度为0)另请参见:ProcessBuilder


exec
public Process exec(String[]cmdarray,
String[]envp)
throws IOException

在指定环境的独立进程中执行指定命令和变量。


这是一个很有用的方法。对于exec(cmdarray, envp)形式的调用而言,其行为与调用exec(cmdarray, envp, null)完全相同。

参数:cmdarray- 包含所调用命令及其参数的数组。envp- 字符串数组,其中每个元素的环境变量的设置格式为name=value;如果子进程应该继承当前进程的环境,或该参数为null。返回:一个新的Process对象,用于管理子进程抛出:SecurityException- 如果安全管理器存在,并且其checkExec方法不允许创建子进程IOException- 如果发生 I/O 错误NullPointerException- 如果cmdarray为null,或者cmdarray的某个元素为null,或者envp的某个元素为nullIndexOutOfBoundsException- 如果cmdarray是一个空数组(长度为0)另请参见:ProcessBuilder


exec
public Process exec(String[]cmdarray,
String[]envp,
Filedir)
throws IOException

在指定环境和工作目录的独立进程中执行指定的命令和变量。


给定的字符串数组cmdarray表示一个命令行标记,字符串数组envp则表示“环境”变量设置,此方法会创建一个新进程,而指定的命令就在这个进程中执行。


此方法检查cmdarray是否是一条有效的操作系统命令。哪些命令有效取决于系统,但是该命令至少必须有一个非 null 字符串的非空列表。


如果envp为null,那么子进程会继承当前进程的环境设置。


ProcessBuilder.start()现在是启用一个具有已修改环境的进程的首选方法。


dir指定了新子进程的工作目录。如果dir为null,那么子进程会继承当前进程的当前工作目录。


如果安全管理器存在,则用数组cmdarray的第一个元素作为变量来调用安全管理器的checkExec方法。这可能导致抛出SecurityException。


启动操作系统进程的方式完全取决于系统。其中有很多方面会导致错误:

未找到操作系统程序文件。
对程序文件的访问被拒绝。
工作目录不存在。

这些情况都会抛出一个异常。该异常的具体特性取决于系统,但它总是IOException的一个子类。

参数:cmdarray- 包含所调用命令及其参数的数组。envp- 字符串数组,其中每个元素的环境变量的设置格式为name=value,如果子进程应该继承当前进程的环境,或该参数为null。dir- 子进程的工作目录;如果子进程应该继承当前进程的工作目录,则该参数为null。返回:一个新的Process对象,用于管理子进程抛出:SecurityException- 如果安全管理器存在,并且其checkExec方法不允许创建子进程IOException- 如果发生 I/O 错误NullPointerException- 如果cmdarray为null,或者cmdarray的某个元素为null,抑或envp的某个元素为nullIndexOutOfBoundsException- 如果cmdarray是一个空数组(长度为0)从以下版本开始:1.3另请参见:ProcessBuilder


availableProcessors
public int availableProcessors()

向 Java 虚拟机返回可用处理器的数目。


该值在特定的虚拟机调用期间可能发生更改。因此,对可用处理器数目很敏感的应用程序应该不定期地轮询该属性,并相应地调整其资源用法。

返回:虚拟机可用的最大处理器数目;从不小于 1从以下版本开始:1.4


freeMemory
public long freeMemory()

返回 Java 虚拟机中的空闲内存量。调用gc方法可能导致freeMemory返回值的增加。

返回:供将来分配对象使用的当前可用内存的近似总量,以字节为单位。


totalMemory
public long totalMemory()

返回 Java 虚拟机中的内存总量。此方法返回的值可能随时间的推移而变化,这取决于主机环境。


注意,保存任意给定类型的一个对象所需的内存量可能取决于实现方法。

返回:目前为当前和后续对象提供的内存总量,以字节为单位。


maxMemory
public long maxMemory()

返回 Java 虚拟机试图使用的最大内存量。如果内存本身没有限制,则返回值Long.MAX_VALUE。


返回:虚拟机试图使用的最大内存量,以字节为单位。从以下版本开始:1.4


gc
public void gc()

运行垃圾回收器。调用此方法意味着 Java 虚拟机做了一些努力来回收未用对象,以便能够快速地重用这些对象当前占用的内存。当控制从方法调用中返回时,虚拟机已经尽最大努力回收了所有丢弃的对象。


名称gc代表“垃圾回收器”。虚拟机根据需要在单独的线程中自动执行回收过程,甚至不用显式调用gc方法。


方法System.gc()是调用此方法的一种传统而便捷的方式。

runFinalization
public void runFinalization()

运行挂起 finalization 的所有对象的终止方法。调用此方法意味着 Java 虚拟机做了一些努力运行已被丢弃对象的finalize方法,但是这些对象的finalize方法还没有运行。当控制从方法调用中返回时,Java 虚拟机已经尽最大努力去完成所有未执行的终止方法。


如果不显式调用runFinalization方法,则 Java 虚拟机会根据需要在单独的线程中自动执行此终止过程。


方法System.runFinalization()是调用此方法的一种传统而便捷的方式。

另请参见:Object.finalize()


traceInstructions
public void traceInstructions(booleanon)

启用/禁用指令跟踪。如果boolean变量为true,则执行此方法意味着让 Java 虚拟机发送虚拟机中每条指令执行的调试信息。该信息的格式,以及虚拟机所发送的文件或其他输出流的格式取决于主机的环境。如果虚拟机不支持此功能,则忽略这一 请求。跟踪输出的目的地取决于系统。


如果boolean变量为false,则执行此方法时将使 Java 虚拟机停止执行详细的指令跟踪。

参数:on- 为true时启用指令跟踪;为false时则禁用此功能。


traceMethodCalls
public void traceMethodCalls(booleanon)

启用/禁用方法调用跟踪。如果boolean变量为true,则执行此方法意味着让 Java 虚拟机发送虚拟机中每个方法的调试信息。该信息的格式,以及虚拟机所发送的文件或其他输出流的格式取决于主机的环境。如果虚拟机不支持此功能,则忽略这一请求。


使用变量 false 调用此方法意味着虚拟机停止发送每个调用的调试信息。

参数:on- 为true时启用指令跟踪;为false时则禁用此功能。


load
public void load(Stringfilename)

加载作为动态库的指定文件名。文件名变量必须是一个完整的路径名。对于java_g,会自动在 "_g" 前面插入 ".so"(例如Runtime.getRuntime().load("/home/avh/lib/libX11.so");)。


首先,如果有安全管理器,则用filename作为参数调用checkLink方法。这可能导致安全异常。


这与loadLibrary(String)方法类似,但它接受通用文件名作为变量,而不仅仅是库名,从而能够加载所有的本机代码文件。


方法System.load(String)是调用此方法的一种传统而便捷的方式。

参数:filename- 要加载的文件。抛出:SecurityException- 如果安全管理器存在,并且其checkLink方法不允许加载指定的动态库UnsatisfiedLinkError- 如果文件不存在。NullPointerException- 如果filename为null另请参见:getRuntime(),SecurityException,SecurityManager.checkLink(java.lang.String)


loadLibrary
public void loadLibrary(Stringlibname)

加载具有指定库名的动态库。从以前获取库文件的本地文件系统中加载含有本机代码的文件。这一过程的细节取决于实现方法。可以以某种特定于系统的方式完成从库名到特定文件名的映射。


首先,如果有安全管理器,则用libname作为参数调用checkLink方法。这可能导致安全性异常。


方法System.loadLibrary(String)是调用此方法的一种传统而便捷的方式。如果在某个类实现中使用本机方法,则标准的策略是将本机代码放入一个库文件中(称为LibFile),然后在类声明中放入一个静态的初始值设定项:



static { System.loadLibrary("LibFile"); }

当加载并初始化这个类时,也将加载实现本机方法所需的本机代码。


如果用相同库名多次调用此方法,则忽略第二次及后续的调用。

参数:libname- 库名。抛出:SecurityException- 如果安全管理器存在,并且其checkLink方法不允许加载指定的动态库UnsatisfiedLinkError- 如果库不存在。NullPointerException- 如果libname为null另请参见:SecurityException,SecurityManager.checkLink(java.lang.String)


getLocalizedInputStream
@Deprecated
public InputStream getLocalizedInputStream(InputStreamin)

已过时。从 JDK1.1 开始,将本地编码字节流转换为 Unicode 字符流的首选方法是使用InputStreamReader和BufferedReader类。

创建输入流的本地化版本。此方法获取InputStream,并返回除本地化外其他所有方面都和变量等效的InputStream,这些方面包括:作为本地字符集中的字符从流中被读取,并将它们从本地字符集自动转换为 Unicode。


如果参数已经是本地化流,则可作为结果返回。

参数:in- 要本地化的 InputStream返回:已本地化的输入流另请参见:InputStream,BufferedReader.BufferedReader(java.io.Reader),InputStreamReader.InputStreamReader(java.io.InputStream)


getLocalizedOutputStream
@Deprecated
public OutputStream getLocalizedOutputStream(OutputStreamout)

已过时。从 JDK1.1 开始,将 Unicode 字符流转换为本地编码字节流的首选方法是使用OutputStreamWriter、BufferedWriter和PrintWriter类。

创建输出流的本地化版本。此方法获取OutputStream,并返回除本地化外其他所有方面都和变量等效的OutputStream,这些方面包括:作为 Unicode 字符被写入流中,并被自动转换为本地字符集。


如果参数已经是本地流,则可作为结果返回。

参数:out- 要本地化的 OutputStream返回:已本地化的输出流另请参见:OutputStream,BufferedWriter.BufferedWriter(java.io.Writer),OutputStreamWriter.OutputStrea

最新文章

123

最新摄影

闪念基因

微信扫一扫

第七城市微信公众平台