CallSite Classe

Définition

[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

Héritage

Object

JavaObject

Object

CallSite

Dérivé

Java.Lang.Invoke.ConstantCallSite

Java.Lang.Invoke.MutableCallSite

Java.Lang.Invoke.VolatileCallSite

Attributs

RegisterAttribute

Remarques

A CallSite est un titulaire pour une variable MethodHandle, qui est appelée son target. Instruction invokedynamic liée à un CallSite délégué tous les appels à la cible actuelle du site. Un CallSite peut être associé à plusieurs invokedynamic instructions, ou il peut être « flottant libre », associé à aucun. Dans tous les cas, il peut être appelé par le biais d’un handle de méthode associé appelé son appelant dynamique #dynamicInvoker.

CallSite est une classe abstraite qui n’autorise pas la sous-classe directe par les utilisateurs. Il a trois sous-classes immédiates et concrètes qui peuvent être instanciées ou sous-classifiées. <ul><li>Si une cible mutable n’est pas requise, une invokedynamic instruction peut être liée définitivement par le biais d’un site d’appel constant ConstantCallSite. <li>Si une cible mutable est requise, qui a une sémantique de variable volatile, car les mises à jour de la cible doivent être immédiatement et de manière fiable témoin par d’autres threads, un site d’appel volatile VolatileCallSite peut être utilisé. <dans>le cas contraire, si une cible mutable est requise, un site d’appel mutable MutableCallSite peut être utilisé. </ul>

Un site d’appel non constant peut être <>relinké</em> en modifiant sa cible. La nouvelle cible doit avoir le même type MethodHandle#type() que la cible précédente. Par conséquent, bien qu’un site d’appel puisse être relinké à une série de cibles successives, il ne peut pas modifier son type.

Voici un exemple d’utilisation de sites d’appel et de méthodes d’amorçage qui lie chaque site d’appel dynamique pour imprimer ses arguments : <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 documentation pour java.lang.invoke.CallSite.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.