モジュール java.base

パッケージ java.lang.classfile^PREVIEW

インタフェースClassHierarchyResolver

関数型インタフェース:

これは関数型インタフェースなので、ラムダ式またはメソッド参照の代入先として使用できます。

@FunctionalInterface public interface ClassHierarchyResolver

ClassHierarchyResolverは、JavaプラットフォームのプレビューAPIです。

プレビュー機能が有効な場合のみ、プログラムでClassHierarchyResolverを使用できます。

プレビュー機能は、今後のリリースで削除するか、Javaプラットフォームの永続機能にアップグレードすることができます。

コード構築中に正しいスタック・マップを生成するためのクラス階層情報を提供します。

導入されたバージョン:

22

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	インタフェース	説明
static interface	ClassHierarchyResolver.ClassHierarchyInfoPREVIEW	Preview. 解決済みクラスに関する情報。

メソッドのサマリー

修飾子と型	メソッド	説明
default ClassHierarchyResolverPREVIEW	cached()	このリゾルバからクラス階層情報をキャッシュするClassHierarchyResolverを返します。
default ClassHierarchyResolverPREVIEW	cached(Supplier<Map<ClassDesc,ClassHierarchyResolver.ClassHierarchyInfoPREVIEW>> cacheFactory)	このリゾルバからクラス階層情報をキャッシュするClassHierarchyResolverを返します。
static ClassHierarchyResolverPREVIEW	defaultResolver()	リフレクションを使用してシステム・クラス・ローダーからClassHierarchyResolver.ClassHierarchyInfoPREVIEWを取得するClassHierarchyResolverPREVIEWのデフォルト・インスタンスを返します。
ClassHierarchyResolver.ClassHierarchyInfoPREVIEW	getClassInfo(ClassDesc classDesc)	指定されたクラス名のClassHierarchyResolver.ClassHierarchyInfoPREVIEWを返します。リゾルバで名前が不明な場合はnullを返します。
static ClassHierarchyResolverPREVIEW	of(Collection<ClassDesc> interfaces, Map<ClassDesc,ClassDesc> classToSuperClass)	クラス階層メタデータのコレクションからクラス階層情報を抽出するClassHierarchyResolverPREVIEWを返します
static ClassHierarchyResolverPREVIEW	ofClassLoading(ClassLoader loader)	ClassLoaderを使用してReflection APIを介してクラス階層情報を抽出するClassHierarchyResolverを返します。
static ClassHierarchyResolverPREVIEW	ofClassLoading(MethodHandles.Lookup lookup)	Lookupを使用してReflection APIを介してクラス階層情報を抽出するClassHierarchyResolverを返します。
static ClassHierarchyResolverPREVIEW	ofResourceParsing(ClassLoader loader)	クラス・ローダーによって配置されたクラス・ファイルからクラス階層情報を抽出するClassHierarchyResolverPREVIEWを返します。
static ClassHierarchyResolverPREVIEW	ofResourceParsing(Function<ClassDesc,InputStream> classStreamResolver)	マッピング関数によって配置されたクラス・ファイルからクラス階層情報を抽出するClassHierarchyResolverPREVIEWを返します。
default ClassHierarchyResolverPREVIEW	orElse(ClassHierarchyResolverPREVIEW other)	このClassHierarchyResolverPREVIEWを、指定されたクラスについてこのリゾルバが認識していない場合に参照する別のClassHierarchyResolverPREVIEWと連鎖します。

メソッドの詳細

defaultResolver

static ClassHierarchyResolverPREVIEW defaultResolver()

リフレクションを使用してシステム・クラス・ローダーからClassHierarchyResolver.ClassHierarchyInfo^PREVIEWを取得するClassHierarchyResolver^PREVIEWのデフォルト・インスタンスを返します。

戻り値:

リフレクションを使用してシステム・クラス・ローダーからClassHierarchyResolver.ClassHierarchyInfo^PREVIEWを取得するClassHierarchyResolver^PREVIEWのデフォルト・インスタンス

getClassInfo

ClassHierarchyResolver.ClassHierarchyInfoPREVIEW getClassInfo(ClassDesc classDesc)

指定されたクラス名のClassHierarchyResolver.ClassHierarchyInfo^PREVIEWを返します。リゾルバで名前が不明な場合はnullを返します。

パラメータ:

classDesc - クラスの記述子

戻り値:

指定されたクラス名のClassHierarchyResolver.ClassHierarchyInfo^PREVIEW、またはリゾルバで名前が不明な場合はnull

例外:

IllegalArgumentException - クラスを階層に問い合せるべきでない場合

orElse

default ClassHierarchyResolverPREVIEW orElse(ClassHierarchyResolverPREVIEW other)

このClassHierarchyResolver^PREVIEWを、指定されたクラスについてこのリゾルバが認識していない場合に参照する別のClassHierarchyResolver^PREVIEWと連鎖します。

実装要件:

デフォルトの実装では、このリゾルバがnullを返す場合に、他のリゾルバに問い合せるために実装されたリゾルバが返されます。

パラメータ:

other - 他のリゾルバ

戻り値:

連鎖リゾルバ

cached

default ClassHierarchyResolverPREVIEW cached(Supplier<Map<ClassDesc,ClassHierarchyResolver.ClassHierarchyInfoPREVIEW>> cacheFactory)

このリゾルバからクラス階層情報をキャッシュするClassHierarchyResolverを返します。 委任リゾルバが別の方法で返された場合、返されたリゾルバは更新されません。 返されるリゾルバのスレッド・セーフティは、cacheFactoryによって返されるマップのスレッド・セーフティに依存します。

実装要件:

デフォルトの実装では、cacheFactoryによって提供されるキャッシュ・マップのインスタンスを保持するリゾルバが返されます。 キャッシュ・マップは常に最初に要求され、キャッシュ・マップにすべての解決済および未解決のクラス情報が入力されます。 キャッシュ・マップは、nullキーおよび値を拒否する場合があります。

パラメータ:

cacheFactory - キャッシュのファクトリ

戻り値:

キャッシュを使用したClassHierarchyResolver

cached

default ClassHierarchyResolverPREVIEW cached()

このリゾルバからクラス階層情報をキャッシュするClassHierarchyResolverを返します。 委任リゾルバが別の方法で返された場合、返されたリゾルバは更新されません。 返されたリゾルバはスレッド・セーフではありません。

MethodHandles.Lookup lookup = ...;
ClassHierarchyResolver resolver = ClassHierarchyResolver.ofClassLoading(lookup).cached();

実装要件:

デフォルトの実装では、HashMapサプライヤをcacheFactoryとしてcached(Supplier)がコールされます。

戻り値:

ClassHierarchyResolver

ofResourceParsing

static ClassHierarchyResolverPREVIEW ofResourceParsing(Function<ClassDesc,InputStream> classStreamResolver)

マッピング関数によって配置されたクラス・ファイルからクラス階層情報を抽出するClassHierarchyResolver^PREVIEWを返します。 マッピング関数は、クラス・ファイルにマッピングを提供できない場合、nullを返す必要があります。 指定された入力ストリームからのIOExceptionは、UncheckedIOExceptionとして再スローされます。

パラメータ:

classStreamResolver - クラス記述子をクラス・ファイル入力ストリームにマップします。

戻り値:

the ClassHierarchyResolver^PREVIEW

ofResourceParsing

static ClassHierarchyResolverPREVIEW ofResourceParsing(ClassLoader loader)

クラス・ローダーによって配置されたクラス・ファイルからクラス階層情報を抽出するClassHierarchyResolver^PREVIEWを返します。

パラメータ:

loader - クラス・ローダー、クラス・ファイルの検索

戻り値:

the ClassHierarchyResolver^PREVIEW

of

static ClassHierarchyResolverPREVIEW of(Collection<ClassDesc> interfaces, Map<ClassDesc,ClassDesc> classToSuperClass)

クラス階層メタデータのコレクションからクラス階層情報を抽出するClassHierarchyResolver^PREVIEWを返します

パラメータ:

interfaces - インタフェースと認識されるクラスの集合

classToSuperClass - クラスからスーパークラスへのマップ

戻り値:

the ClassHierarchyResolver^PREVIEW

ofClassLoading

static ClassHierarchyResolverPREVIEW ofClassLoading(ClassLoader loader)

ClassLoaderを使用してReflection APIを介してクラス階層情報を抽出するClassHierarchyResolverを返します。

パラメータ:

loader - クラス・ローダー

戻り値:

クラス階層リゾルバ

ofClassLoading

static ClassHierarchyResolverPREVIEW ofClassLoading(MethodHandles.Lookup lookup)

Lookupを使用してReflection APIを介してクラス階層情報を抽出するClassHierarchyResolverを返します。 解決されたクラスが指定されたルックアップにアクセスできない場合、nullを返すのではなく、IllegalArgumentExceptionがスローされます。

パラメータ:

lookup - ルックアップ、解決するクラスにアクセスできる必要があります。

戻り値:

クラス階層リゾルバ