Pacotemx.utils
Classepublic dynamic class ObjectProxy
HerançaObjectProxy Inheritance Proxy Inheritance Object
Implementa IExternalizable, IPropertyChangeNotifier

This class provides the ability to track changes to an item managed by this proxy. Any number of objects can "listen" for changes on this object, by using the addEventListener() method.


Propriedades Públicas
 PropriedadeDefinido por
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
  uid : String
The unique identifier for this object.
ObjectProxy
Propriedades Protegidas
 PropriedadeDefinido por
  dispatcher : EventDispatcher
A reference to the EventDispatcher for this proxy.
ObjectProxy
  notifiers : Object
A hashmap of property change notifiers that this proxy is listening for changes from; the key of the map is the property name.
ObjectProxy
  object : Object
[read-only] The object being proxied.
ObjectProxy
  propertyList : Array
Contains a list of all of the property names for the proxied object.
ObjectProxy
  proxyClass : Classe
Indicates what kind of proxy to create when proxying complex properties.
ObjectProxy
  type : QName
The qualified type name associated with this object.
ObjectProxy
Métodos Públicos
 MétodoDefinido por
  
ObjectProxy(item:Object = null, uid:String = null, proxyDepth:int = -1)
Initializes this proxy with the specified object, id and proxy depth.
ObjectProxy
  
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object so that the listener receives notification of an event.
ObjectProxy
  
dispatchEvent(event:Event):Boolean
Dispatches an event into the event flow.
ObjectProxy
  
hasEventListener(type:String):Boolean
Checks whether there are any event listeners registered for a specific type of event.
ObjectProxy
 Inherited
hasOwnProperty(name:String):Boolean
Indicates whether an object has a specified property defined.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
  
propertyChangeHandler(event:PropertyChangeEvent):void
Called when a complex property is updated.
ObjectProxy
 Inherited
propertyIsEnumerable(name:String):Boolean
Indicates whether the specified property exists and is enumerable.
Object
  
readExternal(input:IDataInput):void
Since Flex only uses ObjectProxy to wrap anonymous objects, the server flex.messaging.io.ObjectProxy instance serializes itself as a Map that will be returned as a plain ActionScript object.
ObjectProxy
  
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes an event listener.
ObjectProxy
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
toString():String
Returns the string representation of the specified object.
Object
 Inherited
valueOf():Object
Returns the primitive value of the specified object.
Object
  
willTrigger(type:String):Boolean
Checks whether an event listener is registered with this object or any of its ancestors for the specified event type.
ObjectProxy
  
writeExternal(output:IDataOutput):void
Since Flex only serializes the inner ActionScript object that it wraps, the server flex.messaging.io.ObjectProxy populates itself with this anonymous object's contents and appears to the user as a Map.
ObjectProxy
Métodos Protegidos
 MétodoDefinido por
  
callProperty(name:*, ... rest):*
Returns the value of the proxied object's method with the specified name.
ObjectProxy
  
deleteProperty(name:*):Boolean
Deletes the specified property on the proxied object and sends notification of the delete to the handler.
ObjectProxy
  
getComplexProperty(name:*, value:*):*
Provides a place for subclasses to override how a complex property that needs to be either proxied or daisy chained for event bubbling is managed.
ObjectProxy
  
getProperty(name:*):*
Returns the specified property value of the proxied object.
ObjectProxy
  
hasProperty(name:*):Boolean
This is an internal function that must be implemented by a subclass of flash.utils.Proxy.
ObjectProxy
  
nextName(index:int):String
This is an internal function that must be implemented by a subclass of flash.utils.Proxy.
ObjectProxy
  
nextNameIndex(index:int):int
This is an internal function that must be implemented by a subclass of flash.utils.Proxy.
ObjectProxy
  
nextValue(index:int):*
This is an internal function that must be implemented by a subclass of flash.utils.Proxy.
ObjectProxy
  
setProperty(name:*, value:*):void
Updates the specified property on the proxied object and sends notification of the update to the handler.
ObjectProxy
  
setupPropertyList():void
This method creates an array of all of the property names for the proxied object.
ObjectProxy
Detalhes da propriedade
dispatcherpropriedade
protected var dispatcher:EventDispatcher

A reference to the EventDispatcher for this proxy.

notifierspropriedade 
protected var notifiers:Object

A hashmap of property change notifiers that this proxy is listening for changes from; the key of the map is the property name.

objectpropriedade 
object:Object  [read-only]

The object being proxied.


Implementação
    object_proxy function get object():Object
propertyListpropriedade 
protected var propertyList:Array

Contains a list of all of the property names for the proxied object. Descendants need to fill this list by overriding the setupPropertyList() method.

proxyClasspropriedade 
protected var proxyClass:Classe

Indicates what kind of proxy to create when proxying complex properties. Subclasses should assign this value appropriately.

typepropriedade 
type:QName  [read-write]

The qualified type name associated with this object.


Implementação
    object_proxy function get type():QName
    object_proxy function set type(value:QName):void
uidpropriedade 
uid:String  [read-write]

The unique identifier for this object.


Implementação
    public function get uid():String
    public function set uid(value:String):void
Detalhes do construtor
ObjectProxy()Construtor
public function ObjectProxy(item:Object = null, uid:String = null, proxyDepth:int = -1)

Initializes this proxy with the specified object, id and proxy depth.

Parâmetros
item:Object (default = null) — Object to proxy. If no item is specified, an anonymous object will be constructed and assigned.
 
uid:String (default = null) — String containing the unique id for this object instance. Required for IPropertyChangeNotifier compliance as every object must provide a unique way of identifying it. If no value is specified, a random id will be assigned.
 
proxyDepth:int (default = -1) — An integer indicating how many levels in a complex object graph should have a proxy created during property access. The default is -1, meaning "proxy to infinite depth".

Exemplo
How to use examples 
      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')
Detalhes do método
addEventListener()método
public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Registers an event listener object so that the listener receives notification of an event. For more information, see the flash.events.EventDispatcher class.

Parâmetros

type:String
 
listener:Function
 
useCapture:Boolean (default = false)
 
priority:int (default = 0)
 
useWeakReference:Boolean (default = false)

Veja também

flash.events.EventDispatcher.addEventListener()
callProperty()método 
flash_proxy override function callProperty(name:*, ... rest):*

Returns the value of the proxied object's method with the specified name.

Parâmetros

name:* — The name of the method being invoked.
 
... rest — An array specifying the arguments to the called method.

Retorna
* — The return value of the called method.
deleteProperty()método 
flash_proxy override function deleteProperty(name:*):Boolean

Deletes the specified property on the proxied object and sends notification of the delete to the handler.

Parâmetros

name:* — Typically a string containing the name of the property, or possibly a QName where the property name is found by inspecting the localName property.

Retorna
Boolean — A Boolean indicating if the property was deleted.
dispatchEvent()método 
public function dispatchEvent(event:Event):Boolean

Dispatches an event into the event flow. For more information, see the flash.events.EventDispatcher class.

Parâmetros

event:Event

Retorna
Boolean

Veja também

flash.events.EventDispatcher.dispatchEvent()
getComplexProperty()método 
object_proxy function getComplexProperty(name:*, value:*):*

Provides a place for subclasses to override how a complex property that needs to be either proxied or daisy chained for event bubbling is managed.

Parâmetros

name:* — Typically a string containing the name of the property, or possibly a QName where the property name is found by inspecting the localName property.
 
value:* — The property value.

Retorna
* — The property value or an instance of ObjectProxy.
getProperty()método 
flash_proxy override function getProperty(name:*):*

Returns the specified property value of the proxied object.

Parâmetros

name:* — Typically a string containing the name of the property, or possibly a QName where the property name is found by inspecting the localName property.

Retorna
* — The value of the property. In some instances this value may be an instance of ObjectProxy.
hasEventListener()método 
public function hasEventListener(type:String):Boolean

Checks whether there are any event listeners registered for a specific type of event. This allows you to determine where an object has altered handling of an event type in the event flow hierarchy. For more information, see the flash.events.EventDispatcher class.

Parâmetros

type:String

Retorna
Boolean

Veja também

flash.events.EventDispatcher.hasEventListener()
hasProperty()método 
flash_proxy override function hasProperty(name:*):Boolean

This is an internal function that must be implemented by a subclass of flash.utils.Proxy.

Parâmetros

name:* — The property name that should be tested for existence.

Retorna
Boolean

Veja também

flash.utils.Proxy.hasProperty()
nextName()método 
flash_proxy override function nextName(index:int):String

This is an internal function that must be implemented by a subclass of flash.utils.Proxy.

Parâmetros

index:int

Retorna
String

Veja também

flash.utils.Proxy.nextName()
nextNameIndex()método 
flash_proxy override function nextNameIndex(index:int):int

This is an internal function that must be implemented by a subclass of flash.utils.Proxy.

Parâmetros

index:int

Retorna
int

Veja também

flash.utils.Proxy.nextNameIndex()
nextValue()método 
flash_proxy override function nextValue(index:int):*

This is an internal function that must be implemented by a subclass of flash.utils.Proxy.

Parâmetros

index:int

Retorna
*

Veja também

flash.utils.Proxy.nextValue()
propertyChangeHandler()método 
public function propertyChangeHandler(event:PropertyChangeEvent):void

Called when a complex property is updated.

Parâmetros

event:PropertyChangeEvent

readExternal()método 
public function readExternal(input:IDataInput):void

Since Flex only uses ObjectProxy to wrap anonymous objects, the server flex.messaging.io.ObjectProxy instance serializes itself as a Map that will be returned as a plain ActionScript object. You can then set the object_proxy object property to this value.

Parâmetros

input:IDataInput

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

Removes an event listener. If there is no matching listener registered with the EventDispatcher object, a call to this method has no effect. For more information, see the flash.events.EventDispatcher class.

Parâmetros

type:String
 
listener:Function
 
useCapture:Boolean (default = false)

Veja também

flash.events.EventDispatcher.removeEventListener()
setProperty()método 
flash_proxy override function setProperty(name:*, value:*):void

Updates the specified property on the proxied object and sends notification of the update to the handler.

Parâmetros

name:* — Object containing the name of the property that should be updated on the proxied object.
 
value:* — Value that should be set on the proxied object.

setupPropertyList()método 
protected function setupPropertyList():void

This method creates an array of all of the property names for the proxied object. Descendants must override this method if they wish to add more properties to this list. Be sure to call super.setupPropertyList before making any changes to the propertyList property.

willTrigger()método 
public function willTrigger(type:String):Boolean

Checks whether an event listener is registered with this object or any of its ancestors for the specified event type. This method returns true if an event listener is triggered during any phase of the event flow when an event of the specified type is dispatched to this object or any of its descendants. For more information, see the flash.events.EventDispatcher class.

Parâmetros

type:String

Retorna
Boolean

Veja também

flash.events.EventDispatcher.willTrigger()
writeExternal()método 
public function writeExternal(output:IDataOutput):void

Since Flex only serializes the inner ActionScript object that it wraps, the server flex.messaging.io.ObjectProxy populates itself with this anonymous object's contents and appears to the user as a Map.

Parâmetros

output:IDataOutput




© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Traduzido e mantido por Igor Costa - www.igorcosta.com