类 java.lang.Runtime

java.lang.Object
   |
   +----java.lang.Runtime

public class Runtime

extends Object

方法索引

exec(String)

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

exec(String, String[])

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

exec(String[])

在独立的进程中执行指定字符串命令和参数。

exec(String[], String[])

在带指定环境的独立进程中执行指定字符串命令和参数。

exit(int)

终止当前运行的 Java 虚拟机。

freeMemory()

返回系统的空闲内存数。

gc()

运行垃圾回收器。

getLocalizedInputStream(InputStream)

创建输入流的本地版本。 不推荐使用该方法。

getLocalizedOutputStream(OutputStream)

创建输出流的本地版本。 不推荐使用该方法。

getRuntime()

返回与当前的 Java 应用相关的运行时间对象。

load(String)

加载与动态库类似的指定文件名。

loadLibrary(String)

加载指定库名的动态库。

runFinalization()

运行任何挂起终止对象的终止方法。

runFinalizersOnExit(boolean)

在退出时启用或禁用终止；这样做来指定拥有未被自动调用终止器的所有对象的终止器，并将在退出 Java 运行前运行该终止器。

totalMemory()

返回 Java 虚拟机的内存总数。

traceInstructions(boolean)

启用／禁用指令跟踪。

traceMethodCalls(boolean)

启用／禁用方法调用跟踪。

方法

 public static Runtime getRuntime()

返回与当前的 Java 应用相关的运行时间对象。

返回值：

与当前 相关的 Runtime 对象。

 public void exit(int status)

终止当前运行的 Java 虚拟机。该方法从不正常返回。

若有一个安全管理器，则用 status 作为参数调用它的 checkExit 方法。可引起安全性异常。

参数用作一个状态码；按照约定，一个非零状态码指示非正常终止。

参数：

status - 退出状态。

抛出： SecurityException

若当前线程不能用指定状态退出。

参见：

SecurityException, checkExit

 public static void runFinalizersOnExit(boolean value)

在退出时启用或禁用终止；这样做来指定拥有未被自动调用终止器的所有对象的终止器，并将在退出 Java 运行前运行该终止器。缺省情况下，退出时的终止无效。仅当调用方允许退出时，才允许调用 runFinalizersOnExit 方法，否则安全管理器拒绝该调用。

参见：

gc, exit

 public Process exec(String command) throws IOException

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

将 command 参数解析成令牌，然后作为一个命令在独立的进程中执行。该方法与 exec(command, null) 同效。

参数：

command - 一个指定的系统命令。

返回值：

管理子进程的一个 Process 对象。

抛出： SecurityException

若当前线程不能创建子进程。

参见：

exec

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

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

该方法将 command 串拆分为令牌并创建包含令牌的新 cmdarray 数组；然后执行 exec(cmdarray, envp) 调用。

参数：

command - 指定的系统命令。

envp - 包含环境格式为 name=value 的数组

返回值：

管理子进程的一个 Process 对象。

抛出： SecurityException

若当前线程不能创建子进程。

参见：

exec

 public Process exec(String cmdarray[]) throws IOException

在独立的进程中执行指定字符串命令和参数。

在某个独立进程中，执行 cmdarray 中令牌指定的命令。该方法与 exec(command, null) 同效。

参数：

cmdarray - 包含待调用命令及其参数的数组。

返回值：

管理子进程的一个 Process 对象。

抛出： SecurityException

若当前线程不能创建子进程。

参见：

exec

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

用指定环境执行独立进程中的指定命令和参数。

若有一个安全管理器，则用数组 cmdarray 的第一个元素作为参数调用 checkExec 方法。可引起安全性异常。

若给定表示命令行令牌的字符串 cmdarray 数组和表示定义系统特性的某个“环境”的字符串 envp 数组，则该方法创建一个执行指定命令的新进程。

参数：

cmdarray - 包含待调用命令及其参数的数组。

envp - 包含环境格式为 name=value 的数组

返回值：

管理子进程的一个 Process 对象。

抛出： SecurityException

若当前线程不能创建子进程。

参见：

SecurityException, checkExec

 public native long freeMemory()

返回系统的空闲内存数。该方法的返回值总是小于 totalMemory 方法的返回值。调用 gc 方法可引起 freeMemory 的返回值的增加。

返回值：

以字节计算的供将来分配对象使用的当前可用内存的大约总数。

 public native long totalMemory()

返回 Java Virtual Machine 的内存总数。

返回值：

以字节计算的供分配对象使用的当前可用内存总数。

 public native void gc()

运行垃圾回收器。调用该方法来说明 Java 虚拟机做了一些努力回收未用对象，以使其当前可用内存能快速重用。当控制从方法调用中返回时， Java 虚拟机已回收了所有未用对象。

名字 gc 表示“垃圾回收器”。 Java 虚拟机需要时可自动执行该回收处理，甚至不用显式调用 gc 方法。

 public native void runFinalization()

运行任何挂起终止的对象的终止方法。调用该方法来说明 Java 虚拟机做了一些努力运行已被丢弃的对象的 finalize 方法，但是那些对象的 finalize 方法还没有运行。当控制从方法调用中返回时， Java 虚拟机已做了最大努力去完成所有未执行的终止操作。

若不用显式调用 runFinalization 方法， 则 Java 虚拟机在需要时可自动执行终止处理。

参见：

finalize

 public native void traceInstructions(boolean on)

启用／禁用指令跟踪。若 boolean 参数为 true , 则执行该方法可使 Java 虚拟机打印出 Java 虚拟机中每个指令的详细跟踪信息。若虚拟机不支持该特征，则忽略该请求。跟踪输出的目标文件由系统决定。

若 boolean 参数为 false , 则执行该方法时将使 Java 虚拟机停止执行详细的指令跟踪。

参数：

on - 为 true 时启用指令跟踪；为 false 时禁用该特征。

 public native void traceMethodCalls(boolean on)

启用／禁用方法调用跟踪。若 boolean 参数为 true , 则调用该方法时可使 Java 虚拟机打印出 Java 虚拟机中每个方法的详细跟踪信息。若虚拟机不支持该特征，则忽略该请求。跟踪输出的目标文件由系统决定。

若 boolean 参数为 false , 则执行该方法时将使 Java 虚拟机停止执行详细的方法跟踪。

参数：

on - 为 true 时启用指令跟踪；为 false 时禁用该特征。

 public synchronized void load(String filename)

加载与动态库类似的指定文件名。文件名参数必须是一个完整的路径名。对于 java_g ，自动在“.so”前插入“_g”(例如 Runtime.getRuntime().load("/home/avh/lib/libX11.so")；) 。

若有一个安全管理器，则用 filename 作为参数调用 checkLink 方法。可引起安全性异常。

参数：

filename - 待加载的文件。

抛出： SecurityException

若当前线程不能加载指定的动态库。

抛出： UnsatisfiedLinkError

若文件不存在。

参见：

getRuntime, SecurityException, checkLink

 public synchronized void loadLibrary(String libname)

加载指定库名的动态库。在某个系统特定的行为中完成从库名到特定文件的映射。

首先，若有一个安全管理器，则用filename作为参数调用它的 checkLink 方法。可引起安全性异常。

若用相同库名多次调用该方法，则忽略第二次及后续的调用。

参数：

libname - 库名。

抛出： SecurityException

若当前线程不能加载指定的动态库。

抛出： UnsatisfiedLinkError

若不存在该库。

参见：

SecurityException, checkLink

 public InputStream getLocalizedInputStream(InputStream in)

注意：不推荐使用 getLocalizedInputStream() 。 在 JDK 1.1 中, 将本地编码中的字节流转换为 Unicode 字符流的首选方法是使用 InputStreamReader 和 BufferedReader 类。

创建输入流的本地版本。该方法获取 InputStream 并返回除本地化外所有其它方面都和参数等价的 InputStream ：它以本地字符集的形式从流中读取，并将它从本地字符集自动转换为 Unicode。

若参数已是本地流，则可作为结果返回。

返回值：

本地输入流。

参见：

InputStream, BufferedReader, InputStreamReader

 public OutputStream getLocalizedOutputStream(OutputStream out)

注意：不推荐使用 getLocalizedOutputStream()。 在 JDK 1.1 中, 将 Unicode 字符流转换为本地编码字节流的首选方法是使用 OutputStreamWriter、BufferedWriter 和 PrintWriter 类。

创建输出流的本地版本。该方法获取 OutStream 并返回除本地化外所有其它方面都和参数等价的 OutStream ：它以 Unicode 的形式写入流中，并自动转换为本地字符集。

若参数已是本地流，则可作为结果返回。

返回值：

本地输出流。

参见：

OutputStream, BufferedWriter, OutputStreamWriter, PrintWriter