System 类保护几个有用的域和方法。
它不能被实例化。

System 类提供的设施有标准输入流、标准输出流和错误输出流；访问外部定义的“特性”； 一种加载文件和库的途径；和快速复制数组一部分的实用方法。

类 java.lang.System

java.lang.Object
   |
   +----java.lang.System

public final class System

extends Object

变量索引

err

“标准”错误输出流。

in

“标准”输入流。

out

“标准”输出流。

方法索引

arraycopy(Object, int, Object, int, int)

把指定的源数组中起始于指定位置的一个数组复制到目标数组的指定位置。

currentTimeMillis()

返回以毫秒为单位的当前时间。

exit(int)

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

gc()

运行垃圾回收程序。

getenv(String)

获取环境变量。
不推荐使用该方法。

getProperties()

确定当前系统属性。

getProperty(String)

获取指定关键字指示的系统属性。

getProperty(String, String)

获取指定关键字指示的系统属性。

getSecurityManager()

获取系统安全性接口。

identityHashCode(Object)

不管论给定对象的类是否覆盖 hashCode()，返回跟缺省方法
hashCode() 返回值相同的散列码。

load(String)

把指定文件象加载动态库那样加载。

loadLibrary(String)

加载由 libname 参数指定的系统库。

runFinalization()

运行挂起终止操作的所有对象的终止方法。

runFinalizersOnExit(boolean)

在退出时启用或禁止终止；
这样做指定所有那些还未自动调用终止程序的全部对象将在
Java 运行时间退出之前运行其终止程序。

setErr(PrintStream)

重新分配“标准”错误输出流。

setIn(InputStream)

重新分配“标准”输入流。

setOut(PrintStream)

重新分配“标准”输出流。

setProperties(Properties)

设置 Properties 参数的系统属性。

setSecurityManager(SecurityManager)

设置系统安全性。

变量

 public static final InputStream in

“标准”输入流。 该流已打开并且准备接受输入数据。
典型情况是该流同键盘输入或主机环境或用户指定的另一个输入源相联系。

 public static final PrintStream out

“标准”输出流。 该流已打开并且准备接受输出数据。
典型情况是该流同显示输出或由主机环境或用户指定的另一个输出目标相联系。

对单个的独立 Java 应用，写一行输出数据的一个典型方法是：

System.out.println(data)

参见在 PrintStream 类中的 println 方法。

 

参见：
 

println, println, println, println, println, println, println, println, println, println

 public static final PrintStream err

“标准”错误输出流。 该流已打开并且准备接受输出数据。

典型情况是该流同显示输出或由主机环境或用户指定的另一个输出目标相联系。
通过约定，该输出流用来显示出错信息或其它应立即引起用户注意的信息，即使是主输出流也应该如此，变量 out 的值已被重定向到一个文件或其它典型的未连续监视的目标上。

方法

 public static void setIn(InputStream in)

重新分配“标准”输入流。

 public static void setOut(PrintStream out)

重新分配“标准”输出流。

 public static void setErr(PrintStream err)

重新分配“标准”错误输出流。

 public static void setSecurityManager(SecurityManager s)

设置系统安全性。
如果一个安全管理器已由当前运行的
Java 应用建立起来，则抛出 SecurityException 。
否则，参数被作为当前运行的安全管理器建立。
如果参数为 null 并且没有建立起安全管理器，则不做任何动作，只简单返回。

 

参数：
 

s - 安全管理器。
 

抛出：
SecurityException
 

如果安全管理器已建立。

 public static SecurityManager getSecurityManager()

获取系统安全性接口。

 

返回值：
 

如果一个安全管理器已由当前运行的
Java 应用建立起来了，则返回该安全管理器；否则返回 null 。

 public static native long currentTimeMillis()

返回以毫秒为单位的当前时间。

参见类 Date 的描述，以了解关于“计算机时间”和通用协调时间 (UTC) 之间的轻微不同的讨论。

 

返回值：
 

以毫秒测量的在当前时间和
UTC 时间 1970 年 1 月 1 号午夜之间的时间长度。
 

参见：
 

Date

 public static native void arraycopy(Object src,
                                     int src_position,
                                     Object dst,
                                     int dst_position,
                                     int length)

把指定的源数组中起始于指定位置的一个数组复制到目标数组的指定位置。
一个数组元素子序列将从用 src 引用的源数组复制到用
dst 引用的目的数组。 复制的元素数等于
length 参数。 源数组中从位置
srcOffset 到
srcOffset+length-1 的元素将被一个一个地复制到目标数组中从 dstOffset 到
dstOffset+length-1 的位置。

如果 src 和 dst 参数引用的是相同的数组对象，
则复制的执行就好象是把从位置 srcOffset 到
srcOffset+length-1 的元素先复制到一个长度为
length 的临时数组中，然后在把临时数组中的内容复制到参数数组中从 dstOffset 到 dstOffset+length-1 的位置。

如果下列情况中任何一个为 true ，将抛出
ArrayStoreException ，并且不修改目标：

• src 参数所指的对象不是一个数组。
  
• dst 参数所指的对象不是一个数组。
  
• src 参数和 dst 参数所指的数组的元素类型是不同的原始类型。
  
• src 参数所指的元素类型是基本类型而参数
  dst 所指的是一个引用类型的数组。
  
• src 参数所指的数组元素是引用类型而参数
  dst 所指的是一个基本元素类型的数组。
  

否则，如果下列情况中任何一个为 true ，将抛出
ArrayIndexOutOfBoundsException ，并且不修改目标：

• srcOffset 参数为负数。
  
• dstOffset 参数为负数。
  
• length 参数为负数。
  
• srcOffset+length 大于
  src.length 源数组的长度。
  
• dstOffset+length 大于
    dst.length 目标数组的长度。
  

否则，如果源数组中任何从位置 srcOffset 到
srcOffset+length-1 的元素不能转换为目标数组的元素类型，则抛出
ArrayStoreException 。 在这种情况下，使
k 成为小于
length 的最小非负整数以使 src[srcOffset+k]
不能被转换为目标数组的元素类型；
当抛出异常时，源数组中从位置
srcOffset 到
srcOffset+k-1
的元素已被复制到目标数组中从
dstOffset 到
dstOffset+k-1
的位置，并且目标数组中其它位置未被改动。

 

参数：
 

src； - 源数组。
 

srcpos - 源数组的开始位置。
 

dest - 目标数组。
 

destpos - 目标数组的开始位置。
 

length - 要复制的数组元素个数。
 

抛出：
ArrayIndexOutOfBoundsException
 

如果复制导致存取超出数组边界。
 

抛出： ArrayStoreException
 

如果因为类型不匹配的原因而使得 src 数组中的一个元素不能存储到 dest
数组中。

 public static native int identityHashCode(Object x)

不管给定对象的类是否覆盖 hashCode()，返回和给定对象的缺省方法
hashCode() 返回值相同的散列码，
null 的散列码是零。

 public static Properties getProperties()

确定当前系统属性。

如果有一安全管理器，则不带参数调用它的
checkPropertiesAccess 方法，可能返回安全性异常。

当前系统属性的集合象一个
Properties 对象一样被返回。 如果没有当前系统属性的集合，
将生成一个系统属性集合并进行初始化。

该系统属性的集合总是包含下列关键字：

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Key	相关值的描述
java.version	Java 版本号
java.vendor	Java 指定供应商字符串
java.vendor.url	Java 供应商 URL
java.home	Java 安装目录
java.class.version	Java 类格式版本号码
java.class.path	Java 类路径
os.name	操作系统名
os.arch	操作系统结构
os.version	操作系统版本
file.separator	文件分隔符 (UNIX 上为“/” )
path.separator	路径分隔符 (UNIX 上为“：” )
line.separator	换行符(UNIX 上为“\n”)
user.name	用户帐户名
user.home	用户主目录
user.dir	用户当前工作目录

 

抛出：
SecurityException
 

若当前线程不能存取系统属性。
 

参见：
 

SecurityException, checkPropertiesAccess, Properties

 public static void setProperties(Properties props)

设置 Properties 参数指示的系统属性。

首先，如果有一安全管理器，则不带参数调用它的
checkPropertiesAccess 方法，可能返回一个安全性异常。

参数成为被
getProperty 方法使用的当前系统属性。 如果参数为 null,
则忽略当前系统属性。

 

参数：
 

props - 新系统属性。
 

抛出：
SecurityException
 

若当前线程不能设置系统属性。
 

参见：
 

SecurityException, checkPropertiesAccess

 public static String getProperty(String key)

获取指定关键字指示的系统属性。

首先，如果有一安全管理器，则用 key 做参数调用它的
checkPropertyAccess 方法，可能返回一个系统异常。

如果没有当前系统属性集合，
将生成一个系统属性集合并如同
getProperties 方法那样初始化它。

 

参数：
 

key - 系统属性名。  

返回值：
 

系统属性的字符串值，或如果没有那个关键字的属性则返回 null 。
 

抛出：
SecurityException
 

若当前线程不能存取系统属性或指定属性。
 

参见：
 

SecurityException, checkPropertyAccess, getProperties

 public static String getProperty(String key,
                                  String def)

获取指定关键字指示的系统属性。

首先，如果没有一个安全管理器，则用
key 作为参数调用它的 checkPropertyAccess 方法，

如果没有系统属性的当前集合，
将生成一个系统属性集合并用和getProperties 方法相同的方式进行初始化。

 

参数：
 

key - 系统属性名。  

def - 一个缺省值。
 

返回值：
 

系统属性的字符串值，如果没有那个关键字指示的属性则返回缺省值。
 

抛出：
SecurityException
 

若当前线程不能存取系统属性或指定属性。
 

参见：
 

checkPropertyAccess, getProperties

 public static String getenv(String name)

注意：不推荐使用 getenv() 方法。

获取环境变量。 一个环境变量是一个从属于系统的外部变量，它有一个字符串值。

 

参数：
 

name - 环境变量的名称。
 

返回：
 

变量的值，如果变量没有定义则返回 null 。

 public static void exit(int status)

终止当前运行的 Java 虚拟机。
该参数用作状态码；按照约定，一个非零状态码指示非正常终止。

该方法调用类 Runtime 中的 exit 方法。
该方法从不正常返回。

 

参数：
 

status - 退出状态。
 

抛出：
SecurityException
 

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

参见：
 

exit

 public static void gc()

运行垃圾回收程序。

调用 gc 方法表明 Java
虚拟机为了使未使用对象占用的内存能够尽快重用而尝试了回收未使用对象所占内存。当控制从方法调用中返回时， Java 虚拟机已做了最大努力去回收所有未使用对象的空间。

 

参见：
 

gc

 public static void runFinalization()

运行挂起终止操作的所有对象的终止方法。

调用该方法表明 Java 虚拟机已经做了努力去运行已被认为是删除的但其
finalize 方法还未运行的对象的
finalize 方法。
当控制从方法调用中返回时，Java 虚拟机已做了最大努力去完成所有未执行的终止操作。

 

参见：
 

runFinalization

 public static void runFinalizersOnExit(boolean value)

在退出时启用或禁止终止；
这样做指定所有那些还未自动调用终止程序的对象将在
Java 运行时间退出之前运行其终止程序。
缺省情况下，退出的终止操作是无效的。

 

参见：
 

exit, gc

 public static void load(String filename)

象加载一个动态库那样加载指定文件名。
文件名参数必须是一个完整的路径名。

该方法调用类 Runtime 中的 load 方法。

 

参数：
 

filename - 要加载的文件。
 

抛出：
SecurityException
 

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

抛出： UnsatisfiedLinkError
 

如果文件不存在。  

参见：
 

load

 public static void loadLibrary(String libname)

加载由 libname 参数指定的系统库。 库名到实际系统库的映射方式是依赖于系统的。

 

参数：
 

libname - 库名称。
 

抛出：
SecurityException
 

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

抛出： UnsatisfiedLinkError
 

如果库不存在。
 

参见：
 

loadLibrary