CallSite Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
A CallSite ist ein Halter für eine Variable MethodHandle, die als " targetHalter" bezeichnet wird.
[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- Vererbung
- Abgeleitet
- Attribute
Hinweise
A CallSite ist ein Halter für eine Variable MethodHandle, die als " targetHalter" bezeichnet wird. Eine invokedynamic Anweisung, die mit einer CallSite Stellvertretung verknüpft ist, werden alle Aufrufe an das aktuelle Ziel der Website delegiert. A CallSite kann mehreren invokedynamic Anweisungen zugeordnet sein, oder es kann "frei unverankert" sein, die keiner zugeordnet ist. In jedem Fall kann es über ein zugeordnetes Methodenhandle aufgerufen werden, das als #dynamicInvoker dynamischer Aufrufer bezeichnet wird.
CallSite ist eine abstrakte Klasse, die keine direkte Unterklassen durch Benutzer zulässt. Sie verfügt über drei direkte, konkrete Unterklassen, die entweder instanziiert oder unterklassenweise instanziiert werden können.
<ul><li>Wenn ein änderbares Ziel nicht erforderlich ist, kann eine invokedynamic Anweisung durch eine ConstantCallSite-Konstantenaufrufwebsite dauerhaft gebunden werden.
<li>Wenn ein veränderbares Ziel erforderlich ist, das veränderliche Variablensemantik aufweist, da Aktualisierungen des Ziels sofort und zuverlässig von anderen Threads zeugen müssen, kann eine volatileCallSite-veränderliche Aufrufwebsite verwendet werden.
<li>Andernfalls kann eine MutableCallSite-Anrufwebsite verwendet werden, wenn ein änderbares Ziel erforderlich ist.
</ul>
Eine nicht konstante Anrufwebsite kann <durch Ändern des Ziels erneut verknüpft>/em< sein>. Das neue Ziel muss denselben MethodHandle#type()-Typ aufweisen wie das vorherige Ziel. Daher kann eine Anrufwebsite zwar mit einer Reihe aufeinander folgender Ziele verknüpft werden, aber sie kann den Typ nicht ändern.
Hier ist eine Beispielverwendung von Aufrufwebsites und Bootstrap-Methoden, die jede dynamische Aufrufwebsite verknüpft, um ihre Argumente zu drucken: <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 Dokumentation für java.lang.invoke.CallSite.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Konstruktoren
| Name | Beschreibung |
|---|---|
| CallSite(IntPtr, JniHandleOwnership) |
A |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Class |
Gibt die Laufzeitklasse dieses Werts |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| JniIdentityHashCode |
Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object) |
| JniManagedPeerState |
A |
| JniPeerMembers |
A |
| PeerReference |
Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object) |
| Target |
A |
| ThresholdClass |
A |
| ThresholdType |
A |
Methoden
| Name | Beschreibung |
|---|---|
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
A |
| Dispose() |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| Dispose(Boolean) |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| DisposeUnlessReferenced() |
A |
| DynamicInvoker() |
Erzeugt ein Methodenhandle, das einer aufrufdynamischen Anweisung entspricht, die mit dieser Aufrufwebsite verknüpft wurde. |
| Equals(Object) |
A |
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
A |
| ToArray<T>() |
Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| Type() |
Gibt den Typ des Ziels dieser Anrufwebsite zurück. |
| UnregisterFromRuntime() |
Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object) |
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IJavaPeerable.Disposed() |
A |
| IJavaPeerable.Finalized() |
A |
| IJavaPeerable.JniObjectReferenceControlBlock |
A |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
A |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
A |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
A |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
A |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |