CallSite クラス

定義

[Android.Runtime.Register("java/lang/invoke/CallSite", ApiSince=26, DoNotGenerateAcw=true)]
public abstract class CallSite : Java.Lang.Object

[<Android.Runtime.Register("java/lang/invoke/CallSite", ApiSince=26, DoNotGenerateAcw=true)>]
type CallSite = class
    inherit Object

継承

Object

JavaObject

Object

CallSite

派生

Java.Lang.Invoke.ConstantCallSite

Java.Lang.Invoke.MutableCallSite

Java.Lang.Invoke.VolatileCallSite

属性

RegisterAttribute

注釈

CallSiteは変数MethodHandleのホルダーであり、そのtargetと呼ばれます。 invokedynamicにリンクされているCallSite命令は、サイトの現在のターゲットへのすべての呼び出しを委任します。 CallSiteは、複数のinvokedynamic命令に関連付けられているか、"フリー フローティング" で、何も関連付けられていない場合があります。 いずれの場合も、#dynamicInvoker 動的呼び出し子と呼ばれる関連付けられたメソッド ハンドルを介して呼び出すことができます。

CallSite は、ユーザーによる直接サブクラス化を許可しない抽象クラスです。 これには、インスタンス化またはサブクラス化できる 3 つの即時の具象サブクラスがあります。 <ul><li>変更可能なターゲットが不要な場合は、ConstantCallSite 定数呼び出しサイトを使用して、 invokedynamic 命令を永続的にバインドできます。 <li>揮発性変数セマンティクスを持つ変更可能なターゲットが必要な場合は、ターゲットの更新を他のスレッドによって直ちに確実に監視する必要があるため、VolatileCallSite 揮発性呼び出しサイトを使用できます。 <li>変更可能なターゲットが必要な場合は、MutableCallSite の変更可能な呼び出しサイトを使用できます。 </ul>

非定数呼び出しサイトは、ターゲットを変更することによって <em>relinked</em> できます。 新しいターゲットには、前のターゲットと同じ MethodHandle#type() 型が必要です。 したがって、呼び出しサイトは連続する一連のターゲットに再リンクできますが、その種類を変更することはできません。

呼び出しサイトとブートストラップ メソッドの使用例を次に示します。各動的呼び出しサイトをリンクしてその引数を出力します。 <blockquote>

{@code
            static void test() throws Throwable {
                // THE FOLLOWING LINE IS PSEUDOCODE FOR A JVM INSTRUCTION
                InvokeDynamic[#bootstrapDynamic].baz("baz arg", 2, 3.14);
            }
            private static void printArgs(Object... args) {
              System.out.println(java.util.Arrays.deepToString(args));
            }
            private static final MethodHandle printArgs;
            static {
              MethodHandles.Lookup lookup = MethodHandles.lookup();
              Class thisClass = lookup.lookupClass();  // (who am I?)
              printArgs = lookup.findStatic(thisClass,
                  "printArgs", MethodType.methodType(void.class, Object[].class));
            }
            private static CallSite bootstrapDynamic(MethodHandles.Lookup caller, String name, MethodType type) {
              // ignore caller and name, but match the type:
              return new ConstantCallSite(printArgs.asType(type));
            }
            }

</blockquote>

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。