Proxy Klasse

Definition

[Android.Runtime.Register("java/lang/reflect/Proxy", DoNotGenerateAcw=true)]
public class Proxy : Java.Lang.Object, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("java/lang/reflect/Proxy", DoNotGenerateAcw=true)>]
type Proxy = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Vererbung

Object

JavaObject

Object

Proxy

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable ISerializable IDisposable

Hinweise

Proxy stellt statische Methoden zum Erstellen dynamischer Proxyklassen und Instanzen bereit, und es ist auch die Superklasse aller von diesen Methoden erstellten dynamischen Proxyklassen.

So erstellen Sie einen Proxy für einige Schnittstellen Foo:

InvocationHandler handler = new MyInvocationHandler(...);
                Class<?> proxyClass = Proxy.getProxyClass(Foo.class.getClassLoader(), Foo.class);
                Foo f = (Foo) proxyClass.getConstructor(InvocationHandler.class).
                                newInstance(handler);

oder einfacher:

Foo f = (Foo) Proxy.newProxyInstance(Foo.class.getClassLoader(),
                                                     new Class<?>[] { Foo.class },
                                                     handler);

Eine dynamische Proxyklasse (einfach unten als Proxyklasse bezeichnet) ist eine Klasse, die eine Liste der Schnittstellen implementiert, die zur Laufzeit angegeben sind, wenn die Klasse erstellt wird, mit Verhalten, wie unten beschrieben.

Eine Proxyschnittstelle ist eine solche Schnittstelle, die von einer Proxyklasse implementiert wird.

Eine Proxyinstanz ist eine Instanz einer Proxyklasse.

Jede Proxyinstanz verfügt über ein zugeordnetes Aufrufhandlerobjekt , das die Schnittstelle InvocationHandlerimplementiert. Ein Methodenaufruf für eine Proxyinstanz über eine seiner Proxyschnittstellen wird an die InvocationHandler#invoke invoke Methode des Aufrufhandlers der Instanz, übergeben die Proxyinstanz, ein java.lang.reflect.Method Objekt, das die aufgerufene Methode identifiziert, und ein Array vom Typ Object , der die Argumente enthält. Der Aufrufhandler verarbeitet den codierten Methodenaufruf entsprechend, und das ergebnis, das zurückgegeben wird, wird als Ergebnis des Methodenaufrufs in der Proxyinstanz zurückgegeben.

Eine Proxyklasse verfügt über die folgenden Eigenschaften:

<ul><li>Proxyklassen sind <öffentlich>, final und nicht abstrakt</em> , wenn alle Proxyschnittstellen öffentlich sind.</li>

<li-Proxyklassen>sind <nicht>öffentlich, endgültig und nicht abstrakt</em> , wenn eine der Proxyschnittstellen nicht öffentlich ist.</li>

<li>Der nicht qualifizierte Name einer Proxyklasse ist nicht angegeben. Der Abstand von Klassennamen, die mit der Zeichenfolge "$Proxy" beginnen, sollte jedoch für Proxyklassen reserviert sein.

<li>A Proxyklasse erweitert java.lang.reflect.Proxy.

<li>Eine Proxyklasse implementiert genau die Schnittstellen, die bei der Erstellung angegeben wurden, in derselben Reihenfolge.

<li>Wenn eine Proxyklasse eine nicht öffentliche Schnittstelle implementiert, wird sie im selben Paket wie diese Schnittstelle definiert. Andernfalls ist das Paket einer Proxyklasse ebenfalls nicht angegeben. Beachten Sie, dass die Paketversiegelung nicht verhindert, dass eine Proxyklasse erfolgreich in einem bestimmten Paket zur Laufzeit definiert wird, und weder klassen, die bereits vom gleichen Klassenladeprogramm und demselben Paket mit bestimmten Signierern definiert wurden.

<li>Da eine Proxyklasse alle schnittstellen implementiert, die bei der Erstellung angegeben wurden, gibt das Aufrufen getInterfaces des Class Objekts ein Array zurück, das dieselbe Liste von Schnittstellen enthält (in der Reihenfolge, die bei der Erstellung angegeben ist), gibt das Aufrufen getMethods des Class Objekts ein Array von Method Objekten zurück, die alle Methoden in diesen Schnittstellen enthalten, und das Aufrufen getMethod findet Methoden in den Proxyschnittstellen wie erwartet.

<li>The Proxy#isProxyClass Proxy.isProxyClass method will return true if it is passed a proxy class - a class returned by Proxy.getProxyClass or the class of an object returned by Proxy.newProxyInstance-- and false otherwise.

<li>Die java.security.ProtectionDomain Proxyklasse ist identisch mit der von dem Bootstrap-Klassenladeprogramm geladenen Systemklassen, z java.lang.Object. B. weil der Code für eine Proxyklasse durch vertrauenswürdigen Systemcode generiert wird. Diese Schutzdomäne wird in der Regel gewährt java.security.AllPermission.

<li>Each proxy class has one public constructor that takes one argument, an implementation of the interface InvocationHandler, to set the invocation handler for a proxy instance. Anstatt die Spiegelungs-API für den Zugriff auf den öffentlichen Konstruktor verwenden zu müssen, kann auch eine Proxyinstanz durch Aufrufen der Proxy#newProxyInstance Proxy.newProxyInstance Methode erstellt werden, die die Aufrufaktionen mit dem Aufrufen Proxy#getProxyClass Proxy.getProxyClass des Konstruktors mit einem Aufrufhandler kombiniert. </ul>

Eine Proxyinstanz verfügt über die folgenden Eigenschaften:

<ul><li>Aufgrund einer Proxyinstanz proxy und einer der Schnittstellen, die von der Proxyklasse Fooimplementiert werden, gibt der folgende Ausdruck "true" zurück:

{@code proxy instanceof Foo}

und der folgende Umwandlungsvorgang wird erfolgreich ausgeführt (anstatt einen ClassCastException):

{@code (Foo) proxy}

<li>Each proxy instance has an associated invocation handler, the one that was passed to its constructor. Die statische Proxy#getInvocationHandler Proxy.getInvocationHandler Methode gibt den Aufrufhandler zurück, der der Proxyinstanz zugeordnet ist, die als Argument übergeben wird.

<li>Ein Aufruf der Schnittstellenmethode für eine Proxyinstanz wird codiert und an die Methode des Aufrufhandlers InvocationHandler#invoke invoke verteilt, wie in der Dokumentation für diese Methode beschrieben.

<li>Ein Aufruf der hashCodeequalstoStringin einer Proxyinstanz deklarierten java.lang.Object Methoden wird codiert und auf die Methode des Aufrufhandlers invoke auf die gleiche Weise wie Schnittstellenmethodenaufrufe codiert und verteilt, wie oben beschrieben. Die deklarierende Klasse des objekts, an das Methodinvoke übergeben wird, ist java.lang.Object. Andere öffentliche Methoden einer von einer proxyinstanz geerbten java.lang.Object Proxyinstanz werden nicht von einer Proxyklasse überschrieben, daher verhalten sich Aufrufe dieser Methoden wie für Instanzen von java.lang.Object. </ul>

<h3-Methoden>in mehreren Proxyschnittstellen</h3 dupliziert>

Wenn zwei oder mehr Schnittstellen einer Proxyklasse eine Methode mit der gleichen Namens- und Parametersignatur enthalten, wird die Reihenfolge der Schnittstellen der Proxyklasse erheblich. Wenn eine solche duplizierte Methode für eine Proxyinstanz aufgerufen wird, ist das Method an den Aufrufhandler übergebene Objekt nicht notwendigerweise das Objekt, dessen deklarierende Klasse vom Referenztyp der Schnittstelle zugewiesen werden kann, über die die Methode des Proxys aufgerufen wurde. Diese Einschränkung ist vorhanden, da die entsprechende Methodenimplementierung in der generierten Proxyklasse nicht bestimmen kann, über welche Schnittstelle sie aufgerufen wurde. Wenn daher eine duplizierte Methode für eine Proxyinstanz aufgerufen wird, wird das Method Objekt für die Methode in der wichtigsten Schnittstelle, die die Methode enthält (entweder direkt oder durch eine Superinterface geerbt), in der Liste der Schnittstellen der Proxyklasse an die Methode des Aufrufhandlers invoke übergeben, unabhängig vom Verweistyp, über den die Methode aufgerufen wurde.

Wenn eine Proxyschnittstelle eine Methode mit demselben Namen und der gleichen Parametersignatur enthält wie die hashCode, equalsoder toString Methoden von java.lang.Object, wenn eine solche Methode in einer Proxyinstanz aufgerufen wird, hat das Method objekt, das an den Aufrufhandler übergeben wird java.lang.Object , als deklarierende Klasse. Mit anderen Worten: Die öffentlichen, nicht endgültigen Methoden, die java.lang.Object logisch allen Proxyschnittstellen vorausgehen, um zu bestimmen, welches Method Objekt an den Aufrufhandler übergeben werden soll.

Beachten Sie außerdem, dass die invoke Methode, wenn eine duplizierte Methode an einen Aufrufhandler verteilt wird, nur überprüfte Ausnahmetypen auslösen kann, die einem der Ausnahmetypen in der throws Klausel der Methode in allen Proxyschnittstellen zugewiesen werden können, über die sie aufgerufen werden kann. Wenn die invoke Methode eine überprüfte Ausnahme auslöst, die keiner der von der Methode deklarierten Ausnahmetypen in einer der Proxyschnittstellen, über die sie aufgerufen werden kann, zugewiesen werden kann, wird durch den Aufruf der Proxyinstanz ein deaktivierter UndeclaredThrowableException Fehler ausgelöst. Diese Einschränkung bedeutet, dass nicht alle Ausnahmetypen, die durch Aufrufen getExceptionTypes des an die Method Methode übergebenen Objekts zurückgegeben werden, von der invoke Methode erfolgreich invoke ausgelöst werden können.

In 1.3 hinzugefügt.

Java Dokumentation für java.lang.reflect.Proxy.

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.