所有类

概述 软件包  类 使用 树 已过时 索引 帮助 
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法

java.lang
类 Runtime

java.lang.Object
  继承者 java.lang.Runtime

public class Runtime
   
   
   
   
   
extends Object

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

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

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

方法摘要
 voidaddShutdownHook(Thread hook)
          注册新的虚拟机来关闭挂钩。
 intavailableProcessors()
          向 Java 虚拟机返回可用处理器的数目。
 Processexec(String command)
          在单独的进程中执行指定的字符串命令。
 Processexec(String[] cmdarray)
          在单独的进程中执行指定命令和变量。
 Processexec(String[] cmdarray, String[] envp)
          在指定环境的独立进程中执行指定命令和变量。
 Processexec(String[] cmdarray, String[] envp, File dir)
          在指定环境和工作目录的独立进程中执行指定的命令和变量。
 Processexec(String command, String[] envp)
          在指定环境的单独进程中执行指定的字符串命令。
 Processexec(String command, String[] envp, File dir)
          在有指定环境和工作目录的独立进程中执行指定的字符串命令。
 voidexit(int status)
          通过启动虚拟机的关闭序列，终止当前正在运行的 Java 虚拟机。
 longfreeMemory()
          返回 Java 虚拟机中的空闲内存量。
 voidgc()
          运行垃圾回收器。
 InputStreamgetLocalizedInputStream(InputStream in)
          已过时。 从 JDK 1.1 开始，将本地编码字节流转换为 Unicode 字符流的首选方法是使用 InputStreamReader 和 BufferedReader 类。
 OutputStreamgetLocalizedOutputStream(OutputStream out)
          已过时。 从 JDK 1.1 开始，将 Unicode 字符流转换为本地编码字节流的首选方法是使用 OutputStreamWriter、BufferedWriter 和 PrintWriter 类。
static RuntimegetRuntime()
          返回与当前 Java 应用程序相关的运行时对象。
 voidhalt(int status)
          强行终止目前正在运行的 Java 虚拟机。
 voidload(String filename)
          加载作为动态库的指定文件名。
 voidloadLibrary(String libname)
          加载具有指定库名的动态库。
 longmaxMemory()
          返回 Java 虚拟机试图使用的最大内存量。
 booleanremoveShutdownHook(Thread hook)
          取消注册某个先前已注册的虚拟机关闭挂钩。
 voidrunFinalization()
          运行挂起 finalization 的所有对象的终止方法。
static voidrunFinalizersOnExit(boolean value)
          已过时。 此方法本身具有不安全性。它可能对正在使用的对象调用终结方法，而其他线程正在操作这些对象，从而导致不正确的行为或死锁。
 longtotalMemory()
          返回 Java 虚拟机中的内存总量。
 voidtraceInstructions(boolean on)
          启用／禁用指令跟踪。
 voidtraceMethodCalls(boolean on)
          启用／禁用方法调用跟踪。
 
从类 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(int status)
通过启动虚拟机的关闭序列，终止当前正在运行的 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(Thread hook)
注册新的虚拟机来关闭挂钩。

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(Thread hook)
取消注册某个先前已注册的虚拟机关闭挂钩。

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

halt

public void halt(int status)
强行终止目前正在运行的 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(boolean value)
已过时。 此方法本身具有不安全性。它可能对正在使用的对象调用终结方法，而其他线程正在操作这些对象，从而导致不正确的行为或死锁。

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

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

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

exec

public Process exec(String command)
             throws IOException
在单独的进程中执行指定的字符串命令。

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

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