JDK源码解析 java.lang.System类 jdk1.6
?
/*
?* @(#)System.java 1.159 07/11/27
?*
?* Copyright 2006 Sun Microsystems, Inc. All rights reserved.
?* SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
?*/
package java.lang;
?
import java.io.*;
import java.util.Properties;
import java.util.PropertyPermission;
import java.util.StringTokenizer;
import java.security.AccessController;
import java.security.PrivilegedAction;
import java.security.AllPermission;
import java.nio.channels.Channel;
import java.nio.channels.spi.SelectorProvider;
import sun.nio.ch.Interruptible;
import sun.net.InetAddressCachePolicy;
import sun.reflect.Reflection;
import sun.security.util.SecurityConstants;
import sun.reflect.annotation.AnnotationType;
?
/**
?System 类包含一些有用的类字段和方法。它不能被实例化。?
?
?在 System 类提供的设施中，有标准输入、标准输出和错误输出流；对外部定义的属性和环境变量的访问；加载文件和库的方法；还有快速复制数组的一部分的实用方法。
?
?*/
public final class System { //System类被声明为final的，所以不能被继承。
?
/* First thing---register the natives ?注册到本地，静态代码块，在加载的时候就执行。*/
private static native void registerNatives();
?
static {
registerNatives();
}
?
/** Don't let anyone instantiate this class */
//私有的构造方法，防止任何人去实例化System类
private System() {
}
?
/**
“标准”输入流。此流已打开并准备提供输入数据。通常，此流对应于键盘输入或者由主机环境或用户指定的另一个输入源。?
*/
public final static InputStream in = nullInputStream();
?
/**
“标准”输出流。此流已打开并准备接受输出数据。通常，此流对应于显示器输出或者由主机环境或用户指定的另一个输出目标。?
对于简单独立的 Java 应用程序，编写一行输出数据的典型方式是：?
?
? ? System.out.println(data)
请参阅 PrintStream 类中的 println 方法。?
?
?
另请参见：
PrintStream.println(), PrintStream.println(boolean), PrintStream.println(char), PrintStream.println(char[]), PrintStream.println(double), PrintStream.println(float), PrintStream.println(int), PrintStream.println(long), PrintStream.println(java.lang.Object), PrintStream.println(java.lang.String)
?
*/
public final static PrintStream out = nullPrintStream();
?
/**
“标准”错误输出流。此流已打开并准备接受输出数据。?
通常，此流对应于显示器输出或者由主机环境或用户指定的另一个输出目标。按照惯例，此输出流用于显示错误消息，或者显示那些即使用户输出流（变量 out 的值）已经重定向到通常不被连续监视的某一文件或其他目标，也应该立刻引起用户注意的其他信息。?
?
*/
public final static PrintStream err = nullPrintStream();
?
/* The security manager for the system. 安全管理器
*/
private static volatile SecurityManager security = null;
?
/**
重新分配“标准”输入流。?
首先，如果有安全管理器，则通过 RuntimePermission("setIO") 权限调用其 checkPermission 方法，查看是否可以重新分配“标准”输入流。?
?
?
?
参数：
in - 新的标准输出流。?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkPermission 方法不允许重新分配标准输入流。
从以下版本开始：?
JDK1.1?
另请参见：
SecurityManager.checkPermission(java.security.Permission), RuntimePermission
?
*/
public static void setIn(InputStream in) {
checkIO(); //校验权限
setIn0(in); //重新分配标准输入流。
}
?
/**
重新分配“标准”输出流。?
首先，如果有安全管理器，则通过 RuntimePermission("setIO") 权限调用其 checkPermission 方法，查看是否可以重新分配“标准”输出流。?
?
?
参数：
out - 新的标准输出流?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkPermission 方法不允许重新分配标准输出流。
从以下版本开始：?
JDK1.1?
另请参见：
SecurityManager.checkPermission(java.security.Permission), RuntimePermission
?
*/
public static void setOut(PrintStream out) {
checkIO();
setOut0(out);
}
?
/**
重新分配“标准”错误输出流。?
首先，如果有安全管理器，则通过 RuntimePermission("setIO") 权限调用其 checkPermission 方法，查看是否可以重新分配“标准”输出流。?
?
?
参数：
err - 新的标准错误输出流?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkPermission 方法不允许重新分配标准错误输出流。
从以下版本开始：?
JDK1.1?
另请参见：
SecurityManager.checkPermission(java.security.Permission), RuntimePermission
?
*/
public static void setErr(PrintStream err) {
checkIO();
setErr0(err);
}
?
private static volatile Console cons = null; //控制台
?
/**
返回与当前 Java 虚拟机关联的唯一 Console 对象（如果有）。?
?
返回：
系统控制台（如果有），否则返回 null。
从以下版本开始：?
1.6?
?
*/
public static Console console() {
if (cons == null) {
synchronized (System.class) {
cons = sun.misc.SharedSecrets.getJavaIOAccess().console();
}
}
return cons;
}
?
/**?
返回从创建此 Java 虚拟机的实体中继承的信道。?
此方法返回通过调用系统级默认 SelectorProvider 对象的 inheritedChannel 方法获得的信道。?
?
除了 inheritedChannel 中描述的面向网络的信道之外，此方法以后还可能返回其他种类的信道。?
?
?
返回：
继承的信道（如果有），否则返回 null。?
抛出：?
IOException - 如果发生 I/O 错误?
SecurityException - 如果安全管理器存在并且它不允许访问信道。
从以下版本开始：?
1.5?
?
*/
public static Channel inheritedChannel() throws IOException {
return SelectorProvider.provider().inheritedChannel();
}
?
//校验IO权限
private static void checkIO() {
SecurityManager sm = getSecurityManager(); //获取安全管理器来校验是否有权限
if (sm != null) {
sm.checkPermission(new RuntimePermission("setIO"));
}
}
?
private static native void setIn0(InputStream in);
?
private static native void setOut0(PrintStream out);
?
private static native void setErr0(PrintStream err);
?
/**
设置系统安全性。?
如果已经安装了安全管理器，则此方法首先通过 RuntimePermission("setSecurityManager") 权限调用安全管理器的 checkPermission 方法，以确保可以替换现有的安全管理器。这可能导致抛出一个 SecurityException 异常。?
?
否则，将该参数作为当前安全管理器建立。如果参数为 null 并且没有建立安全管理器，则不执行任何操作，并且该方法将自行返回。?
?
?
参数：
s - 安全管理器。?
抛出：?
SecurityException - 如果安全管理器已经设置并且其 checkPermission 方法不允许替换该设置。
另请参见：
getSecurityManager(), SecurityManager.checkPermission(java.security.Permission), RuntimePermission
?
*/
public static void setSecurityManager(final SecurityManager s) {
try {
s.checkPackageAccess("java.lang"); //校验java.lang包的权限
} catch (Exception e) {
// no-op
}
setSecurityManager0(s);
}
?
private static synchronized void setSecurityManager0(final SecurityManager s) {
SecurityManager sm = getSecurityManager();
if (sm != null) {
// ask the currently installed security manager if we
// can replace it.
sm.checkPermission(new RuntimePermission("setSecurityManager"));
}
?
if ((s != null) && (s.getClass().getClassLoader() != null)) {
// New security manager class is not on bootstrap classpath.
// Cause policy to get initialized before we install the new
// security manager, in order to prevent infinite loops when
// trying to initialize the policy (which usually involves
// accessing some security and/or system properties, which in turn
// calls the installed security manager's checkPermission method
// which will loop infinitely if there is a non-system class
// (in this case: the new security manager class) on the stack).
AccessController.doPrivileged(new PrivilegedAction() {
public Object run() {
s.getClass().getProtectionDomain().implies(SecurityConstants.ALL_PERMISSION);
return null;
}
});
}
?
security = s;
InetAddressCachePolicy.setIfNotSet(InetAddressCachePolicy.FOREVER);
}
?
/**
获取系统安全接口。?
?
返回：
如果已经为当前应用程序建立了安全管理器，则返回此安全管理器；否则，返回 null。
另请参见：
setSecurityManager(java.lang.SecurityManager)
?
*/
public static SecurityManager getSecurityManager() {
return security;
}
?
/**
返回以毫秒为单位的当前时间。注意，当返回值的时间单位是毫秒时，值的粒度取决于底层操作系统，并且粒度可能更大。例如，许多操作系统以几十毫秒为单位测量时间。?
请参阅 Date 类的描述，了解可能发生在“计算机时间”和协调世界时（UTC）之间的细微差异的讨论。?
?
?
返回：
当前时间与协调世界时 1970 年 1 月 1 日午夜之间的时间差（以毫秒为单位测量）。
另请参见：
Date
?
*/
public static native long currentTimeMillis();
?
/**
返回最准确的可用系统计时器的当前值，以毫微秒为单位。?
此方法只能用于测量已过的时间，与系统或钟表时间的其他任何时间概念无关。返回值表示从某一固定但任意的时间算起的毫微秒数（或许从以后算起，所以该值可能为负）。此方法提供毫微秒的精度，但不是必要的毫微秒的准确度。它对于值的更改频率没有作出保证。在取值范围大于约 292 年（263 毫微秒）的连续调用的不同点在于：由于数字溢出，将无法准确计算已过的时间。?
?
例如，测试某些代码执行的时间长度：?
?
? long startTime = System.nanoTime();
? // ... the code being measured ...
? long estimatedTime = System.nanoTime() - startTime;
?
返回：
系统计时器的当前值，以毫微秒为单位。
从以下版本开始：?
1.5?
?
*/
public static native long nanoTime();
?
/**
从指定源数组中复制一个数组，复制从指定的位置开始，到目标数组的指定位置结束。从 src 引用的源数组到 dest 引用的目标数组，数组组件的一个子序列被复制下来。被复制的组件的编号等于 length 参数。源数组中位置在 srcPos 到 srcPos+length-1 之间的组件被分别复制到目标数组中的 destPos 到 destPos+length-1 位置。?
如果参数 src 和 dest 引用相同的数组对象，则复制的执行过程就好像首先将 srcPos 到 srcPos+length-1 位置的组件复制到一个带有 length 组件的临时数组，然后再将此临时数组的内容复制到目标数组的 destPos 到 destPos+length-1 位置一样。?
?
If 如果 dest 为 null，则抛出 NullPointerException 异常。?
?
如果 src 为 null, 则抛出 NullPointerException 异常，并且不会修改目标数组。?
?
否则，只要下列任何情况为真，则抛出 ArrayStoreException 异常并且不会修改目标数组：?
?
src 参数指的是非数组对象。?
dest 参数指的是非数组对象。?
src 参数和 dest 参数指的是那些其组件类型为不同基本类型的数组。?
src 参数指的是具有基本组件类型的数组且 dest 参数指的是具有引用组件类型的数组。?
src 参数指的是具有引用组件类型的数组且 dest 参数指的是具有基本组件类型的数组。?
否则，只要下列任何情况为真，则抛出 IndexOutOfBoundsException 异常，并且不会修改目标数组：?
?
srcPos 参数为负。?
destPos 参数为负。?
length 参数为负。?
srcPos+length 大于 src.length，即源数组的长度。?
destPos+length 大于 dest.length，即目标数组的长度。?
否则，如果源数组中 srcPos 到 srcPos+length-1 位置上的实际组件通过分配转换并不能转换成目标数组的组件类型，则抛出 ArrayStoreException 异常。在这种情况下，将 k 设置为比长度小的最小非负整数，这样就无法将 src[srcPos+k] 转换为目标数组的组件类型；当抛出异常时，从 srcPos 到 srcPos+k-1 位置上的源数组组件已经被复制到目标数组中的 destPos 到 destPos+k-1 位置，而目标数组中的其他位置不会被修改。（因为已经详细说明过的那些限制，只能将此段落有效地应用于两个数组都有引用类型的组件类型的情况。）?
?
?
参数：
src - 源数组。
srcPos - 源数组中的起始位置。
dest - 目标数组。
destPos - 目标数据中的起始位置。
length - 要复制的数组元素的数量。?
抛出：?
IndexOutOfBoundsException - 如果复制会导致对数组范围以外的数据的访问。?
ArrayStoreException - 如果因为类型不匹配而使得无法将 src 数组中的元素存储到 dest 数组中。?
NullPointerException - 如果 src 或 dest 为 null。
?
*/
public static native void arraycopy(Object src, int srcPos, Object dest, int destPos, int length);
?
/**
返回给定对象的哈希码，该代码与默认的方法 hashCode() 返回的代码一样，无论给定对象的类是否重写 hashCode()。null 引用的哈希码为 0。?
?
参数：
x - 要计算其哈希码的对象?
返回：
哈希码
从以下版本开始：?
JDK1.1?
?
*/
public static native int identityHashCode(Object x);
?
/**
* System properties. The following properties are guaranteed to be defined:
* 系统属性，下面的属性是被明确定义的。
* <dl>
* <dt>java.version <dd>Java version number
* <dt>java.vendor <dd>Java vendor specific string
* <dt>java.vendor.url <dd>Java vendor URL
* <dt>java.home <dd>Java installation directory
* <dt>java.class.version <dd>Java class version number
* <dt>java.class.path <dd>Java classpath
* <dt>os.name <dd>Operating System Name
* <dt>os.arch <dd>Operating System Architecture
* <dt>os.version <dd>Operating System Version
* <dt>file.separator <dd>File separator ("/" on Unix)
* <dt>path.separator <dd>Path separator (":" on Unix)
* <dt>line.separator <dd>Line separator ("\n" on Unix)
* <dt>user.name <dd>User account name
* <dt>user.home <dd>User home directory
* <dt>user.dir <dd>User's current working directory
* </dl>
*/
?
private static Properties props; //系统属性
?
private static native Properties initProperties(Properties props); //初始化系统属性
?
/**
确定当前的系统属性。?
首先，如果有安全管理器，则不带参数直接调用其 checkPropertiesAccess 方法。这可能导致一个安全性异常。?
?
将 getProperty(String) 方法使用的当前系统属性集合作为 Properties 对象返回。如果没有当前系统属性集合，则先创建并初始化一个系统属性集合。这个系统属性集合总是包含以下键的值： 键 相关值的描述?
java.version Java 运行时环境版本?
java.vendor Java 运行时环境供应商?
java.vendor.url Java 供应商的 URL?
java.home Java 安装目录?
java.vm.specification.version Java 虚拟机规范版本?
java.vm.specification.vendor Java 虚拟机规范供应商?
java.vm.specification.name Java 虚拟机规范名称?
java.vm.version Java 虚拟机实现版本?
java.vm.vendor Java 虚拟机实现供应商?
java.vm.name Java 虚拟机实现名称?
java.specification.version Java 运行时环境规范版本?
java.specification.vendor Java 运行时环境规范供应商?
java.specification.name Java 运行时环境规范名称?
java.class.version Java 类格式版本号?
java.class.path Java 类路径?
java.library.path 加载库时搜索的路径列表?
java.io.tmpdir 默认的临时文件路径?
java.compiler 要使用的 JIT 编译器的名称?
java.ext.dirs 一个或多个扩展目录的路径?
os.name 操作系统的名称?
os.arch 操作系统的架构?
os.version 操作系统的版本?
file.separator 文件分隔符（在 UNIX 系统中是“/”）?
path.separator 路径分隔符（在 UNIX 系统中是“:”）?
line.separator 行分隔符（在 UNIX 系统中是“/n”）?
user.name 用户的账户名称?
user.home 用户的主目录?
user.dir 用户的当前工作目录?
?
?
系统属性值中的多个路径是用平台的路径分隔符分隔的。?
?
注意，即使安全管理器不允许执行 getProperties 操作，它可能也会选择允许执行 getProperty(String) 操作。?
?
?
返回：
系统属性?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkPropertiesAccess 方法不允许访问系统属性。
另请参见：
setProperties(java.util.Properties), SecurityException, SecurityManager.checkPropertiesAccess(), Properties
?
*/
public static Properties getProperties() {
SecurityManager sm = getSecurityManager();
if (sm != null) {
sm.checkPropertiesAccess();
}
?
return props;
}
?
/**
将系统属性设置为 Properties 参数。?
首先，如果有安全管理器，则不带参数直接调用其 checkPropertiesAccess 方法。这可能导致一个安全性异常。?
?
参数是 getProperty(String) 方法使用的当前系统属性的集合。如果参数为 null，则忽略当前系统属性的集合。?
?
?
参数：
props - 新的系统属性。?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkPropertiesAccess 方法不允许访问系统属性。
另请参见：
getProperties(), Properties, SecurityException, SecurityManager.checkPropertiesAccess()
?
*/
public static void setProperties(Properties props) {
SecurityManager sm = getSecurityManager();
if (sm != null) {
sm.checkPropertiesAccess();
}
if (props == null) {
props = new Properties();
initProperties(props);
}
System.props = props;
}
?
/**
获取指定键指示的系统属性。?
首先，如果有安全管理器，则用该键作为其参数来调用 checkPropertyAccess 方法。结果可能导致 SecurityException。?
?
如果没有当前系统属性的集合，则首先用与 getProperties 方法相同的方式创建并初始化系统属性的集合。?
?
?
参数：
key - 系统属性的名称。?
返回：
系统属性的字符串值，如果没有带有此键的属性，则返回 null。?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkPropertyAccess 方法不允许访问指定的系统属性。?
NullPointerException - 如果 key 为 null。?
IllegalArgumentException - 如果 key 为空。
另请参见：
setProperty(java.lang.String, java.lang.String), SecurityException, SecurityManager.checkPropertyAccess(java.lang.String), getProperties()
?
*/
public static String getProperty(String key) {
checkKey(key);
SecurityManager sm = getSecurityManager();
if (sm != null) {
sm.checkPropertyAccess(key);
}
?
return props.getProperty(key);
}
?
/**
获取用指定键描述的系统属性。?
首先，如果有安全管理器，则用该 key 作为参数调用 checkPropertyAccess 方法。?
?
如果没有当前系统属性的集合，将用与 getProperties 方法相同的方式首先创建并初始化系统属性的集合。?
?
?
参数：
key - 系统属性的名称。
def - 默认值。?
返回：
系统属性的字符串值，如果没有带有此键的属性，则返回默认值。?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkPropertyAccess 方法不允许访问指定的系统属性。?
NullPointerException - 如果 key 为 null。?
IllegalArgumentException - 如果 key 为空。
另请参见：
setProperty(java.lang.String, java.lang.String), SecurityManager.checkPropertyAccess(java.lang.String), getProperties()
?
*/
public static String getProperty(String key, String def) {
checkKey(key);
SecurityManager sm = getSecurityManager();
if (sm != null) {
sm.checkPropertyAccess(key);
}
?
return props.getProperty(key, def);
}
?
/**
设置指定键指示的系统属性。?
首先，如果安全管理器存在，则通过 PropertyPermission(key, "write") 权限调用其 SecurityManager.checkPermission 方法。这可能导致抛出 SecurityException。如果没有抛出异常，则将指定属性设置为给定值。?
?
?
?
参数：
key - 系统属性的名称。
value - 系统属性的值。?
返回：
系统属性以前的值，如果没有以前的值，则返回 null。?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkPermission 方法不允许设置指定属性。?
NullPointerException - 如果 key 或 value 为 null。?
IllegalArgumentException - 如果 key 为空。
从以下版本开始：?
1.2?
另请参见：
getProperty(java.lang.String), getProperty(java.lang.String), getProperty(java.lang.String, java.lang.String), PropertyPermission, SecurityManager.checkPermission(java.security.Permission)
?
*/
public static String setProperty(String key, String value) {
checkKey(key);
SecurityManager sm = getSecurityManager();
if (sm != null) {
sm.checkPermission(new PropertyPermission(key, SecurityConstants.PROPERTY_WRITE_ACTION));
}
?
return (String) props.setProperty(key, value);
}
?
/**
移除指定键指示的系统属性。?
首先，如果安全管理器存在，则通过 PropertyPermission(key, "write") 权限调用其 SecurityManager.checkPermission 方法。这可能导致抛出 SecurityException。如果没有抛出异常，则移除指定的属性。?
?
?
?
参数：
key - 要移除的系统属性的名称。?
返回：
系统属性以前的字符串值，如果带有此键的属性不存在，则返回 null。?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkPropertyAccess 方法不允许访问指定的系统属性。?
NullPointerException - 如果 key 为 null。?
IllegalArgumentException - 如果 key 为空。
从以下版本开始：?
1.5?
另请参见：
getProperty(java.lang.String), setProperty(java.lang.String, java.lang.String), Properties, SecurityException, SecurityManager.checkPropertiesAccess()
?
*/
public static String clearProperty(String key) {
checkKey(key);
SecurityManager sm = getSecurityManager();
if (sm != null) {
sm.checkPermission(new PropertyPermission(key, "write"));
}
?
return (String) props.remove(key);
}
?
private static void checkKey(String key) {
if (key == null) {
throw new NullPointerException("key can't be null");
}
if (key.equals("")) {
throw new IllegalArgumentException("key can't be empty");
}
}
?
/**
获取指定的环境变量值。环境变量是一个取决于系统的外部指定的值。?
如果安全管理器存在，则通过 RuntimePermission("getenv."+name) 的权限调用其 checkPermission 方法。这可能导致抛出 SecurityException。如果没有抛出异常，则返回变量 name 的值。?
?
从概念上讲，系统属性 和环境变量 都是名称与值之间的映射。两种机制都能用来将用户定义的信息传递给 Java 进程。环境变量产生更多的全局效应，因为它们不仅对紧接着出现的 Java 子进程可见，而且对于定义它们的进程的所有子进程都是可见的。在不同的操作系统上，它们的语义有细微的差别，比如，不区分大小写。因为这些原因，环境变量更可能有意料不到的副作用。最好在可能的地方使用系统属性。环境变量应该在需要全局效应的时候使用，或者在外部系统接口要求使用环境变量时使用（比如 PATH）。?
?
在 UNIX 系统中，name 的字母大小写通常很重要，而在 Microsoft Windows 系统中，这通常不重要。例如，表达式 System.getenv("FOO").equals(System.getenv("foo")) 在 Microsoft Windows 中可能为真。?
?
?
参数：
name - 环境变量的名称?
返回：
变量的字符串值，如果变量不是在系统环境中定义的，则返回 null?
抛出：?
NullPointerException - 如果 name 为 null?
SecurityException - 如果安全管理器存在并且其 checkPermission 方法不允许访问环境变量 name
另请参见：
getenv(), ProcessBuilder.environment()
?
*/
public static String getenv(String name) {
SecurityManager sm = getSecurityManager();
if (sm != null) {
sm.checkPermission(new RuntimePermission("getenv." + name));
}
?
return ProcessEnvironment.getenv(name);
}
?
/**
返回一个不能修改的当前系统环境的字符串映射视图。该环境是一个取决于系统的从名称到值的映射，它从父进程传递给子进程。?
如果系统不支持环境变量，则返回一个空映射。?
?
返回的映射永远不会包含 null 键或 Null 值。如果试图查询 null 键或 Null 值的存在，则会抛出 NullPointerException。如果试图查询不是 String 类型的键或值的存在，则会抛出 ClassCastException。?
?
返回的映射及其集合视图可能没有遵守 Object.equals(java.lang.Object) 和 Object.hashCode() 方法的通用协定。?
?
在所有的平台上，返回的映射通常都是区分大小写的。?
?
如果安全管理器存在，则通过 RuntimePermission("getenv.*") 权限调用 checkPermission 方法。这可能导致抛出 SecurityException。?
?
将信息传递给 Java 子进程时，系统属性一般优先于环境变量。?
?
?
返回：
作为变量名称到值的映射的环境?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkPermission 方法不允许访问进程环境
从以下版本开始：?
1.5?
另请参见：
getenv(String), ProcessBuilder.environment()
?
*/
public static java.util.Map<String, String> getenv() {
SecurityManager sm = getSecurityManager();
if (sm != null) {
sm.checkPermission(new RuntimePermission("getenv.*"));
}
?
return ProcessEnvironment.getenv();
}
?
/**
终止当前正在运行的 Java 虚拟机。参数用作状态码；根据惯例，非 0 的状态码表示异常终止。?
该方法调用 Runtime 类中的 exit 方法。该方法永远不会正常返回。?
?
调用 System.exit(n) 实际上等效于调用：?
?
Runtime.getRuntime().exit(n)
?
参数：
status - 退出状态。?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkExit 方法不允许以指定状态退出。
另请参见：
Runtime.exit(int)
?
*/
public static void exit(int status) {
Runtime.getRuntime().exit(status);
}
?
/**
运行垃圾回收器。?
调用 gc 方法暗示着 Java 虚拟机做了一些努力来回收未用对象，以便能够快速地重用这些对象当前占用的内存。当控制权从方法调用中返回时，虚拟机已经尽最大努力从所有丢弃的对象中回收了空间。?
?
调用 System.gc() 实际上等效于调用：?
?
Runtime.getRuntime().gc()
?
另请参见：
Runtime.gc()
?
*/
public static void gc() {
Runtime.getRuntime().gc();
}
?
/**
运行处于挂起终止状态的所有对象的终止方法。?
调用该方法说明 Java 虚拟机做了一些努力运行已被丢弃对象的 finalize 方法，但是这些对象的 finalize 方法至今尚未运行。当控制权从方法调用中返回时，Java 虚拟机已经尽最大努力去完成所有未执行的终止方法。?
?
调用 System.runFinalization() 实际上等效于调用：?
?
Runtime.getRuntime().runFinalization()
?
另请参见：
Runtime.runFinalization()
?
*/
public static void runFinalization() {
Runtime.getRuntime().runFinalization();
}
?
/**
已过时。 该方法具有固有的不安全性。它可能对正在使用的对象调用终结方法，而其他线程同时正在操作这些对象，从而导致不正确的行为或死锁。?
?
在退出时启用或禁用终结；这样做可指定，拥有未被自动调用终结方法的所有对象的终结方法在退出 Java 运行库前运行。默认情况下，禁用退出时终结。?
如果有安全管理器，则首先使用 0 作为参数来调用其 checkExit 方法，以确保允许退出。这可能导致抛出 SecurityException。?
?
?
参数：
value - 指示启用或禁用终止操作的值?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkExit 方法不允许退出。
从以下版本开始：?
JDK1.1?
另请参见：
Runtime.exit(int), Runtime.gc(), SecurityManager.checkExit(int)
?
*/
@Deprecated
public static void runFinalizersOnExit(boolean value) {
Runtime.getRuntime().runFinalizersOnExit(value);
}
?
/**
从作为动态库的本地文件系统中以指定的文件名加载代码文件。文件名参数必须是完整的路径名。?
调用 System.load(name) 实际上等效于调用：?
?
Runtime.getRuntime().load(name)
?
参数：
filename - 要加载的文件。?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkLink 方法不允许加载指定的动态库。?
UnsatisfiedLinkError - 如果文件不存在。?
NullPointerException - 如果 filename 为 null
另请参见：
Runtime.load(java.lang.String), SecurityManager.checkLink(java.lang.String)
?
*/
public static void load(String filename) {
Runtime.getRuntime().load0(getCallerClass(), filename);
}
?
/**
加载由 libname 参数指定的系统库。将库名映射到实际系统库的方法取决于系统。?
调用 System.loadLibrary(name) 实际上等效于调用：?
?
Runtime.getRuntime().loadLibrary(name)
?
参数：
libname - 库名。?
抛出：?
SecurityException - 如果安全管理器存在并且其 checkLink 方法不允许加载指定的动态库。?
UnsatisfiedLinkError - 如果库不存在。?
NullPointerException - 如果 libname 为 null
另请参见：
Runtime.loadLibrary(java.lang.String), SecurityException, SecurityManager.checkLink(java.lang.String)
?
*/
public static void loadLibrary(String libname) {
Runtime.getRuntime().loadLibrary0(getCallerClass(), libname);
}
?
/**
将一个库名称映射到特定于平台的、表示本机库的字符串中。?
?
参数：
libname - 库名。?
返回：
取决于平台的本机库名称。?
抛出：?
NullPointerException - 如果 libname 为 null。
从以下版本开始：?
1.2?
另请参见：
loadLibrary(java.lang.String), ClassLoader.findLibrary(java.lang.String)
?
*/
public static native String mapLibraryName(String libname);
?
/**
* The following two methods exist because in, out, and err must be
* initialized to null. ?The compiler, however, cannot be permitted to
* inline access to them, since they are later set to more sensible values
* by initializeSystemClass().
*/
private static InputStream nullInputStream() throws NullPointerException {
if (currentTimeMillis() > 0) {
return null;
}
throw new NullPointerException();
}
?
private static PrintStream nullPrintStream() throws NullPointerException {
if (currentTimeMillis() > 0) {
return null;
}
throw new NullPointerException();
}
?
/**
* Initialize the system class. ?Called after thread initialization.
* 初始化系统类。在线程被初始化后调用。
*/
private static void initializeSystemClass() {
props = new Properties();
initProperties(props);
sun.misc.Version.init();
?
// Load the zip library now in order to keep java.util.zip.ZipFile
// from trying to use itself to load this library later.
loadLibrary("zip");
?
FileInputStream fdIn = new FileInputStream(FileDescriptor.in); //实例化in的流
FileOutputStream fdOut = new FileOutputStream(FileDescriptor.out); //实例化out的流
FileOutputStream fdErr = new FileOutputStream(FileDescriptor.err); //实例化err的流
setIn0(new BufferedInputStream(fdIn)); //设置in
setOut0(new PrintStream(new BufferedOutputStream(fdOut, 128), true)); //设置out
setErr0(new PrintStream(new BufferedOutputStream(fdErr, 128), true)); //设置err
?
// Setup Java signal handlers for HUP, TERM, and INT (where available).
Terminator.setup();
?
// The order in with the hooks are added here is important as it
// determines the order in which they are run.?
// (1)Console restore hook needs to be called first.
// (2)Application hooks must be run before calling deleteOnExitHook.
Shutdown.add(sun.misc.SharedSecrets.getJavaIOAccess().consoleRestoreHook());
Shutdown.add(ApplicationShutdownHooks.hook());
Shutdown.add(sun.misc.SharedSecrets.getJavaIODeleteOnExitAccess());
?
// Initialize any miscellenous operating system settings that need to be
// set for the class libraries. Currently this is no-op everywhere except
// for Windows where the process-wide error mode is set before the java.io
// classes are used.
sun.misc.VM.initializeOSEnvironment();
?
// Set the maximum amount of direct memory. ?This value is controlled
// by the vm option -XX:MaxDirectMemorySize=<size>. ?This method acts
// as an initializer only if it is called before sun.misc.VM.booted().
sun.misc.VM.maxDirectMemory();
?
// Set a boolean to determine whether ClassLoader.loadClass accepts
// array syntax. ?This value is controlled by the system property
// "sun.lang.ClassLoader.allowArraySyntax". ?This method acts as
// an initializer only if it is called before sun.misc.VM.booted().
sun.misc.VM.allowArraySyntax();
?
// Subsystems that are invoked during initialization can invoke
// sun.misc.VM.isBooted() in order to avoid doing things that should
// wait until the application class loader has been set up.
sun.misc.VM.booted();
?
// The main thread is not added to its thread group in the same
// way as other threads; we must do it ourselves here.
Thread current = Thread.currentThread();
current.getThreadGroup().add(current);
?
// Allow privileged classes outside of java.lang
sun.misc.SharedSecrets.setJavaLangAccess(new sun.misc.JavaLangAccess() {
public sun.reflect.ConstantPool getConstantPool(Class klass) {
return klass.getConstantPool();
}
?
public void setAnnotationType(Class klass, AnnotationType type) {
klass.setAnnotationType(type);
}
?
public AnnotationType getAnnotationType(Class klass) {
return klass.getAnnotationType();
}
?
public <E extends Enum<E>> E[] getEnumConstantsShared(Class<E> klass) {
return klass.getEnumConstantsShared();
}
?
public void blockedOn(Thread t, Interruptible b) {
t.blockedOn(b);
}
});
}
?
/* returns the class of the caller. */
//返回访问的类
static Class getCallerClass() {
// NOTE use of more generic Reflection.getCallerClass()
return Reflection.getCallerClass(3);
}
}
