JavaTM Platform
Standard Ed. 6

java.lang.management
インタフェース OperatingSystemMXBean


public interface OperatingSystemMXBean

Java 仮想マシンを実行しているオペレーティングシステムの管理インタフェースを返します。

Java 仮想マシンは、このインタフェースの実装クラスの単一インスタンスを持ちます。このインタフェースを実装しているインスタンスは、ManagementFactory.getOperatingSystemMXBean() メソッドを呼び出して取得できる、あるいは platform MBeanServer メソッドから取得できる MXBean です。

MBeanServer 内でオペレーティングシステムの MXBean を一意に識別するための ObjectName は以下のとおりです。

java.lang:type=OperatingSystem

このインタフェースは、Java 仮想マシンを実行しているオペレーティングシステムのシステムプロパティーにアクセスする複数の簡易メソッドを定義します。

導入されたバージョン:
1.5
関連項目:
JMX 仕様。, MXBean にアクセスする方法

メソッドの概要
 String getArch()
          オペレーティングシステムのアーキテクチャーを返します。
 int getAvailableProcessors()
          Java 仮想マシンが利用可能なプロセッサの数を返します。
 String getName()
          オペレーティングシステム名を返します。
 double getSystemLoadAverage()
          最後の 1 分のシステム負荷平均を返します。
 String getVersion()
          オペレーティングシステムのバージョンを返します。
 

メソッドの詳細

getName

String getName()
オペレーティングシステム名を返します。このメソッドは System.getProperty("os.name") と同等です。

戻り値:
オペレーティングシステム名
例外:
SecurityException - セキュリティーマネージャーが存在し、 checkPropertiesAccess メソッドが このシステムプロパティーへのアクセスを許可しない場合
関連項目:
SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getArch

String getArch()
オペレーティングシステムのアーキテクチャーを返します。このメソッドは System.getProperty("os.arch") と同等です。

戻り値:
オペレーティングシステムのアーキテクチャー
例外:
SecurityException - セキュリティーマネージャーが存在し、 checkPropertiesAccess メソッドが このシステムプロパティーへのアクセスを許可しない場合
関連項目:
SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getVersion

String getVersion()
オペレーティングシステムのバージョンを返します。このメソッドは System.getProperty("os.version") と同等です。

戻り値:
オペレーティングシステムのバージョン
例外:
SecurityException - セキュリティーマネージャーが存在し、 checkPropertiesAccess メソッドが このシステムプロパティーへのアクセスを許可しない場合
関連項目:
SecurityManager.checkPropertyAccess(java.lang.String), System.getProperty(java.lang.String)

getAvailableProcessors

int getAvailableProcessors()
Java 仮想マシンが利用可能なプロセッサの数を返します。このメソッドは、Runtime.availableProcessors() メソッドと同等です。

この値は、仮想マシンの特定の呼び出しの間に変化する可能性があります。

戻り値:
仮想マシンから利用可能なプロセッサ数。 この値が 1 より小さくなることはない

getSystemLoadAverage

double getSystemLoadAverage()
最後の 1 分のシステム負荷平均を返します。システム負荷平均とは、利用可能なプロセッサ のキューに入れられた実行可能なエンティティーの数と、ある期間で平均した、利用可能なプロセッサで実行されている実行可能なエンティティーの数の合計です。負荷平均の計算方法はオペレーティングシステムによって異なりますが、通常は、減衰時間依存平均が使用されます。

負荷平均を利用できない場合は、負の値が返されます。

このメソッドは、システム負荷のヒントを提供するために設計されていて、頻繁に照会できます。このメソッドを実装するのに高額な費用を要するプラットフォームでは、負荷平均を利用できないことがあります。

戻り値:
システム負荷平均。利用できない場合は負の値
導入されたバージョン:
1.6

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。