深入研究java.lang.System类
作者:熔岩
前言:Java的类库日益庞大,所包含的类和接口也不计其数。但其中有一些非常重要的类和接口,是Java类库中的核心部分。常见的有String、Object、Class、Collection、ClassLoader、System、Runtime...,掌握类是灵活Java这门语言的基础。而这些类一般都很好理解和运用,需要做深入的研究和实践才能掌握。下面是我结合实践对这些类理解和使用的一些总结。欢迎你在阅读后将你宝贵的意见和读后感留下,呵呵...别忘了你也能从中赚到积分,以便能发更长的文章出来!
一、概述:
二、API预览
四、来自SUN公司的java.long.System类的API文档,网上有chm中文版的,很好找。为了查阅方便,我从SUN公司的JavaDoc站点上复制出来了System类的API文档。
java.lang | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段摘要 | |
|---|---|
static PrintStream |
err “标准”错误输出流。 |
static InputStream |
in “标准”输入流。 |
static PrintStream |
out “标准”输出流。 |
| 方法摘要 | |
|---|---|
static void |
arraycopy(Object src, int srcPos, Object dest, int destPos, int length) 从指定源数组中复制一个数组,复制从指定的位置开始,到目标数组的指定位置结束。 |
static String |
clearProperty(String key) 移除指定键指示的系统属性。 |
static long |
currentTimeMillis() 返回以毫秒为单位的当前时间。 |
static void |
exit(int status) 终止当前正在运行的 Java 虚拟机。 |
static void |
gc() 运行垃圾回收器。 |
static Map<String,String> |
getenv() 返回一个不能修改的当前系统环境的字符串映射视图。 |
static String |
getenv(String name) 获得指定的环境变量值。 |
static Properties |
getProperties() 确定当前的系统属性。 |
static String |
getProperty(String key) 获得指定键指示的系统属性。 |
static String |
getProperty(String key, String def) 获得用指定键描述的系统属性。 |
static SecurityManager |
getSecurityManager() 获得系统安全接口。 |
static int |
identityHashCode(Object x) 返回给定对象的哈希码,该代码与默认的方法 hashCode() 返回的代码一样,无论给定对象的类是否重写 hashCode()。 |
static Channel |
inheritedChannel() 返回从创建此 Java 虚拟机的实体中继承的信道。 |
static void |
load(String filename) 从作为动态库的本地文件系统中以指定的文件名加载代码文件。 |
static void |
loadLibrary(String libname) 加载由 libname 参数指定的系统库。 |
static String |
mapLibraryName(String libname) 将一个库名称映射到特定于平台的、表示本机库的字符串中。 |
static long |
nanoTime() 返回最准确的可用系统计时器的当前值,以毫微秒为单位。 |
static void |
runFinalization() 运行处于挂起终止状态的所有对象的终止方法。 |
static void |
runFinalizersOnExit(boolean value) 已过时。 该方法具有固有的不安全性。它可能对正在使用的对象调用终结方法,而其他线程同时正在操作这些对象,从而导致不正确的行为或死锁。 |
static void |
setErr(PrintStream err) 重新分配“标准”错误输出流。 |
static void |
setIn(InputStream in) 重新分配“标准”输入流。 |
static void |
setOut(PrintStream out) 重新分配“标准”输出流。 |
static void |
setProperties(Properties props) 将系统属性设置为 Properties 参数。 |
static String |
setProperty(String key, String value) 设置指定键指示的系统属性。 |
static void |
setSecurityManager(SecurityManager s) 设置系统安全性。 |
| 从类 java.lang.Object 继承的方法 |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| 字段详细信息 |
|---|
in
public static final InputStream in
- “标准”输入流。此流已打开并准备提供输入数据。通常,此流对应于键盘输入或者由主机环境或用户指定的另一个输入源。
out
public static final PrintStream out
- “标准”输出流。此流已打开并准备接受输出数据。通常,此流对应于显示器输出或者由主机环境或用户指定的另一个输出目标。
对于简单独立的 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)
err
public static final PrintStream err
- “标准”错误输出流。此流已打开并准备接受输出数据。
通常,此流对应于显示器输出或者由主机环境或用户指定的另一个输出目标。按照惯例,此输出流用于显示错误消息,或者显示那些即使用户输出流(变量
out的值)已经重定向到通常不被连续监视的某一文件或其他目标,也应该立刻引起用户注意的其他信息。
| 方法详细信息 |
|---|
setIn
public static void setIn(InputStream in)
- 重新分配“标准”输入流。
首先,如果有安全管理器,则通过
RuntimePermission("setIO")权限调用其checkPermission方法,查看是否可以重新分配“标准”输入流。- 参数:
in- 新的标准输出流。- 抛出:
SecurityException- 如果安全管理器存在并且其checkPermission方法不允许重新分配标准输入流。- 从以下版本开始:
- JDK1.1
- 另请参见:
SecurityManager.checkPermission(java.security.Permission),RuntimePermission
setOut
public static void setOut(PrintStream out)
- 重新分配“标准”输出流。
首先,如果有安全管理器,则通过
RuntimePermission("setIO")权限调用其checkPermission方法,查看是否可以重新分配“标准”输出流。- 参数:
out- 新的标准输出流- 抛出:
SecurityException- 如果安全管理器存在并且其checkPermission方法不允许重新分配标准输出流。- 从以下版本开始:
- JDK1.1
- 另请参见:
SecurityManager.checkPermission(java.security.Permission),RuntimePermission
setErr
public static void setErr(PrintStream err)
- 重新分配“标准”错误输出流。
首先,如果有安全管理器,则通过
RuntimePermission("setIO")权限调用其checkPermission方法,查看是否可以重新分配“标准”输出流。- 参数:
err- 新的标准错误输出流- 抛出:
SecurityException- 如果安全管理器存在并且其checkPermission方法不允许重新分配标准错误输出流。- 从以下版本开始:
- JDK1.1
- 另请参见:
SecurityManager.checkPermission(java.security.Permission),RuntimePermission
inheritedChannel
public static Channel inheritedChannel() throws IOException
- 返回从创建此 Java 虚拟机的实体中继承的信道。
此方法返回通过调用系统级默认
SelectorProvider对象的inheritedChannel方法获得的信道。除了
inheritedChannel中描述的面向网络的信道之外,此方法以后还可能返回其他种类的信道。- 返回:
- 继承的信道(如果有),否则返回 null。
- 抛出:
IOException- 如果发生 I/O 错误SecurityException- 如果安全管理器存在并且它不允许访问信道。- 从以下版本开始:
- 1.5
setSecurityManager
public static void setSecurityManager(SecurityManager s)
- 设置系统安全性。
如果已经安装了安全管理器,则此方法首先通过
RuntimePermission("setSecurityManager")权限调用安全管理器的checkPermission方法,以确保可以替换现有的安全管理器。这可能导致抛出一个SecurityException异常。否则,将该参数作为当前安全管理器建立。如果参数为
null并且没有建立安全管理器,则不执行任何操作,并且该方法将自行返回。- 参数:
s- 安全管理器。- 抛出:
SecurityException- 如果安全管理器已经设置并且其checkPermission方法不允许替换该设置。- 另请参见:
getSecurityManager(),SecurityManager.checkPermission(java.security.Permission),RuntimePermission
getSecurityManager
public static SecurityManager getSecurityManager()
- 获得系统安全接口。
- 返回:
- 如果已经为当前应用程序建立了安全管理器,则返回此安全管理器;否则,返回
null。 - 另请参见:
setSecurityManager(java.lang.SecurityManager)
currentTimeMillis
public static long currentTimeMillis()
- 返回以毫秒为单位的当前时间。注意,当返回值的时间单位是毫秒时,值的粒度取决于基础操作系统,并且粒度可能更大。例如,许多操作系统以几十毫秒为单位测量时间。
请参阅
Date类的描述,了解可能发生在“计算机时间”和协调世界时(UTC)之间的细微差异的讨论。- 返回:
- 当前时间与协调世界时 1970 年 1 月 1 日午夜之间的时间差(以毫秒为单位测量)。
- 另请参见:
Date
nanoTime
public static long nanoTime()
- 返回最准确的可用系统计时器的当前值,以毫微秒为单位。
此方法只能用于测量已过的时间,与系统或钟表时间的其他任何时间概念无关。返回值表示从某一固定但任意的时间算起的毫微秒数(或许从以后算起,所以该值可能为负)。此方法提供毫微秒的精度,但不是必要的毫微秒的准确度。它对于值的更改频率没有作出保证。在取值范围大于约 292 年(263 毫微秒)的连续调用的不同点在于:由于数字溢出,将无法准确计算已过的时间。
例如,测试某些代码执行的时间长度:
long startTime = System.nanoTime(); // ... the code being measured ... long estimatedTime = System.nanoTime() - startTime;
- 返回:
- 系统计时器的当前值,以毫微秒为单位。
- 从以下版本开始:
- 1.5
arraycopy
public static void arraycopy(Object src, int srcPos, Object dest, int destPos, int length)
- 从指定源数组中复制一个数组,复制从指定的位置开始,到目标数组的指定位置结束。从
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。
identityHashCode
public static int identityHashCode(Object x)
- 返回给定对象的哈希码,该代码与默认的方法 hashCode() 返回的代码一样,无论给定对象的类是否重写 hashCode()。null 引用的哈希码为零。
- 参数:
x- 要计算其哈希码的对象- 返回:
- 哈希码
- 从以下版本开始:
- JDK1.1
getProperties
public static Properties getProperties()
- 确定当前的系统属性。
首先,如果有安全管理器,则不带参数直接调用其
checkPropertiesAccess方法。这可能导致一个安全性异常。将
getProperty(String)方法使用的当前系统属性集合作为Properties对象返回。如果没有当前系统属性集合,则先创建并初始化一个系统属性集合。这个系统属性集合总是包含以下键的值:键 相关值的描述 java.versionJava 运行时环境版本 java.vendorJava 运行时环境供应商 java.vendor.urlJava 供应商的 URL java.homeJava 安装目录 java.vm.specification.versionJava 虚拟机规范版本 java.vm.specification.vendorJava 虚拟机规范供应商 java.vm.specification.nameJava 虚拟机规范名称 java.vm.versionJava 虚拟机实现版本 java.vm.vendorJava 虚拟机实现供应商 java.vm.nameJava 虚拟机实现名称 java.specification.versionJava 运行时环境规范版本 java.specification.vendorJava 运行时环境规范供应商 java.specification.nameJava 运行时环境规范名称 java.class.versionJava 类格式版本号 java.class.pathJava 类路径 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
setProperties
public static void setProperties(Properties props)
- 将系统属性设置为
Properties参数。首先,如果有安全管理器,则不带参数直接调用其
checkPropertiesAccess方法。这可能导致一个安全性异常。参数是
getProperty(String)方法使用的当前系统属性的集合。如果参数为null,则忽略当前系统属性的集合。- 参数:
props- 新的系统属性。- 抛出:
SecurityException- 如果安全管理器存在并且其checkPropertiesAccess方法不允许访问系统属性。- 另请参见:
getProperties(),Properties,SecurityException,SecurityManager.checkPropertiesAccess()
getProperty
public static String getProperty(String key)
- 获得指定键指示的系统属性。
首先,如果有安全管理器,则用该键作为其参数来调用
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()
getProperty
public static String getProperty(String key, String def)
- 获得用指定键描述的系统属性。
首先,如果有安全管理器,则用该
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()
setProperty
public static String setProperty(String key, String value)
- 设置指定键指示的系统属性。
首先,如果安全管理器存在,则通过
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)
clearProperty
public static String clearProperty(String key)
- 移除指定键指示的系统属性。
首先,如果安全管理器存在,则通过
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()
getenv
public static String getenv(String name)
- 获得指定的环境变量值。环境变量是一个取决于系统的外部命名的值。
如果安全管理器存在,则通过
的权限调用其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为nullSecurityException- 如果安全管理器存在并且其checkPermission方法不允许访问环境变量name- 另请参见:
getenv(),ProcessBuilder.environment()
getenv
public static Map<String,String> getenv()
- 返回一个不能修改的当前系统环境的字符串映射视图。该环境是一个取决于系统的从名称到值的映射,它从父进程传递给子进程。
如果系统不支持环境变量,则返回一个空映射。
返回的映射永远不会包含 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()
exit
public static void exit(int status)
- 终止当前正在运行的 Java 虚拟机。参数用作状态码;根据惯例,非零的状态码表示异常终止。
该方法调用
Runtime类中的exit方法。该方法永远不会正常返回。调用
System.exit(n)实际上等效于调用:Runtime.getRuntime().exit(n)
- 参数:
status- 退出状态。- 抛出:
SecurityException- 如果安全管理器存在并且其checkExit方法不允许以指定状态退出。- 另请参见:
Runtime.exit(int)
gc
public static void gc()
- 运行垃圾回收器。
调用
gc方法暗示着 Java 虚拟机做了一些努力来回收未用对象,以便能够快速地重用这些对象当前占用的内存。当控制权从方法调用中返回时,虚拟机已经尽最大努力从所有丢弃的对象中回收了空间。调用
System.gc()实际上等效于调用:Runtime.getRuntime().gc()
- 另请参见:
Runtime.gc()
runFinalization
public static void runFinalization()
- 运行处于挂起终止状态的所有对象的终止方法。
调用该方法说明 Java 虚拟机做了一些努力运行已被丢弃对象的
finalize方法,但是这些对象的finalize方法至今尚未运行。当控制权从方法调用中返回时,Java 虚拟机已经尽最大努力去完成所有未执行的终止方法。调用
System.runFinalization()实际上等效于调用:Runtime.getRuntime().runFinalization()
runFinalizersOnExit
@Deprecated public static void runFinalizersOnExit(boolean value)
- 已过时。 该方法具有固有的不安全性。它可能对正在使用的对象调用终结方法,而其他线程同时正在操作这些对象,从而导致不正确的行为或死锁。
- 在退出时启用或禁用终结;这样做可指定,拥有未被自动调用终结方法的所有对象的终结方法在退出 Java 运行库前运行。默认情况下,禁用退出时终结。
如果有安全管理器,则首先使用 0 作为参数来调用其
checkExit方法,以确保允许退出。这可能导致抛出 SecurityException。- 参数:
value- 指示启用或禁用终止操作的值- 抛出:
SecurityException- 如果安全管理器存在并且其checkExit方法不允许退出。- 从以下版本开始:
- JDK1.1
- 另请参见:
Runtime.exit(int),Runtime.gc(),SecurityManager.checkExit(int)
- 在退出时启用或禁用终结;这样做可指定,拥有未被自动调用终结方法的所有对象的终结方法在退出 Java 运行库前运行。默认情况下,禁用退出时终结。
load
public static void load(String filename)
- 从作为动态库的本地文件系统中以指定的文件名加载代码文件。文件名参数必须是完整的路径名。
调用
System.load(name)实际上等效于调用:Runtime.getRuntime().load(name)
- 参数:
filename- 要加载的文件。- 抛出:
SecurityException- 如果安全管理器存在并且其checkLink方法不允许加载指定的动态库。UnsatisfiedLinkError- 如果文件不存在。NullPointerException- 如果filename为null- 另请参见:
Runtime.load(java.lang.String),SecurityManager.checkLink(java.lang.String)
loadLibrary
public static void loadLibrary(String libname)
- 加载由
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)
mapLibraryName
public static String mapLibraryName(String libname)
- 将一个库名称映射到特定于平台的、表示本机库的字符串中。
- 参数:
libname- 库名。- 返回:
- 取决于平台的本机库名称。
- 抛出:
NullPointerException- 如果libname为null。- 从以下版本开始:
- 1.2
- 另请参见:
loadLibrary(java.lang.String),ClassLoader.findLibrary(java.lang.String)
本文出自 51CTO.COM技术博客



java.lang.System
leizhimin
博客统计信息
热门文章
最新评论
友情链接