CDC 1.1.2

java.lang
クラス System

java.lang.Object
  上位を拡張 java.lang.System

public final class System
extends Object

System クラスには有用なクラスフィールドおよびメソッドがあります。インスタンス化することはできません。  

System クラスによって得られる機能には、標準入力、標準出力、およびエラー出力ストリーム、外部的に定義された「プロパティー」へのアクセス、ファイルおよびライブラリのローディング方法、配列の一部をすばやくコピーするユーティリティーメソッドがあります。

導入されたバージョン:
JDK1.0

フィールドの概要
static PrintStream err
          「標準」エラー出力ストリームです。
static InputStream in
          「標準」入力ストリームです。
static PrintStream out
          「標準」出力ストリームです。
 
メソッドの概要
static void arraycopy(Object src, int srcPos, Object dest, int destPos, int length)
          指定位置で開始する指定ソース配列から、転送先配列の指定位置に配列をコピーします。
static long currentTimeMillis()
          ミリ秒で表される現在の時間を返します。
static void exit(int status)
          現在実行している Java 仮想マシンを終了します。
static void gc()
          ガベージコレクタを実行します。
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 void load(String filename)
          指定されたファイル名を持つコードファイルを、ダイナミックライブラリとしてローカルファイルシステムからロードします。
static void loadLibrary(String libname)
          引数 libname によって指定されるシステムライブラリをロードします。
static String mapLibraryName(String libname)
          ライブラリ名を、ネイティブライブラリを表すプラットフォーム依存の文字列にマッピングします。
static void runFinalization()
          ファイナライズを保留しているオブジェクトのファイナライズメソッドを実行します。
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

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()
ミリ秒で表される現在の時間を返します。戻り値の時間単位はミリ秒ですが、値の粒度は基本となるオペレーティングシステムによって異なり、単位がより大きくなる場合があります。たとえば、多くのオペレーティングシステムでは、時間を 10 ミリ秒の単位で計測します。

「コンピュータ時間」と協定世界時 (UTC) との間に発生する微妙な相違については、クラス Date の説明を参照してください。

戻り値:
ミリ秒で測定した、現在時刻と協定世界時の UTC 1970 年 1 月 1 日午前 0 時との差
関連項目:
Date

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 にコピーします。  

destnull の場合は、NullPointerException がスローされます。  

srcnull の場合は、NullPointerException がスローされ、転送先配列は変更されません。  

次のどれかの場合は、ArrayStoreException をスローし、転送先を修正しません。

そうでない場合、次のどれかが true であれば IndexOutOfBoundsException をスローし、転送先を修正しません。

そうでない場合、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 または destnull の場合

identityHashCode

public static int identityHashCode(Object x)
指定されたオブジェクトのクラスが hashCode() をオーバーライドしているかどうかに関係なく、デフォルトの hashCode() メソッドにより返されるものと同じ、指定されたオブジェクトのハッシュコードを返します。参照 null のハッシュコードはゼロです。

パラメータ:
x - ハッシュコードが計算されるオブジェクト
戻り値:
ハッシュコード
導入されたバージョン:
JDK1.1

getProperties

public static Properties getProperties()
現在のシステムプロパティーを決定します。  

まず、セキュリティーマネージャーが存在する場合は、引数なしで checkPropertiesAccess メソッドを呼び出します。これはセキュリティー例外となる場合があります。  

getProperty(String) メソッドにより使用されるシステムプロパティーの現在のセットが、Properties オブジェクトとして返されます。システムプロパティーの現在のセットがない場合、システムプロパティーのセットをまず作成してから初期化します。このシステムプロパティーのセットには、常に次のキーの値が含まれます。

キー 対応する値の説明
java.version Java Runtime Environment のバージョン
java.vendor Java Runtime Environment のベンダー
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 Runtime Environment 仕様のバージョン
java.specification.vendor Java Runtime Environment 仕様のベンダー
java.specification.name Java Runtime Environment の仕様名
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

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 - セキュリティーマネージャーが存在し、セキュリティーマネージャーの checkPropertiesAccess メソッドが、指定されたシステムプロパティーへのアクセスを許可しない場合
NullPointerException - keynull の場合
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 - セキュリティーマネージャーが存在し、セキュリティーマネージャーの checkPropertiesAccess メソッドが、指定されたシステムプロパティーへのアクセスを許可しない場合
NullPointerException - keynull の場合
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 - keynull の場合
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)

exit

public static void exit(int status)
現在実行している Java 仮想マシンを終了します。引数はステータスコードとして作用します。通例、ゼロ以外のステータスコードは異常終了を示します。  

このメソッドは Runtime クラスの exit メソッドを呼び出します。 このメソッドは通常は復帰しません。  

System.exit(n) の呼び出しの動作は、実際には次の呼び出しと同じです。

 Runtime.getRuntime().exit(n)
 

プロセスモデルが存在する場合、System.exit() はプロセスが終了してリソースが解放されるものと見込む必要があります。  

プロセスモデルが存在せずにセキュリティーマネージャーが存在する場合、セキュリティーマネージャーはデフォルトで SecurityException をスローすることにより、System.exit() の呼び出しを禁止する必要があります。そうでない場合、呼び出し時にシステムが無制限にハングアップします。 

パラメータ:
status - 終了のステータス
例外:
SecurityException - セキュリティーマネージャーが存在し、その checkExit メソッドが、指定されたステータスでの終了を許可しない場合
関連項目:
Runtime.exit(int)

gc

public static void gc()
ガベージコレクタを実行します。  

gc メソッドの呼び出しは、現在占有しているメモリーを再度迅速に利用するために、Java 仮想マシンが使用しないオブジェクトのリサイクルを実行することを意味します。メソッドの呼び出しから制御が戻るのは、Java 仮想マシンが、破棄されたオブジェクトが占有していたスペースを最大限まで回復し終えたときです。  

System.gc() の呼び出しの動作は、実際には次の呼び出しと同じです。

 Runtime.getRuntime().gc()
 

関連項目:
Runtime.gc()

runFinalization

public static void runFinalization()
ファイナライズを保留しているオブジェクトのファイナライズメソッドを実行します。  

このメソッドを呼び出すと、Java 仮想マシンが、破棄されていることがわかっていて finalize メソッドが実行されていないオブジェクトに対して finalize メソッドの実行が試行されます。メソッドの呼び出しから制御が戻るのは、Java 仮想マシンが、すべての未処理のファイナライズを最大限まで完了し終えたときです。  

System.runFinalization() の呼び出しの動作は、実際には次の呼び出しと同じです。

 Runtime.getRuntime().runFinalization()
 

関連項目:
Runtime.runFinalization()

load

public static void load(String filename)
指定されたファイル名を持つコードファイルを、ダイナミックライブラリとしてローカルファイルシステムからロードします。filename 引数は完全なパス名である必要があります。  

System.load(name) の呼び出しの動作は、実際には次の呼び出しと同じです。

 Runtime.getRuntime().load(name)
 

パラメータ:
filename - ロードするファイル
例外:
SecurityException - セキュリティーマネージャーが存在し、セキュリティーマネージャーの checkLink メソッドが、指定されたダイナミックライブラリのロードを許可しない場合
UnsatisfiedLinkError - ファイルが存在しない場合
関連項目:
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 - ライブラリが存在しない場合
関連項目:
Runtime.loadLibrary(java.lang.String), SecurityManager.checkLink(java.lang.String)

mapLibraryName

public static String mapLibraryName(String libname)
ライブラリ名を、ネイティブライブラリを表すプラットフォーム依存の文字列にマッピングします。

パラメータ:
libname - ライブラリの名前
戻り値:
プラットフォーム依存のネイティブライブラリ名
導入されたバージョン:
1.2
関連項目:
loadLibrary(java.lang.String), ClassLoader.findLibrary(java.lang.String)

CDC 1.1.2

Copyright 2006 Sun Microsystems, Inc. All Rights Reserved. Use of this specification is subject to license terms.