モジュール jdk.management.resource

パッケージ jdk.management.resource

クラスResourceContextFactory

java.lang.Object

jdk.management.resource.ResourceContextFactory

@Deprecated(since="10",
            forRemoval=true)
public final class ResourceContextFactory
extends Object

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

リソース管理は、置き換えのない削除のために推奨されていません。

ResourceContextFactoryは、ResourceContext機能へのアクセスを提供します。 ファクトリは次を行うメソッドを提供します。

• ResourceContextFactoryインスタンスを返し、APIが呼出し元にアクセスできるかどうかを確認します
• ResourceContextsがenabledかどうかをチェックします
• 新しいResourceContextを返します
• 名前でResourceContextを返します
• 現在のスレッドにバインドされているResourceContextを返します
• バインドなしのスレッドすべてに使用されるUnassignedContextを返します
• すべてのコンテキストの合計を追跡するTotalsContextを返します
• ResourceContextのストリームを返します
• サポートされているResourceTypesを返します

getInstanceメソッドは、SecurityManagerのインストールとRuntimePermission("jdk.management.resource.getResourceContextFactory")の許可の有無を確認します。 ResourceContextFactoryの参照は機能であり、共有できません。

ResourceContextFactoryの初期化時に存在したThreadがシステム・スレッドでない場合、そのスレッドはunassignedContextにバインドされています。 ((thread.getThreadGroup().getParent() == nullが指定された)システム・スレッドは、unassignedContextにバインドされていません。 システム・スレッドによって使用されるリソースは記録されません。

導入されたバージョン:

8u40

メソッドのサマリー

修飾子と型	メソッド	説明
Stream<ResourceContext>	contexts()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 既存のResourceContextのストリームを返します。
ResourceContext	create(String name)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 新しいResourceContextを作成します。
static ResourceContextFactory	getInstance()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 ResourceContextのファクトリを返します(実行時に有効化された場合)。
ResourceRequest	getResourceRequest(ResourceType type)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 現在のResourceContextおよびResourceTypeのResourceRequestを返します。
ResourceContext	getThreadContext()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 現在のスレッドに関連付けられているResourceContextを返します。
ResourceContext	getThreadContext(Thread thread)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 スレッドに関連付けられているResourceContextを返します。
ResourceContext	getTotalsContext()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 すべてのResourceContextの合計を提供するResourceContextを返します。
ResourceContext	getUnassignedContext()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 スレッドがResourceContextに関連付けられていない場合に、デフォルトのResourceContextを返します。
static boolean	isEnabled()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 ResourceManagementがenabledの場合のみ、trueを返します。
ResourceContext	lookup(String name)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 名前で指定されたResourceContextを返します。
Set<ResourceType>	supportedResourceTypes()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 現在のランタイムで利用可能な内蔵ResourceTypesの読取り専用セットを返します。

クラス java.lang.Objectで宣言されたメソッド

clone、equals、finalize、getClass、hashCode、notify、notifyAll、toString、wait、wait、wait

メソッドの詳細

isEnabled

public static boolean isEnabled()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

ResourceManagementがenabledの場合のみ、trueを返します。 利用可能なリソースのセットについては、supportedResourceTypes()を参照してください。

戻り値:

ResourceManagementがenabledの場合のみtrue、それ以外はfalse

例外:

SecurityException - SecurityManagerがインストールされ、RuntimePermission("jdk.management.resource.getResourceContextFactory)が拒否される場合

getInstance

public static ResourceContextFactory getInstance()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

ResourceContextのファクトリを返します(実行時に有効化された場合)。

戻り値:

ResourceContextsのファクトリ

例外:

SecurityException - SecurityManagerがインストールされ、RuntimePermission("jdk.management.resource.getResourceContextFactory)が拒否される場合

create

public ResourceContext create(String name)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

新しいResourceContextを作成します。 新しい空のResourceContextが指定された名前で作成されます。 ResourceContextsの名前は一意であることが必要です。 closeを使用してResourceContextを破棄します。

パラメータ:

name - ResourceContextの名前

戻り値:

新しいResourceContext

例外:

IllegalArgumentException - 指定された名前のResourceContextがすでに存在する場合。

UnsupportedOperationException - ResourceContextの数が実装制限を超える場合

lookup

public ResourceContext lookup(String name)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

名前で指定されたResourceContextを返します。

パラメータ:

name - 名前

戻り値:

指定された名前のResourceContext。該当する名前のResourceContextがない場合はnull

getThreadContext

public ResourceContext getThreadContext()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

現在のスレッドに関連付けられているResourceContextを返します。

戻り値:

現在のスレッドに関連付けられているResourceContext。スレッドがどのコンテキストにも関連付けられていない場合は未割当てのコンテキスト

getThreadContext

public ResourceContext getThreadContext(Thread thread)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

スレッドに関連付けられているResourceContextを返します。

パラメータ:

thread - 問合せするスレッド

戻り値:

現在のスレッドに関連付けられているResourceContext。スレッドがどのコンテキストにも関連付けられていない場合は未割当てのコンテキスト

getResourceRequest

public ResourceRequest getResourceRequest(ResourceType type)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

現在のResourceContextおよびResourceTypeのResourceRequestを返します。 現在のスレッドに関連付けられているResourceContextがない場合は、未割当てのコンテキストが使用されます。

パラメータ:

type - リクエストするリソースのResourceType

戻り値:

ResourceRequest。該当するタイプのResourceMeterがResourceContextにない場合はnull

getUnassignedContext

public ResourceContext getUnassignedContext()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

スレッドがResourceContextに関連付けられていない場合に、デフォルトのResourceContextを返します。

戻り値:

未割当てのResourceContext

getTotalsContext

public ResourceContext getTotalsContext()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

すべてのResourceContextの合計を提供するResourceContextを返します。 メーターは、他のすべてのResourceContextの合計と、削除されたResourceContextの最終カウントを反映します。 これらのメーターは読取り専用で、アクティブなResourceContextが変更された場合にのみ更新されます。

戻り値:

ResourceContextの合計

contexts

public Stream<ResourceContext> contexts()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

既存のResourceContextのストリームを返します。

戻り値:

既存のResourceContextのストリーム

supportedResourceTypes

public Set<ResourceType> supportedResourceTypes()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

現在のランタイムで利用可能な内蔵ResourceTypesの読取り専用セットを返します。

戻り値:

現在のランタイムで利用可能な内蔵ResourceTypesの読取り専用セット、null以外