java.lang.invoke

クラス VolatileCallSite

java.lang.Object

java.lang.invoke.CallSite

java.lang.invoke.VolatileCallSite

public class VolatileCallSite
extends CallSite

VolatileCallSite は、ターゲットの動作が volatile 変数と同じであるような CallSite です。VolatileCallSite にリンクされた invokedynamic 命令は、そのコールサイトターゲットへの更新が別のスレッドで発生した場合でも、その更新を即時に認識します。そうしたスレッド間の緊密な結合のため、パフォーマンス低下が発生する可能性があります。

揮発性コールサイトでは MutableCallSite と違って syncAll 操作が存在しませんが、これは、volatile 変数への書き込みがすべてリーダースレッドに暗黙的に同期されるからです。

その他の点では、VolatileCallSite は MutableCallSite と交換可能です。

関連項目:

MutableCallSite

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
VolatileCallSite(MethodHandle target) ターゲットへの volatile バインディングを持つコールサイトを作成します。
VolatileCallSite(MethodType type) ターゲットへの volatile バインディングを持つコールサイトを作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
MethodHandle	dynamicInvoker() このコールサイトにリンクされている invokedynamic 命令と同等のメソッドハンドルを生成します。
MethodHandle	getTarget() コールサイトのターゲットメソッドを返しますが、これは、VolatileCallSite の volatile フィールドのように振る舞います。
void	setTarget(MethodHandle newTarget) このコールサイトのターゲットメソッドを volatile 変数として更新します。

クラス java.lang.invoke.CallSite から継承されたメソッド

type

クラス java.lang.Object から継承されたメソッド

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

コンストラクタの詳細

VolatileCallSite

public VolatileCallSite(MethodType type)

ターゲットへの volatile バインディングを持つコールサイトを作成します。初期ターゲットは、呼び出し時に IllegalStateException をスローするような、指定された型のメソッドハンドルに設定されます。

パラメータ:

type - このコールサイトのメソッド型

例外:

NullPointerException - 提案された型が null の場合

VolatileCallSite

public VolatileCallSite(MethodHandle target)

ターゲットへの volatile バインディングを持つコールサイトを作成します。ターゲットは指定された値に設定されます。

パラメータ:

target - コールサイトの初期ターゲットとなるメソッドハンドル

例外:

NullPointerException - 提案されたターゲットが null の場合

メソッドの詳細

getTarget

public final MethodHandle getTarget()

コールサイトのターゲットメソッドを返しますが、これは、VolatileCallSite の volatile フィールドのように振る舞います。

getTarget のメモリーとの相互作用は、volatile フィールドから読み取りを行う場合と同じです。

特に、現在のスレッドはメモリーからのターゲットの新しい読み取りを発行する必要があり、別のスレッドによるターゲットへの最新の更新を確認する必要があります。

定義:

getTarget、クラス: CallSite

戻り値:

このコールサイトのリンケージ状態 (時間とともに変わる可能性のあるメソッドハンドル)

関連項目:

setTarget(java.lang.invoke.MethodHandle)

setTarget

public void setTarget(MethodHandle newTarget)

このコールサイトのターゲットメソッドを volatile 変数として更新します。新しいターゲットの型は古いターゲットの型と同じでなければいけません。

メモリーとの相互作用は、volatile フィールドに書き込みを行う場合と同じです。具体的には、次回の getTarget 呼び出し時に更新後のターゲットを得られることが、すべてのスレッドで保証されます。

定義:

setTarget、クラス: CallSite

パラメータ:

newTarget - 新しいターゲット

例外:

NullPointerException - 提案された新しいターゲットが null の場合

WrongMethodTypeException - 提案された新しいターゲットのメソッド型が以前のターゲットと異なる場合

関連項目:

getTarget()

dynamicInvoker

public final MethodHandle dynamicInvoker()

このコールサイトにリンクされている invokedynamic 命令と同等のメソッドハンドルを生成します。

このメソッドは次のコードと同等です。

 MethodHandle getTarget, invoker, result;
 getTarget = MethodHandles.publicLookup().bind(this, "getTarget", MethodType.methodType(MethodHandle.class));
 invoker = MethodHandles.exactInvoker(this.type());
 result = MethodHandles.foldArguments(invoker, getTarget)
 

定義:

dynamicInvoker、クラス: CallSite

戻り値:

このコールサイトの現在のターゲットを常に呼び出すメソッドハンドル