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)
- 獲取環(huán)境變量。
不推薦使用該方法。
- getProperties()
- 確定當前系統(tǒng)屬性。
- getProperty(String)
- 獲取指定關鍵字指示的系統(tǒng)屬性。
- getProperty(String, String)
- 獲取指定關鍵字指示的系統(tǒng)屬性。
- getSecurityManager()
- 獲取系統(tǒng)安全性接口。
- identityHashCode(Object)
- 不管論給定對象的類是否覆蓋 hashCode()，返回跟缺省方法
hashCode() 返回值相同的散列碼。
- load(String)
- 把指定文件象加載動態(tài)庫那樣加載。
- loadLibrary(String)
- 加載由
libname 參數指定的系統(tǒng)庫。
- runFinalization()
- 運行掛起終止操作的所有對象的終止方法。
- runFinalizersOnExit(boolean)
- 在退出時啟用或禁止終止；
這樣做指定所有那些還未自動調用終止程序的全部對象將在
Java 運行時間退出之前運行其終止程序。
- setErr(PrintStream)
- 重新分配“標準”錯誤輸出流。
- setIn(InputStream)
- 重新分配“標準”輸入流。
- setOut(PrintStream)
- 重新分配“標準”輸出流。
- setProperties(Properties)
- 設置
Properties 參數的系統(tǒng)屬性。
- setSecurityManager(SecurityManager)
- 設置系統(tǒng)安全性。
變量
in
public static final InputStream in
- “標準”輸入流。 該流已打開并且準備接受輸入數據。
典型情況是該流同鍵盤輸入或主機環(huán)境或用戶指定的另一個輸入源相聯系。
out
public static final PrintStream out
- “標準”輸出流。 該流已打開并且準備接受輸出數據。
典型情況是該流同顯示輸出或由主機環(huán)境或用戶指定的另一個輸出目標相聯系。
對單個的獨立 Java 應用，寫一行輸出數據的一個典型方法是：
參見在 PrintStream 類中的 println 方法。
- 參見：
- println, println, println, println, println, println, println, println, println, println
err
public static final PrintStream err
- “標準”錯誤輸出流。 該流已打開并且準備接受輸出數據。
典型情況是該流同顯示輸出或由主機環(huán)境或用戶指定的另一個輸出目標相聯系。
通過約定，該輸出流用來顯示出錯信息或其它應立即引起用戶注意的信息，即使是主輸出流也應該如此，變量 out 的值已被重定向到一個文件或其它典型的未連續(xù)監(jiān)視的目標上。
方法
setIn
public static void setIn(InputStream in)
- 重新分配“標準”輸入流。
setOut
public static void setOut(PrintStream out)
- 重新分配“標準”輸出流。
setErr
public static void setErr(PrintStream err)
- 重新分配“標準”錯誤輸出流。
setSecurityManager
public static void setSecurityManager(SecurityManager s)
- 設置系統(tǒng)安全性。
如果一個安全管理器已由當前運行的
Java 應用建立起來，則拋出 SecurityException 。
否則，參數被作為當前運行的安全管理器建立。
如果參數為 null 并且沒有建立起安全管理器，則不做任何動作，只簡單返回。
- 參數：
- s - 安全管理器。
- 拋出：
SecurityException
- 如果安全管理器已建立。
getSecurityManager
public static SecurityManager getSecurityManager()
- 獲取系統(tǒng)安全性接口。
- 返回值：
- 如果一個安全管理器已由當前運行的
Java 應用建立起來了，則返回該安全管理器；否則返回 null 。
currentTimeMillis
public static native long currentTimeMillis()
- 返回以毫秒為單位的當前時間。
參見類 Date 的描述，以了解關于“計算機時間”和通用協(xié)調時間 (UTC) 之間的輕微不同的討論。
- 返回值：
- 以毫秒測量的在當前時間和
UTC 時間 1970 年 1 月 1 號午夜之間的時間長度。
- 參見：
- Date
arraycopy
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 參數引用的是相同的數組對象，
則復制的執(zhí)行就好象是把從位置 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
數組中。
identityHashCode
public static native int identityHashCode(Object x)
- 不管給定對象的類是否覆蓋 hashCode()，返回和給定對象的缺省方法
hashCode() 返回值相同的散列碼，
null 的散列碼是零。
getProperties
public static Properties getProperties()
- 確定當前系統(tǒng)屬性。
如果有一安全管理器，則不帶參數調用它的
checkPropertiesAccess 方法，可能返回安全性異常。
當前系統(tǒng)屬性的集合象一個
Properties 對象一樣被返回。 如果沒有當前系統(tǒng)屬性的集合，
將生成一個系統(tǒng)屬性集合并進行初始化。
該系統(tǒng)屬性的集合總是包含下列關鍵字：
| 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 |
操作系統(tǒng)名 |
os.arch |
操作系統(tǒng)結構 |
os.version |
操作系統(tǒng)版本 |
file.separator |
文件分隔符 (UNIX 上為“/” ) |
path.separator |
路徑分隔符 (UNIX 上為“：” ) |
line.separator |
換行符(UNIX 上為“\n”) |
user.name |
用戶帳戶名 |
user.home |
用戶主目錄 |
user.dir |
用戶當前工作目錄 |
- 拋出：
SecurityException
- 若當前線程不能存取系統(tǒng)屬性。
- 參見：
- SecurityException, checkPropertiesAccess, Properties
setProperties
public static void setProperties(Properties props)
- 設置
Properties 參數指示的系統(tǒng)屬性。
首先，如果有一安全管理器，則不帶參數調用它的
checkPropertiesAccess 方法，可能返回一個安全性異常。
參數成為被
getProperty 方法使用的當前系統(tǒng)屬性。 如果參數為 null,
則忽略當前系統(tǒng)屬性。
- 參數：
- props - 新系統(tǒng)屬性。
- 拋出：
SecurityException
- 若當前線程不能設置系統(tǒng)屬性。
- 參見：
- SecurityException, checkPropertiesAccess
getProperty
public static String getProperty(String key)
- 獲取指定關鍵字指示的系統(tǒng)屬性。
首先，如果有一安全管理器，則用 key 做參數調用它的
checkPropertyAccess 方法，可能返回一個系統(tǒng)異常。
如果沒有當前系統(tǒng)屬性集合，
將生成一個系統(tǒng)屬性集合并如同
getProperties 方法那樣初始化它。
- 參數：
- key - 系統(tǒng)屬性名。
- 返回值：
- 系統(tǒng)屬性的字符串值，或如果沒有那個關鍵字的屬性則返回
null 。
- 拋出：
SecurityException
- 若當前線程不能存取系統(tǒng)屬性或指定屬性。
- 參見：
- SecurityException, checkPropertyAccess, getProperties
getProperty
public static String getProperty(String key,
String def)
- 獲取指定關鍵字指示的系統(tǒng)屬性。
首先，如果沒有一個安全管理器，則用
key 作為參數調用它的 checkPropertyAccess 方法，
如果沒有系統(tǒng)屬性的當前集合，
將生成一個系統(tǒng)屬性集合并用和getProperties 方法相同的方式進行初始化。
- 參數：
- key - 系統(tǒng)屬性名。
- def - 一個缺省值。
- 返回值：
- 系統(tǒng)屬性的字符串值，如果沒有那個關鍵字指示的屬性則返回缺省值。
- 拋出：
SecurityException
- 若當前線程不能存取系統(tǒng)屬性或指定屬性。
- 參見：
- checkPropertyAccess, getProperties
getenv
public static String getenv(String name)
- 注意：不推薦使用 getenv() 方法。
- 獲取環(huán)境變量。 一個環(huán)境變量是一個從屬于系統(tǒng)的外部變量，它有一個字符串值。
- 參數：
- name - 環(huán)境變量的名稱。
- 返回：
- 變量的值，如果變量沒有定義則返回 null 。
exit
public static void exit(int status)
- 終止當前運行的 Java 虛擬機。
該參數用作狀態(tài)碼；按照約定，一個非零狀態(tài)碼指示非正常終止。
該方法調用類 Runtime 中的 exit 方法。
該方法從不正常返回。
- 參數：
- status - 退出狀態(tài)。
- 拋出：
SecurityException
- 若當前線程不能按指定狀態(tài)退出。
- 參見：
- exit
gc
public static void gc()
- 運行垃圾回收程序。
調用 gc 方法表明 Java
虛擬機為了使未使用對象占用的內存能夠盡快重用而嘗試了回收未使用對象所占內存。當控制從方法調用中返回時， Java 虛擬機已做了最大努力去回收所有未使用對象的空間。
- 參見：
- gc
runFinalization
public static void runFinalization()
- 運行掛起終止操作的所有對象的終止方法。
調用該方法表明 Java 虛擬機已經做了努力去運行已被認為是刪除的但其
finalize 方法還未運行的對象的
finalize 方法。
當控制從方法調用中返回時，Java 虛擬機已做了最大努力去完成所有未執(zhí)行的終止操作。
- 參見：
- runFinalization
runFinalizersOnExit
public static void runFinalizersOnExit(boolean value)
- 在退出時啟用或禁止終止；
這樣做指定所有那些還未自動調用終止程序的對象將在
Java 運行時間退出之前運行其終止程序。
缺省情況下，退出的終止操作是無效的。
- 參見：
- exit, gc
load
public static void load(String filename)
- 象加載一個動態(tài)庫那樣加載指定文件名。
文件名參數必須是一個完整的路徑名。
該方法調用類 Runtime 中的 load 方法。
- 參數：
- filename - 要加載的文件。
- 拋出：
SecurityException
- 若當前線程不能加載指定的動態(tài)庫。
- 拋出： UnsatisfiedLinkError
- 如果文件不存在。
- 參見：
- load
loadLibrary
public static void loadLibrary(String libname)
- 加載由
libname 參數指定的系統(tǒng)庫。 庫名到實際系統(tǒng)庫的映射方式是依賴于系統(tǒng)的。
- 參數：
- libname - 庫名稱。
- 拋出：
SecurityException
- 若當前線程不能加載指定的動態(tài)庫。
- 拋出： UnsatisfiedLinkError
- 如果庫不存在。
- 參見：
- loadLibrary
