|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.lang.Runtime
public class Runtime
每个 Java 应用程序都有一个 Runtime
类实例,使应用程序能够与其运行的环境相连接。可以通过 getRuntime
方法获取当前运行时。
应用程序不能创建自己的 Runtime 类实例。
getRuntime()
方法摘要 | |
---|---|
void |
addShutdownHook(Thread hook)
注册新的虚拟机来关闭钩子。 |
int |
availableProcessors()
向 Java 虚拟机返回可用处理器的数目。 |
Process |
exec(String command)
在单独的进程中执行指定的字符串命令。 |
Process |
exec(String[] cmdarray)
在单独的进程中执行指定命令和变量。 |
Process |
exec(String[] cmdarray,
String[] envp)
在指定环境的独立进程中执行指定命令和变量。 |
Process |
exec(String[] cmdarray,
String[] envp,
File dir)
在指定环境和工作目录的独立进程中执行指定的命令和变量。 |
Process |
exec(String command,
String[] envp)
在指定环境的单独进程中执行指定的字符串命令。 |
Process |
exec(String command,
String[] envp,
File dir)
在有指定环境和工作目录的独立进程中执行指定的字符串命令。 |
void |
exit(int status)
通过启动虚拟机的关闭序列,终止当前正在运行的 Java 虚拟机。 |
long |
freeMemory()
返回 Java 虚拟机中的空闲内存量。 |
void |
gc()
运行垃圾回收器。 |
InputStream |
getLocalizedInputStream(InputStream in)
已过时。 从 JDK 1.1 开始,将本地编码字节流转换为 Unicode 字符流的首选方法是使用 InputStreamReader 和 BufferedReader 类。 |
OutputStream |
getLocalizedOutputStream(OutputStream out)
已过时。 从 JDK 1.1 开始,将 Unicode 字符流转换为本地编码字节流的首选方法是使用 OutputStreamWriter 、BufferedWriter 和 PrintWriter 类。 |
static Runtime |
getRuntime()
返回与当前 Java 应用程序相关的运行时对象。 |
void |
halt(int status)
强行终止目前正在运行的 Java 虚拟机。 |
void |
load(String filename)
加载作为动态库的指定文件名。 |
void |
loadLibrary(String libname)
加载具有指定库名的动态库。 |
long |
maxMemory()
返回 Java 虚拟机试图使用的最大内存量。 |
boolean |
removeShutdownHook(Thread hook)
取消注册某个先前已注册的虚拟机关闭钩子。 |
void |
runFinalization()
运行挂起 finalization 的所有对象的终止方法。 |
static void |
runFinalizersOnExit(boolean value)
已过时。 此方法本身具有不安全性。它可能对正在使用的对象调用终结方法,而其他线程正在操作这些对象,从而导致不正确的行为或死锁。 |
long |
totalMemory()
返回 Java 虚拟机中的内存总量。 |
void |
traceInstructions(boolean on)
启用/禁用指令跟踪。 |
void |
traceMethodCalls(boolean on)
启用/禁用方法调用跟踪。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
方法详细信息 |
---|
public static Runtime getRuntime()
Runtime
类的大多数方法是实例方法,并且必须根据当前的运行时对象对其进行调用。
Runtime
对象。public void exit(int status)
虚拟机的关闭序列包含两个阶段。在第一个阶段中,会以某种未指定的顺序启动所有已注册的关闭钩子 (hook)
(如果有的话),并且允许它们同时运行直至结束。在第二个阶段中,如果已启用退出终结
,则运行所有未调用的终结方法。一旦完成这个阶段,虚拟机就会暂停
。
如果在虚拟机已开始其关闭序列后才调用此方法,那么若正在运行关闭钩子,则将无限期地阻断此方法。如果已经运行完关闭钩子,并且已启用退出终结 (on-exit finalization),那么此方法将利用给定的状态码(如果状态码是非零值)暂停虚拟机;否则将无限期地阻断虚拟机。
System.exit
方法是调用此方法的一种传统而便捷的方式。
status
- 终止状态。按照惯例,非零的状态码表明非正常终止。
SecurityException
- 如果安全管理器存在,并且其 checkExit
方法不允许存在指定的状态SecurityException
,
SecurityManager.checkExit(int)
,
addShutdownHook(java.lang.Thread)
,
removeShutdownHook(java.lang.Thread)
,
runFinalizersOnExit(boolean)
,
halt(int)
public void addShutdownHook(Thread hook)
Java 虚拟机会为了响应以下两类事件而关闭:
exit
(等同于 System.exit
)方法时。或者,
关闭钩子 只是一个已初始化但尚未启动的线程。虚拟机开始启用其关闭序列时,它会以某种未指定的顺序启动所有已注册的关闭钩子,并让它们同时运行。运行完所有的钩子后,如果已启用退出终结,那么虚拟机接着会运行所有未调用的终结方法。最后,虚拟机会暂停。注意,关闭序列期间会继续运行守护线程,如果通过调用 exit
方法来发起关闭序列,那么也会继续运行非守护线程。
一旦开始了关闭序列,则只能通过调用 halt
方法来停止这个序列,此方法可强行终止虚拟机。
一旦开始了关闭序列,则不可能注册新的关闭钩子或取消注册先前已注册的钩子。尝试执行这些操作会导致抛出 IllegalStateException
。
关闭钩子可在虚拟机生命周期中的特定时间运行,因此应保护性地对其进行编码。特别是应将关闭钩子编写为线程安全的,并尽可能地避免死锁。关闭钩子还应该不盲目地依靠某些服务,这些服务可能已注册了自己的关闭钩子,所以其本身可能正处于关闭进程中。例如,试图使用其他基于线程的服务(如 AWT 事件指派线程)可能导致死锁。
关闭钩子应该快速地完成其工作。当程序调用 exit
时,虚拟机应该迅速地关闭并退出。由于用户注销或系统关闭而终止虚拟机时,底层的操作系统可能只允许在固定的时间内关闭并退出。因此在关闭钩子中尝试进行任何用户交互或执行长时间的计算都是不明智的。
与其他所有线程一样,通过调用线程 ThreadGroup
对象的 uncaughtException
方法,可在关闭钩子中处理未捕获的异常。此方法的默认实现是将该异常的堆栈跟踪打印至 System.err
并终止线程;它不会导致虚拟机退出或暂停。
仅在很少的情况下,虚拟机可能会中止,也就是没有完全关闭就停止运行。虚拟机被外部终止时会出现这种现象,比如在 Unix 上使用 SIGKILL 信号或者在 Microsoft Windows 上调用 TerminateProcess。如果由于内部数据结构损坏或试图访问不存在的内存而导致本机方法执行错误,那么可能也会中止虚拟机。如果虚拟机中止,则无法保证是否将运行关闭钩子。
hook
- 一个已初始化但尚未启动的 Thread
对象
IllegalArgumentException
- 如果指定的钩子已注册,或者可以确定钩子正在运行或者已运行完毕
IllegalStateException
- 如果虚拟机已经处于关闭进程中
SecurityException
- 如果安全管理器存在并且拒绝 RuntimePermission
("shutdownHooks")removeShutdownHook(java.lang.Thread)
,
halt(int)
,
exit(int)
public boolean removeShutdownHook(Thread hook)
hook
- 要删除的钩子
IllegalStateException
- 如果虚拟机已经处于关闭进程中
SecurityException
- 如果安全管理器存在并且拒绝 RuntimePermission
("shutdownHooks")addShutdownHook(java.lang.Thread)
,
exit(int)
public void halt(int status)
应小心使用此方法。与 exit
方法不同,此方法不会启动关闭钩子,并且如果已启用退出终结,此方法也不会运行未调用的终结方法。如果已经发起关闭序列,那么此方法不会等待所有正在运行的关闭钩子或终结方法完成其工作。
status
- 终止状态。按照惯例,非零的状态码表明非正常终止。如果已经调用了 exit
(System.exit
也一样)方法,那么该状态码将重写已传递至此方法的状态码。
SecurityException
- 如果安全管理器存在,并且其 checkExit
方法不允许具有指定状态时退出exit(int)
,
addShutdownHook(java.lang.Thread)
,
removeShutdownHook(java.lang.Thread)
@Deprecated public static void runFinalizersOnExit(boolean value)
如果有安全管理器,则首先使用 0 作为变量来调用其 checkExit
方法,以确保允许退出。这可能会导致 SecurityException。
value
- 如果启用退出时终结,则该参数为 true,如果禁用退出时终结,则该参数为 false
SecurityException
- 如果安全管理器存在并且其 checkExit
方法不允许退出。exit(int)
,
gc()
,
SecurityManager.checkExit(int)
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
public Process exec(String command, 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
的元素之一为 null
IllegalArgumentException
- 如果 command
为空exec(String[], String[], File)
,
ProcessBuilder
public Process exec(String command, String[] envp, File dir) throws IOException
这是一个很有用的方法。对于 exec(command, envp, dir) 形式的调用而言,其行为与调用 exec
(cmdarray, envp, dir) 完全相同,其中 cmdarray
是 command
中所有标记的数组。
更准确地说,可以使用通过调用 new
创建的 StringTokenizer
(command)StringTokenizer
将 command
字符串拆解成标记,调用时不对字符类别做进一步的修改。然后将标记生成器所生成的标记以相同的顺序放入新的字符串数组 cmdarray
中。
command
- 一条指定的系统命令。envp
- 字符串数组,其中每个元素的环境变量的设置格式为 name=value;如果子进程应该继承当前进程的环境,或该参数为 null。dir
- 子进程的工作目录;如果子进程应该继承当前进程的工作目录,则该参数为 null。
Process
对象,用于管理子进程
SecurityException
- 如果安全管理器存在,并且其 checkExec
方法不允许创建子进程
IOException
- 如果发生 I/O 错误
NullPointerException
- 如果 command
为 null
,或者 envp
的某个元素为 null
IllegalArgumentException
- 如果 command
为空ProcessBuilder
public Process exec(String[] cmdarray) throws IOException
这是一个很有用的方法。对于 exec(cmdarray) 形式的调用而言,其行为与调用 exec
(cmdarray, null, null) 完全相同。
cmdarray
- 包含所调用命令及其参数的数组。
Process
对象,用于管理子进程
SecurityException
- 如果安全管理器存在,并且其 checkExec
方法不允许创建子进程
IOException
- 如果发生 I/O 错误
NullPointerException
- 如果 cmdarray
为 null
,或者 cmdarray
的某个元素为 null
IndexOutOfBoundsException
- 如果 cmdarray
是一个空数组(长度为 0
)ProcessBuilder
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
的某个元素为 null
IndexOutOfBoundsException
- 如果 cmdarray
是一个空数组(长度为 0
)ProcessBuilder
public Process exec(String[] cmdarray, String[] envp, File dir) 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
的某个元素为 null
IndexOutOfBoundsException
- 如果 cmdarray
是一个空数组(长度为 0
)ProcessBuilder
public int availableProcessors()
该值在特定的虚拟机调用期间可能发生更改。因此,对可用处理器数目很敏感的应用程序应该不定期地轮询该属性,并相应地调整其资源用法。
public long freeMemory()
gc
方法可能导致 freeMemory
返回值的增加。
public long totalMemory()
注意,保存任意给定类型的一个对象所需的内存量可能取决于实现方法。
public long maxMemory()
Long.MAX_VALUE
。
public void gc()
名称 gc
代表“垃圾回收器”。虚拟机根据需要在单独的线程中自动执行回收过程,甚至不用显式调用 gc
方法。
方法 System.gc()
是调用此方法的一种传统而便捷的方式。
public void runFinalization()
finalize
方法,但是这些对象的 finalize
方法还没有运行。当控制从方法调用中返回时,Java 虚拟机已经尽最大努力去完成所有未执行的终止方法。
如果不显式调用 runFinalization
方法,则 Java 虚拟机会根据需要在单独的线程中自动执行此终止过程。
方法 System.runFinalization()
是调用此方法的一种传统而便捷的方式。
Object.finalize()
public void traceInstructions(boolean on)
boolean
变量为 true
,则执行此方法意味着让 Java 虚拟机发送虚拟机中每条指令执行的调试信息。该信息的格式,以及虚拟机所发送的文件或其他输出流的格式取决于主机的环境。如果虚拟机不支持此功能,则忽略这一请求。跟踪输出的目的地取决于系统。
如果 boolean
变量为 false
,则执行此方法时将使 Java 虚拟机停止执行详细的指令跟踪。
on
- 为 true
时启用指令跟踪;为 false
时则禁用此功能。public void traceMethodCalls(boolean on)
boolean
变量为 true
,则执行此方法意味着让 Java 虚拟机发送虚拟机中每个方法的调试信息。该信息的格式,以及虚拟机所发送的文件或其他输出流的格式取决于主机的环境。如果虚拟机不支持此功能,则忽略这一请求。
使用变量 false 调用此方法意味着虚拟机停止发送每个调用的调试信息。
on
- 为 true
时启用指令跟踪;为 false
时则禁用此功能。public void load(String filename)
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)
public void loadLibrary(String libname)
首先,如果有安全管理器,则用 libname
作为参数调用 checkLink
方法。这可能导致安全性异常。
方法 System.loadLibrary(String)
是调用此方法的一种传统而便捷的方式。如果在某个类实现中使用本机方法,则标准的策略是将本机代码放入一个库文件中(称为 LibFile
),然后在类声明中放入一个静态的初始值设定项:
当加载并初始化这个类时,也将加载实现本机方法所需的本机代码。static { System.loadLibrary("LibFile"); }
如果用相同库名多次调用此方法,则忽略第二次及后续的调用。
libname
- 库名。
SecurityException
- 如果安全管理器存在,并且其 checkLink
方法不允许加载指定的动态库
UnsatisfiedLinkError
- 如果库不存在。
NullPointerException
- 如果 libname
为 null
SecurityException
,
SecurityManager.checkLink(java.lang.String)
@Deprecated public InputStream getLocalizedInputStream(InputStream in)
InputStreamReader
和 BufferedReader
类。
InputStream
,并返回除本地化外其他所有方面都和变量等效的 InputStream
,这些方面包括:作为本地字符集中的字符从流中被读取,并将它们从本地字符集自动转换为 Unicode。
如果参数已经是本地化流,则可作为结果返回。
in
- 要本地化的 InputStream
InputStream
,
BufferedReader.BufferedReader(java.io.Reader)
,
InputStreamReader.InputStreamReader(java.io.InputStream)
@Deprecated public OutputStream getLocalizedOutputStream(OutputStream out)
OutputStreamWriter
、BufferedWriter
和 PrintWriter
类。
OutputStream
,并返回除本地化外其他所有方面都和变量等效的 OutputStream
,这些方面包括:作为 Unicode 字符被写入流中,并被自动转换为本地字符集。
如果参数已经是本地流,则可作为结果返回。
out
- 要本地化的 OutputStream
OutputStream
,
BufferedWriter.BufferedWriter(java.io.Writer)
,
OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)
,
PrintWriter.PrintWriter(java.io.OutputStream)
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。