ObjectProxy

Пакет	mx.utils
Класс	public dynamic class ObjectProxy
Наследование	ObjectProxy Proxy
Реализует	IExternalizable, IPropertyChangeNotifier
Подклассы	DataItem, ManagedObjectProxy

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Этот класс предоставляет возможность отслеживания изменений для элемента, управляемого посредством этого прокси. Изменения в этом объекте могут «прослушиваться» любым количеством объектов при помощи метода addEventListener().

Общедоступные свойства

	Свойство		Определено
		uid : String Уникальный идентификатор этого объекта.	ObjectProxy

Защищенные свойства

	Свойство		Определено
		dispatcher : EventDispatcher Ссылка на EventDispatcher для этого прокси.	ObjectProxy
		notifiers : Object Хеш-код уведомителей об изменении свойства, с которого этот прокси прослушивает изменения; ключом схемы является имя свойства.	ObjectProxy
		object : Object [только для чтения] Объект прокси.	ObjectProxy
		propertyList : Array Содержит список всех имен свойств для объекта прокси.	ObjectProxy
		proxyClass : Class Определяет вид создаваемого прокси для комплексных свойств.	ObjectProxy
		type : QName Определенное имя типа, связанное с этим объектом.	ObjectProxy

Общедоступные методы

	Метод		Определено
		ObjectProxy(item:Object = null, uid:String = null, proxyDepth:int = -1) Инициализирует прокси с указанным объектом, идентификатором и глубиной прокси.	ObjectProxy
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события для получения прослушивателем уведомления о событии.	ObjectProxy
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	ObjectProxy
		hasEventListener(type:String):Boolean Проверяет наличие прослушивателей, зарегистрированных для конкретного типа события.	ObjectProxy
		propertyChangeHandler(event:PropertyChangeEvent):void Вызывается при обновлении сложных свойств.	ObjectProxy
		readExternal(input:IDataInput):void Так как для включения анонимных объектов Flex использует только ObjectProxy, экземпляр сервера flex.messaging.io.ObjectProxy выполняет сериализацию самого себя в виде схемы, которая будет возвращена как простой объект ActionScript.	ObjectProxy
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушивателя событий.	ObjectProxy
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события на этом объекте или на любом из его предшественников для указанного типа события.	ObjectProxy
		writeExternal(output:IDataOutput):void Поскольку Flex выполняет сериализацию только переносимого внутреннего объекта ActionScript, сервер flex.messaging.io.ObjectProxy заполняется содержимым этого анонимного объекта и отображается для пользователя в виде схемы.	ObjectProxy

Защищенные методы

	Метод		Определено
		callProperty(name:, ... rest): [переопределить] Возвращает значение метода объекта с прокси с указанным именем.	ObjectProxy
		deleteProperty(name:*):Boolean [переопределить] Удаляет указанное свойство объекта с прокси и передает уведомление об удалении обработчику.	ObjectProxy
		getComplexProperty(name:, value:):* Обеспечивает пространство для подклассов с целью переопределения способа управления комплексным свойством, для которого необходим прокси или шлейфовое соединение в восходящей цепочки события.	ObjectProxy
		getProperty(name:): [переопределить] Возвращает указанное значение свойства объекта прокси.	ObjectProxy
		setProperty(name:, value:):void [переопределить] Обновляет указанные свойства объекта прокси и передает обработчику уведомление об обновлении.	ObjectProxy
		setupPropertyList():void Этот метод создает массив всех имен свойств для объекта прокси.	ObjectProxy

Сведения о свойстве

dispatcher

свойство

protected var dispatcher:EventDispatcher

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Ссылка на EventDispatcher для этого прокси.

notifiers

свойство

protected var notifiers:Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Хеш-код уведомителей об изменении свойства, с которого этот прокси прослушивает изменения; ключом схемы является имя свойства.

object

свойство

object:Object [только для чтения]

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Объект прокси.

Реализация
object_proxy function get object():Object

propertyList

свойство

protected var propertyList:Array

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Содержит список всех имен свойств для объекта прокси. Для нижестоящих объектов этот список заполняется путем переопределения метода setupPropertyList().

proxyClass

свойство

protected var proxyClass:Class

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Определяет вид создаваемого прокси для комплексных свойств. Это значение должно соответственно присваиваться подклассам.

type

свойство

type:QName

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Определенное имя типа, связанное с этим объектом.

Реализация
object_proxy function get type():QName
object_proxy function set type(value:QName):void

uid

свойство

uid:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Уникальный идентификатор этого объекта.

Реализация
public function get uid():String
public function set uid(value:String):void

Сведения о конструкторе

()

Конструктор

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

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Инициализирует прокси с указанным объектом, идентификатором и глубиной прокси.

Параметры

	`item:Object` (default = `null`) — Объект для прокси. Если элемент не указан, то создается и присваивается анонимный объект.

	`uid:String` (default = `null`) — Строка, содержащая уникальный идентификатор для этого экземпляра объекта. Требуется для соответствия IPropertyChangeNotifier, поскольку каждый объект должен предоставить уникальный способ собственной идентификации. Если значение не указано, то присваивается произвольный идентификатор.

	`proxyDepth:int` (default = `-1`) — Целое число, определяющее, сколько уровней в диаграмме составного объекта должно создать прокси в процессе доступа к свойству. Значением по умолчанию является -1, что означает «прокси бесконечной глубины».

Пример
Использование этого примера

      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')

Сведения о методе

addEventListener

()

метод

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

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Регистрирует объект прослушивателя события для получения прослушивателем уведомления о событии. Для получения дополнительной информации, включая описания параметров, см. раздел addEventListener() в классе flash.events.EventDispatcher.

Параметры

	`type:String` — Тип события.

	`listener:Function` — Функция прослушивателя, обрабатывающая событие. Эта функция должна принимать объект Event в качестве единственного параметра и не должна возвращать данные.

	`useCapture:Boolean` (default = `false`) — Определяет, работает ли прослушиватель в фазе захвата или в целевой фазе и в фазе восходящей цепочки. Если значение `useCapture` равно `true`, прослушиватель обрабатывает событие только во время фазы захвата, но не во время целевой фазы или фазы восходящей цепочки. Если значение `useCapture` равно `false`, то прослушиватель обрабатывает событие только в целевой фазе или фазе восходящей цепочки. Чтобы прослушивать событие во всех трех фазах, необходимо вызвать `addEventListener()` дважды: один раз с `useCapture` в значении `true`, а другой — с `useCapture` в значении `false`.

	`priority:int` (default = `0`) — Уровень приоритета прослушивателя события.

	`useWeakReference:Boolean` (default = `false`) — Определяет, является ли ссылка на прослушиватель «сильной» или «слабой». «Сильная» ссылка (по умолчанию) предотвращает удаление прослушивателя сборщиком мусора. «Слабая» ссылка не выполняет эту функцию.

Связанные элементы API

flash.events.EventDispatcher.addEventListener()

callProperty

()

метод

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

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Возвращает значение метода объекта с прокси с указанным именем.

Параметры

	`name:*` — Имя вызываемого метода.

	`... rest` — Массив аргументов вызываемого метода.

Возвращает

* — Значение, которое возвращает вызываемый метод.

deleteProperty

()

метод

override flash_proxy function deleteProperty(name:*):Boolean

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Удаляет указанное свойство объекта с прокси и передает уведомление об удалении обработчику.

Параметры

name:* — Как правило, строка, содержащая имя свойства или QName, причем имя свойства определяется при проверке свойства localName.

Возвращает

Boolean — Логическое значение, указывающее на удаление свойства.

dispatchEvent

()

метод

public function dispatchEvent(event:Event):Boolean

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Посылает событие в поток событий. Для получения дополнительной информации см. класс flash.events.EventDispatcher.

Параметры

event:Event — Объект события, передаваемый в поток событий. Если осуществляется повторная отправка события, автоматически создается его клон. После передачи события невозможно изменить его свойство target, поэтому необходимо создать новую копию события для выполнения повторной передачи.

Возвращает

Boolean — Возвращает значение true, если событие было успешно передано. Значение false указывает на ошибку или на то, что для события был вызван метод preventDefault().

Связанные элементы API

flash.events.EventDispatcher.dispatchEvent()

getComplexProperty

()

метод

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

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Обеспечивает пространство для подклассов с целью переопределения способа управления комплексным свойством, для которого необходим прокси или шлейфовое соединение в восходящей цепочки события.

Параметры

	`name:*` — Как правило, строка, содержащая имя свойства или QName, причем имя свойства определяется при проверке свойства `localName`.

	`value:*` — Значение свойства.

Возвращает

* — Значение свойства или экземпляр ObjectProxy.

getProperty

()

метод

override flash_proxy function getProperty(name:*):*

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Возвращает указанное значение свойства объекта прокси.

Параметры

Возвращает

* — Значение свойства. В некоторых экземплярах это значение может быть экземпляром ObjectProxy.

hasEventListener

()

метод

public function hasEventListener(type:String):Boolean

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Проверяет наличие прослушивателей, зарегистрированных для конкретного типа события. Он позволяет определить, где объект изменил обработку типа события в иерархии потока событий. Для получения дополнительной информации см. класс flash.events.EventDispatcher.

Параметры

type:String — Тип события

Возвращает

Boolean — Возвращает значение true, если прослушиватель указанного типа зарегистрирован; в противном случае – false.

Связанные элементы API

flash.events.EventDispatcher.hasEventListener()

propertyChangeHandler

()

метод

public function propertyChangeHandler(event:PropertyChangeEvent):void

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Вызывается при обновлении сложных свойств.

Параметры

event:PropertyChangeEvent — Измененный объект события.

readExternal

()

метод

public function readExternal(input:IDataInput):void

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Так как для включения анонимных объектов Flex использует только ObjectProxy, экземпляр сервера flex.messaging.io.ObjectProxy выполняет сериализацию самого себя в виде схемы, которая будет возвращена как простой объект ActionScript. Затем для этого значения можно установить свойство объекта object_proxy.

Параметры

input:IDataInput — Исходный объект, из которого десериализуется ObjectProxy.

removeEventListener

()

метод

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

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Удаляет прослушивателя событий. При отсутствии прослушивателя, зарегистрированного с объектом EventDispatcher, вызов этого метода не оказывает эффекта. Для получения дополнительной информации см. класс flash.events.EventDispatcher.

Параметры

	`type:String` — Тип события.

	`listener:Function` — Удаляемый объект прослушивателя.

	`useCapture:Boolean` (default = `false`) — Указывает, был ли прослушиватель зарегистрирован для фазы захвата или целевой фазы и фазы восходящей цепочки. Если прослушиватель был зарегистрирован для фазы захвата, целевой фазы и фазы восходящей цепочки, необходимо удалить оба вызова `removeEventListener()`: один вызов с `useCapture`, равным `true`, и второй вызов с `useCapture`, равным `false`.

Связанные элементы API

flash.events.EventDispatcher.removeEventListener()

setProperty

()

метод

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

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Обновляет указанные свойства объекта прокси и передает обработчику уведомление об обновлении.

Параметры

	`name:*` — Объект, содержащий имя свойства, которое должно быть обновлено в объекте прокси.

	`value:*` — Значение, которое должно быть установлено в объекте прокси.

setupPropertyList

()

метод

protected function setupPropertyList():void

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Этот метод создает массив всех имен свойств для объекта прокси. Для добавления дополнительных свойств к этому списку нижестоящие элементы должны переопределить этот метод. Перед внесением каких-либо изменений в свойство propertyList следует вызвать super.setupPropertyList.

willTrigger

()

метод

public function willTrigger(type:String):Boolean

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Проверяет, зарегистрирован ли прослушиватель события на этом объекте или на любом из его предшественников для указанного типа события. Этот метод возвращает значение true, если прослушиватель события запускается в течение любой фазы потока событий, когда событие указанного типа передается объекту или любому из его нижестоящих элементов. Для получения дополнительной информации см. класс flash.events.EventDispatcher.

Параметры

type:String — Тип события.

Возвращает

Boolean — Возвращает значение true при запуске прослушивателя указанного типа; в противном случае значение равно false.

Связанные элементы API

flash.events.EventDispatcher.willTrigger()

writeExternal

()

метод

public function writeExternal(output:IDataOutput):void

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Поскольку Flex выполняет сериализацию только переносимого внутреннего объекта ActionScript, сервер flex.messaging.io.ObjectProxy заполняется содержимым этого анонимного объекта и отображается для пользователя в виде схемы.

Параметры

output:IDataOutput — Исходный объект, из которого десериализуется ObjectProxy.

Юридическая информация | Политика конфиденциальности онлайн

ObjectProxy - AS3 Flex

Классы x

dispatcher

notifiers

object

propertyList

proxyClass

type

uid

ObjectProxy

addEventListener

callProperty

deleteProperty

dispatchEvent

getComplexProperty

getProperty

hasEventListener

propertyChangeHandler

readExternal

removeEventListener

setProperty

setupPropertyList

willTrigger

writeExternal