ObjectProxy

Paket	mx.utils
Klasse	public dynamic class ObjectProxy
Vererbung	ObjectProxy Proxy
Implementiert	IExternalizable, IPropertyChangeNotifier
Unterklassen	DataItem, ManagedObjectProxy

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Diese Klasse bietet die Möglichkeit zum Verfolgen von Änderungen an einem Element, das von diesem Proxy verwaltet wird. Eine beliebige Anzahl von Objekten kann auf Änderungen an diesem Objekt „warten“, indem die addEventListener()-Methode verwendet wird.

Öffentliche Eigenschaften

	Eigenschaft		Definiert von
		uid : String Der eindeutige Bezeichner für dieses Objekt.	ObjectProxy

Geschützte Eigenschaften

	Eigenschaft		Definiert von
		dispatcher : EventDispatcher Ein Verweis auf den EventDispatcher für diesen Proxy.	ObjectProxy
		notifiers : Object Eine Hashzuordnung der Eigenschaftsänderungs-Benachrichtigung, auf die dieser Proxy wartet. Der Schlüssel der Zuordnung ist der Eigenschaftsname.	ObjectProxy
		object : Object [schreibgeschützt] Das Objekt, für das ein Proxy erstellt wird.	ObjectProxy
		propertyList : Array Enthält eine Liste aller Eigenschaftsnamen des über die Proxy-Klasse zugänglich gemachten Objekts.	ObjectProxy
		proxyClass : Class Gibt bei der Proxyerstellung für komplexe Eigenschaften die zu erstellende Proxyart an.	ObjectProxy
		type : QName Der qualifizierte Typname, der mit diesem Objekt verknüpft ist.	ObjectProxy

Öffentliche Methoden

	Methode		Definiert von
		ObjectProxy(item:Object = null, uid:String = null, proxyDepth:int = -1) Initialisiert diesen Proxy mit dem angegebenen Objekt, der ID und der Proxytiefe.	ObjectProxy
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	ObjectProxy
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	ObjectProxy
		hasEventListener(type:String):Boolean Überprüft, ob Ereignis-Listener für einen bestimmten Ereignistyp registriert sind.	ObjectProxy
		propertyChangeHandler(event:PropertyChangeEvent):void Wird aufgerufen, wenn eine komplexe Eigenschaft aktualisiert wird.	ObjectProxy
		readExternal(input:IDataInput):void Da Flex nur ObjectProxy zum Einschließen anonymer Objekte verwendet, serialisiert sich die flex.messaging.io.ObjectProxy-Serverinstanz selbst als Zuordnung, die als einfaches ActionScript-Objekt zurückgegeben wird.	ObjectProxy
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Ereignis-Listener.	ObjectProxy
		willTrigger(type:String):Boolean Überprüft, ob ein Ereignislistener bei diesem Objekt oder einem Vorgänger für diesen Ereignistyp registriert ist.	ObjectProxy
		writeExternal(output:IDataOutput):void Da Flex nur das innere eingeschlossene ActionScript-Objekt serialisiert, füllt sich das flex.messaging.io.ObjectProxy-Serverobjekt mit dem Inhalt des anonymen Objekts und wird dem Benutzer als Zuordnung angezeigt.	ObjectProxy

Geschützte Methoden

	Methode		Definiert von
		callProperty(name:, ... rest): [override] Gibt den Namen der Methode des über die Proxy-Klasse zugänglich gemachten Objekts zurück.	ObjectProxy
		deleteProperty(name:*):Boolean [override] Löscht die angegebene Eigenschaft des über die Proxy-Klasse zugänglich gemachten Objekts und benachrichtigt die Prozedur von der Löschung.	ObjectProxy
		getComplexProperty(name:, value:):* Bietet Unterklassen einen Bereich, um die Verwaltung einer komplexen Eigenschaft zu überschreiben, die entweder über die Proxy-Klasse zugänglich gemacht oder für Ereignis-Bubbling verkettet werden muss.	ObjectProxy
		getProperty(name:): [override] Gibt den angegebenen Eigenschaftswert des über die Proxy-Klasse zugänglich gemachten Objekts zurück.	ObjectProxy
		setProperty(name:, value:):void [override] Aktualisiert die angegebene Eigenschaft des über die Proxy-Klasse zugänglich gemachten Objekts und benachrichtigt die Prozedur von der Aktualisierung.	ObjectProxy
		setupPropertyList():void Diese Methode erstellt ein Array aller Eigenschaftsnamen des über die Proxy-Klasse zugänglich gemachten Objekts.	ObjectProxy

Eigenschaftendetails

dispatcher

Eigenschaft

protected var dispatcher:EventDispatcher

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ein Verweis auf den EventDispatcher für diesen Proxy.

notifiers

Eigenschaft

protected var notifiers:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Eine Hashzuordnung der Eigenschaftsänderungs-Benachrichtigung, auf die dieser Proxy wartet. Der Schlüssel der Zuordnung ist der Eigenschaftsname.

object

Eigenschaft

object:Object [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Das Objekt, für das ein Proxy erstellt wird.

Implementierung
object_proxy function get object():Object

propertyList

Eigenschaft

protected var propertyList:Array

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Enthält eine Liste aller Eigenschaftsnamen des über die Proxy-Klasse zugänglich gemachten Objekts. Untergeordnete Elemente müssen diese Liste durch Überschreiben der setupPropertyList()-Methode ausfüllen.

proxyClass

Eigenschaft

protected var proxyClass:Class

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt bei der Proxyerstellung für komplexe Eigenschaften die zu erstellende Proxyart an. Unterklassen sollten diesen Wert entsprechend zuweisen.

type

Eigenschaft

type:QName

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der qualifizierte Typname, der mit diesem Objekt verknüpft ist.

Implementierung
object_proxy function get type():QName
object_proxy function set type(value:QName):void

uid

Eigenschaft

uid:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der eindeutige Bezeichner für dieses Objekt.

Implementierung
public function get uid():String
public function set uid(value:String):void

Konstruktordetails

()

Konstruktor

public function ObjectProxy(item:Object = null, uid:String = null, proxyDepth:int = -1)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Initialisiert diesen Proxy mit dem angegebenen Objekt, der ID und der Proxytiefe.

Parameter

	`item:Object` (default = `null`) — Objekt, das als Proxy ausgeführt werden soll. Wenn kein Element festgelegt ist, wird ein anonymes Objekt erstellt und zugewiesen.

	`uid:String` (default = `null`) — String, der die eindeutige ID für die Objekt-Instanz enthält. Erforderlich für die IPropertyChangeNotifier-Kompatibilität, da für jedes Objekt eine Möglichkeit zur eindeutigen Identifizierung vorhanden sein muss. Ist kein Wert festgelegt, wird eine Zufalls-ID zugewiesen.

	`proxyDepth:int` (default = `-1`) — Eine Ganzzahl, die die Anzahl der Stufen in einem komplexen Objektdiagramm angibt, für die beim Zugriff auf Eigenschaften ein Proxy erstellt werden soll. Der Standardwert ist -1, d. h. „Proxyerstellung für eine unendliche Tiefe“.

Beispiel
Verwendung dieses Beispiels

      import mx.events.PropertyChangeEvent;
      import mx.utils.ObjectUtil;
      import mx.utils.ObjectProxy;
      import mx.utils.StringUtil;
     
      var a:Object = { name: "Tyler", age: 5, ssnum: "555-55-5555" };
      var p:ObjectProxy = new ObjectProxy(a);
      p.addEventListener(PropertyChangeEvent.PROPERTY_CHANGE, updateHandler);
      p.name = "Jacey";
      p.age = 2;
      delete p.ssnum;
     
      // handler function
      function updateHandler(event:PropertyChangeEvent):void
      {
          trace(StringUtil.substitute("updateHandler('{0}', {1}, {2}, {3}, '{4}')",
                                         event.kind,
                                         event.property,
                                         event.oldValue,
                                         event.newValue,
                                         event.target.uid));
      }
     
      // trace output
      updateHandler('opUpdate', name, Jacey, '698AF8CB-B3D9-21A3-1AFFDGHT89075CD2')
      updateHandler('opUpdate', age, 2, '698AF8CB-B3D9-21A3-1AFFDGHT89075CD2')
      updateHandler('opDelete', ssnum, null, '698AF8CB-B3D9-21A3-1AFFDGHT89075CD2')

Methodendetails

addEventListener

()

Methode

 public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Registriert ein Ereignis-Listener-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. Weitere Informationen einschließlich Parameterbeschreibungen finden Sie unter addEventListener() in der flash.events.EventDispatcher-Klasse.

Parameter

	`type:String` — Der Typ des Ereignisses.

	`listener:Function` — Die Listener-Funktion, die das Ereignis verarbeitet. Diese Funktion muss ein Ereignisobjekt als einzigen Parameter akzeptieren und darf keinen Wert zurückgeben.

	`useCapture:Boolean` (default = `false`) — Bestimmt, ob der Listener in der Erfassungsphase oder in der Ziel- und Bubbling-Phase arbeitet. Ist `useCapture` auf `true` gesetzt, so verarbeitet der Listener das Ereignis nur während der Erfassungsphase und nicht während der Ziel- oder Bubbling-Phase. Hat `useCapture` hingegen den Wert `false`, verarbeitet der Listener das Ereignis nur während der Ziel- oder Bubbling-Phase. Damit das Ereignis in allen drei Phasen aktiv ist, rufen Sie `addEventListener()` zweimal auf; einmal ist `useCapture` auf `true` gesetzt, und beim zweiten Mal hat `useCapture` den Wert `false`.

	`priority:int` (default = `0`) — Die Prioritätsstufe des Ereignis-Listeners.

	`useWeakReference:Boolean` (default = `false`) — Bestimmt, ob der Verweis auf den Listener stark oder schwach ist. Ein starker Verweis (der Standard) verhindert, dass der Listener von einem Garbage Collector entfernt wird. Ein schwacher Verweis hingegen nicht.

Verwandte API-Elemente

flash.events.EventDispatcher.addEventListener()

callProperty

()

Methode

override flash_proxy function callProperty(name:*, ... rest):*

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt den Namen der Methode des über die Proxy-Klasse zugänglich gemachten Objekts zurück.

Parameter

	`name:*` — Der Name der aufgerufenen Methode.

	`... rest` — Ein Array mit den Argumenten für die aufgerufene Methode.

Rückgabewerte

* — Der Rückgabewert der aufgerufenen Methode.

deleteProperty

()

Methode

override flash_proxy function deleteProperty(name:*):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Löscht die angegebene Eigenschaft des über die Proxy-Klasse zugänglich gemachten Objekts und benachrichtigt die Prozedur von der Löschung.

Parameter

name:* — Normalerweise ein String, der den Eigenschaftsnamen enthält oder möglicherweise einen QName, wobei der Eigenschaftsname durch Überprüfen der localName-Eigenschaft gefunden wird.

Rückgabewerte

Boolean — Ein boolescher Wert, der angibt, ob eine Eigenschaft gelöscht wurde.

dispatchEvent

()

Methode

public function dispatchEvent(event:Event):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Sendet ein Ereignis in den Ereignisablauf. Weitere Informationen finden Sie im Abschnitt zur flash.events.EventDispatcher-Klasse.

Parameter

event:Event — Das Ereignisobjekt, das in den Ereignisablauf integriert wird. Wenn das Ereignis erneut gesendet wird, wird automatisch ein Klon des Ereignisses erstellt. Nachdem ein Ereignis ausgelöst wurde, lässt sich seine target-Eigenschaft nicht mehr ändern, daher funktioniert ein erneutes Senden des Ereignisses nur, wenn Sie eine neue Kopie des Ereignisses erstellen.

Rückgabewerte

Boolean — Gibt true zurück, wenn das Ereignis erfolgreich versandt wurde. Der Wert false weist entweder auf einen Fehler hin oder auf die Tatsache, dass preventDefault() für das Ereignis aufgerufen worden ist.

Verwandte API-Elemente

flash.events.EventDispatcher.dispatchEvent()

getComplexProperty

()

Methode

object_proxy function getComplexProperty(name:*, value:*):*

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bietet Unterklassen einen Bereich, um die Verwaltung einer komplexen Eigenschaft zu überschreiben, die entweder über die Proxy-Klasse zugänglich gemacht oder für Ereignis-Bubbling verkettet werden muss.

Parameter

	`name:*` — Normalerweise ein String, der den Eigenschaftsnamen enthält oder möglicherweise einen QName, wobei der Eigenschaftsname durch Überprüfen der `localName`-Eigenschaft gefunden wird.

	`value:*` — Der Wert der Eigenschaft.

Rückgabewerte

* — Der Eigenschaftswert oder eine Instanz von ObjectProxy.

getProperty

()

Methode

override flash_proxy function getProperty(name:*):*

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt den angegebenen Eigenschaftswert des über die Proxy-Klasse zugänglich gemachten Objekts zurück.

Parameter

name:* — Normalerweise ein String, der den Eigenschaftsnamen enthält oder möglicherweise einen QName, wobei der Eigenschaftsname durch Überprüfen der localName-Eigenschaft gefunden wird.

Rückgabewerte

* — Der Wert der Eigenschaft. In einigen Fällen kann dieser Wert eine Instanz von ObjectProxy sein.

hasEventListener

()

Methode

public function hasEventListener(type:String):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Überprüft, ob Ereignis-Listener für einen bestimmten Ereignistyp registriert sind. Dadurch können Sie bestimmen, wo ein Objekt die Verarbeitung eines Ereignistyps in der Ereignisablaufhierarchie geändert hat. Weitere Informationen finden Sie im Abschnitt zur flash.events.EventDispatcher-Klasse.

Parameter

type:String — Der Typ des Ereignisses

Rückgabewerte

Boolean — Gibt true zurück, wenn ein Listener des angegebenen Typs registriert ist, andernfalls false.

Verwandte API-Elemente

flash.events.EventDispatcher.hasEventListener().

propertyChangeHandler

()

Methode

public function propertyChangeHandler(event:PropertyChangeEvent):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird aufgerufen, wenn eine komplexe Eigenschaft aktualisiert wird.

Parameter

event:PropertyChangeEvent — Ein Ereignisobjekt, das geändert wurde.

readExternal

()

Methode

public function readExternal(input:IDataInput):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Da Flex nur ObjectProxy zum Einschließen anonymer Objekte verwendet, serialisiert sich die flex.messaging.io.ObjectProxy-Serverinstanz selbst als Zuordnung, die als einfaches ActionScript-Objekt zurückgegeben wird. Sie können dann die object_proxy-Objekteigenschaft auf diesen Wert setzen.

Parameter

input:IDataInput — Das Quellobjekt, von dem der ObjectProxy deserialisiert wird.

removeEventListener

()

Methode

public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Entfernt einen Ereignis-Listener. Wenn kein entsprechender Listener beim EventDispatcher-Objekt registriert ist, hat ein Aufruf dieser Methode keine Auswirkungen. Weitere Informationen finden Sie im Abschnitt zur flash.events.EventDispatcher-Klasse.

Parameter

	`type:String` — Der Typ des Ereignisses.

	`listener:Function` — Das zu entfernende Listener-Objekt.

	`useCapture:Boolean` (default = `false`) — Gibt an, ob der Listener für die Erfassungsphase oder die Ziel- und Bubbling-Phase registriert wurde. Wenn der Listener sowohl für die Erfassungs- als auch für die Bubbling-Phase registriert wurde, sind auch zwei Aufrufe von `removeEventListener()` erforderlich, um beide zu entfernen: ein Aufruf, bei dem `useCapture` auf `true` gesetzt ist, und einer, bei dem `useCapture` auf `false` gesetzt ist.

Verwandte API-Elemente

flash.events.EventDispatcher.removeEventListener().

setProperty

()

Methode

override flash_proxy function setProperty(name:*, value:*):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Aktualisiert die angegebene Eigenschaft des über die Proxy-Klasse zugänglich gemachten Objekts und benachrichtigt die Prozedur von der Aktualisierung.

Parameter

	`name:*` — Objekt, das den Namen der Eigenschaft enthält, die für das über die Proxy-Klasse zugänglich gemachte Objekt aktualisiert werden sollte.

	`value:*` — Der für das über die Proxy-Klasse zugänglich gemachte Objekt festzulegende Wert.

setupPropertyList

()

Methode

protected function setupPropertyList():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Diese Methode erstellt ein Array aller Eigenschaftsnamen des über die Proxy-Klasse zugänglich gemachten Objekts. Untergeordnete Elemente müssen diese Methode überschreiben, um der Liste weitere Eigenschaften hinzuzufügen. Stellen Sie sicher, dass super.setupPropertyList aufgerufen wird, bevor Sie die propertyList-Eigenschaft ändern.

willTrigger

()

Methode

public function willTrigger(type:String):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Überprüft, ob ein Ereignislistener bei diesem Objekt oder einem Vorgänger für diesen Ereignistyp registriert ist. Diese Methode gibt den Wert true zurück, sofern während irgendeiner Phase des Ereignisablaufs ein Ereignis-Listener aufgerufen wird, wenn ein Ereignis des angegebenen Typs für das Objekt oder eines seiner untergeordneten Elemente ausgelöst wird. Weitere Informationen finden Sie im Abschnitt zur flash.events.EventDispatcher-Klasse.

Parameter

type:String — Der Typ des Ereignisses.

Rückgabewerte

Boolean — Gibt true zurück, wenn ein Listener des angegebenen Typs ausgelöst wird, andernfalls false.

Verwandte API-Elemente

flash.events.EventDispatcher.willTrigger().

writeExternal

()

Methode

public function writeExternal(output:IDataOutput):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Da Flex nur das innere eingeschlossene ActionScript-Objekt serialisiert, füllt sich das flex.messaging.io.ObjectProxy-Serverobjekt mit dem Inhalt des anonymen Objekts und wird dem Benutzer als Zuordnung angezeigt.

Parameter

output:IDataOutput — Das Quellobjekt, von dem der ObjectProxy deserialisiert wird.

Rechtliche Hinweise | Onlinedatenschutzerklärung

ObjectProxy - AS3 Flex

Paketex

Sprachelemente

Anhänge

Paket mx.utils

dispatcher

notifiers

object

propertyList

proxyClass

type

uid

ObjectProxy

addEventListener

callProperty

deleteProperty

dispatchEvent

getComplexProperty

getProperty

hasEventListener

propertyChangeHandler

readExternal

removeEventListener

setProperty

setupPropertyList

willTrigger

writeExternal