MessageAgent

Пакет	mx.messaging
Класс	public class MessageAgent
Наследование	MessageAgent EventDispatcher Object
Реализует	IMXMLObject
Подклассы	AbstractConsumer, AbstractProducer

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Класс MessageAgent обеспечивает базовые функциональные возможности нижнего уровня, общие в обработке сообщений для адресата.

Примечание. Только для опытных пользователей. Используйте этот класс для создания пользовательских агентов сообщений, наподобие существующих классов отправителя и получателя.

Синтаксис MXML expanded

Скрыть синтаксис MXML

All message agent classes, including the Producer and Consumer classes, extend MessageAgent and inherit the following tag attributes:

   <mx:tagname

    Properties
    channelSet="No default."
    clientId="No default."
    connected="false"
    destination="No default."
    requestTimeout="-1"
    subtopic="No default."
 
 
   Events
    acknowledge="No default."
    channelConnect="No default."
    channelDisconnect="No default."
    channelFault="No default."
    fault="No default."
    propertyChange="No default."
  />

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

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		authenticated : Boolean [только для чтения] Указывает, использует ли этот MessageAgent аутентифицируемое подключение к его адресату.	MessageAgent
		channelSet : ChannelSet Предоставляет доступ к ChannelSet, который используется MessageAgent.	MessageAgent
		clientId : String [только для чтения] Предоставляет доступ к идентификатору клиента для MessageAgent.	MessageAgent
		connected : Boolean [только для чтения] Указывает, подключен ли этот MessageAgent в настоящее время к адресату через соответствующий ChannelSet.	MessageAgent
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		destination : String Предоставляет доступ к адресату для MessageAgent.	MessageAgent
		requestTimeout : int Предоставляет доступ к тайм-ауту запроса в секундах для переданных сообщений.	MessageAgent

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

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		MessageAgent() Конструктор.	MessageAgent
		acknowledge(ackMsg:AcknowledgeMessage, msg:IMessage):void Вызываемый MessageResponder при приеме результата для отправленного сообщения.	MessageAgent
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		channelConnectHandler(event:ChannelEvent):void Обрабатывает ChannelEvent CONNECT.	MessageAgent
		channelDisconnectHandler(event:ChannelEvent):void Обрабатывает ChannelEvent DISCONNECT.	MessageAgent
		channelFaultHandler(event:ChannelFaultEvent):void Обрабатывает ChannelFaultEvent.	MessageAgent
		disconnect():void Отключает сетевое подключение MessageAgent.	MessageAgent
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		fault(errMsg:ErrorMessage, msg:IMessage):void Вызываемый MessageResponder при приеме ошибки для отправленного сообщения.	MessageAgent
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		hasPendingRequestForMessage(msg:IMessage):Boolean Возвращает значение true при наличии запросов в очереди для переданного сообщения.	MessageAgent
		initialized(document:Object, id:String):void Вызывается после создания объекта реализации и присвоения всех свойств, указанных в теге.	MessageAgent
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		logout():void Отключает MessageAgent от его удаленного адресата.	MessageAgent
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setCredentials(username:String, password:String, charset:String = null):void Устанавливает учетные данные, которые MessageAgent использует для аутентификации к адресатам.	MessageAgent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		setRemoteCredentials(username:String, password:String, charset:String = null):void Устанавливает удаленные учетные данные, которые будут переданы удаленному адресату для аутентификации во вторичных системах.	MessageAgent
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

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

	Метод		Определено
		handleAuthenticationFault(errMsg:ErrorMessage, msg:IMessage):void Обрабатывает ошибки аутентификации на сервере.	MessageAgent
		initChannelSet(message:IMessage):void Используется для автоматической инициализации свойства channelSet для MessageAgent перед первым подключением.	MessageAgent
		internalSend(message:IMessage, waitForClientId:Boolean = true):void Отправляет сообщение от MessageAgent его адресату с помощью ChannelSet агента.	MessageAgent
		reAuthorize(msg:IMessage):void Эта функция должна быть перезаписана подклассами для реализации повторной аутентификации вследствие специфичного для них поведения тайм-аута сеанса сервера.	MessageAgent

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Сводка	Определено
acknowledge	Передается при получении сообщения подтверждения для отправленного сообщения.	MessageAgent
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
channelConnect	Передается при подключении основного канала, используемого MessageAgent.	MessageAgent
channelDisconnect	Передается при отключении основного канала, используемого MessageAgent.	MessageAgent
channelFault	Передается при ошибке основного канала, используемого MessageAgent.	MessageAgent
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
fault	Передается при возникновении ошибки сообщения.	MessageAgent
propertyChange	Передается при изменении свойства connected MessageAgent.	MessageAgent

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

authenticated

свойство

authenticated:Boolean [только для чтения]

Указывает, использует ли этот MessageAgent аутентифицируемое подключение к его адресату.

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

Реализация
public function get authenticated():Boolean

channelSet

свойство

channelSet:ChannelSet

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Предоставляет доступ к ChannelSet, который используется MessageAgent. ChannelSet может быть вручную создан и назначен, или он будет динамически инициализирован для использования сконфигурированных каналов для адресата этого MessageAgent.

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

clientId

свойство

clientId:String [только для чтения]

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Предоставляет доступ к идентификатору клиента для MessageAgent. MessageAgents назначен удаленным адресатом идентификатор клиента, и это значение используется для маршрутизации сообщения от удаленного адресата до соответствующего MessageAgent.

Реализация
public function get clientId():String

connected

свойство

connected:Boolean [только для чтения]

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Указывает, подключен ли этот MessageAgent в настоящее время к адресату через соответствующий ChannelSet. Событие propertyChange передается при изменении этого свойства.

Реализация
public function get connected():Boolean

destination

свойство

destination:String

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Предоставляет доступ к адресату для MessageAgent. Изменение адресата приведет к отключению MessageAgent, если он будет подключен.

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

Выдает

InvalidDestinationError — Если адресат имеет значение null или нулевой длины.

requestTimeout

свойство

requestTimeout:int

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Предоставляет доступ к тайм-ауту запроса в секундах для переданных сообщений. Если подтверждение, ответ или ошибка не получены от удаленного адресата по истечении тайм-аута, то сообщение привело к ошибке на клиенте. Если значение меньше или равно нулю, тайм-аут запроса не применяется.

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

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

()

Конструктор

public function MessageAgent()

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Конструктор.

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

acknowledge

()

метод

public function acknowledge(ackMsg:AcknowledgeMessage, msg:IMessage):void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Вызываемый MessageResponder при приеме результата для отправленного сообщения. Подклассы могут перезаписать этот метод, если они должны выполнять пользовательскую обработку подтверждения, но они также должны вызвать super.acknowledge(). Этот метод передает MessageAckEvent.

Параметры

	`ackMsg:AcknowledgeMessage` — Возвращается AcknowledgMessage.

	`msg:IMessage` — Оригинал отправленного сообщения.

channelConnectHandler

()

метод

public function channelConnectHandler(event:ChannelEvent):void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Обрабатывает ChannelEvent CONNECT. Подклассы, которые должны выполнять пользовательскую обработку, должны перезаписать этот метод и вызывать super.channelConnectHandler().

Параметры

event:ChannelEvent — ChannelEvent.

channelDisconnectHandler

()

метод

public function channelDisconnectHandler(event:ChannelEvent):void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Обрабатывает ChannelEvent DISCONNECT. Подклассы, которые должны выполнять пользовательскую обработку, должны перезаписать этот метод и вызывать super.channelDisconnectHandler().

Параметры

event:ChannelEvent — ChannelEvent.

channelFaultHandler

()

метод

public function channelFaultHandler(event:ChannelFaultEvent):void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Обрабатывает ChannelFaultEvent. Подклассы, которые должны выполнять пользовательскую обработку, должны перезаписать этот метод и вызывать super.channelFaultHandler().

Параметры

event:ChannelFaultEvent — ChannelFaultEvent

disconnect

()

метод

public function disconnect():void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

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

fault

()

метод

public function fault(errMsg:ErrorMessage, msg:IMessage):void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Вызываемый MessageResponder при приеме ошибки для отправленного сообщения. Подклассы могут перезаписать этот метод, если они должны выполнить пользовательскую обработку отказов, при этом они должны вызвать super.fault(). Этот метод передает MessageFaultEvent.

Параметры

	`errMsg:ErrorMessage` — ErrorMessage.

	`msg:IMessage` — Оригинал отправленного сообщения, вызвавшего эту ошибку.

handleAuthenticationFault

()

метод

protected function handleAuthenticationFault(errMsg:ErrorMessage, msg:IMessage):void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

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

Параметры

	`errMsg:ErrorMessage` — Сообщение об ошибке.

	`msg:IMessage` — Сообщение, которое вызвало ошибку и должно быть отправлено повторно, как только будет выполнено отключение/подключение, что приведет к повторной аутентификации.

hasPendingRequestForMessage

()

метод

public function hasPendingRequestForMessage(msg:IMessage):Boolean

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Возвращает значение true при наличии запросов в очереди для переданного сообщения. Этот метод должен быть перезаписан подклассами

Параметры

msg:IMessage — Сообщение, для которого проверяется наличие запросов в очереди.

Возвращает

Boolean — Возвращает значение true при наличии запросов в очереди для переданного сообщения.

initChannelSet

()

метод

protected function initChannelSet(message:IMessage):void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Используется для автоматической инициализации свойства channelSet для MessageAgent перед первым подключением. Подтипы могут переопределить поведение по умолчанию на выполнение пользовательской инициализации.

Параметры

message:IMessage — Сообщение, которое должно быть отправлено.

initialized

()

метод

public function initialized(document:Object, id:String):void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Вызывается после создания объекта реализации и присвоения всех свойств, указанных в теге.

Параметры

	`document:Object` — Документ MXML, создавший объект.

	`id:String` — идентификатор, используемый документом для ссылки на этот объект. Если объект представлен как свойство документа, то идентификатор является нулевым.

internalSend

()

метод

protected function internalSend(message:IMessage, waitForClientId:Boolean = true):void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Отправляет сообщение от MessageAgent его адресату с помощью ChannelSet агента. Подклассы MessageAgent должны использовать этот метод для отправки своих сообщений.

Параметры

	`message:IMessage` — Сообщение, которое требуется отправить.

	`waitForClientId:Boolean` (default = `true`) — При значении true сообщение может быть поставлено в очередь, пока clientId не будет назначен агенту. Как правило, это является требуемым поведением. Для специального поведения (автоматическое повторное подключение и повторная подписка) агент может передать значение false для перезаписи поведения очереди по умолчанию.

Выдает

InvalidDestinationError — Если адрес назначения не установлен.

logout

()

метод

public function logout():void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Отключает MessageAgent от его удаленного адресата. Выход из адреса назначения применяется для всех подключений, использующих одинаковый ChannelSet, указанный в конфигурации сервера. Например, если несколько компонентов DataService подключены по каналу RTMP и logout() вызывается на одном из них, то все другие компоненты клиента, подключенные с помощью того же самого ChannelSet, также выполняют выход из системы.

Примечание. Adobe рекомендует вместо этого метода использовать метод mx.messaging.ChannelSet.logout().

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

mx.messaging.ChannelSet.logout()

reAuthorize

()

метод

protected function reAuthorize(msg:IMessage):void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

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

Параметры

msg:IMessage — Сообщение, которое вызвало ошибку и должно быть отправлено повторно, как только будет выполнено отключение/подключение, что приведет к повторной аутентификации.

setCredentials

()

метод

public function setCredentials(username:String, password:String, charset:String = null):void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Устанавливает учетные данные, которые MessageAgent использует для аутентификации к адресатам. Учетные данные применяются ко всем службам, подключенным по одному ChannelSet.

Параметры

	`username:String` — Имя пользователя.

	`password:String` — Пароль.

	`charset:String` (default = `null`) — Кодировка набора символов для использования при кодировании учетных данных. По умолчанию имеет нулевое значение, при котором используется унаследованный набор символов ISO-Latin-1. Помимо этого поддерживается только набор символов UTF-8.

Выдает

IllegalOperationError — в двух ситуациях; если учетные данные были уже установлены и аутентификация происходит с удаленным адресатом, или если аутентифицируется и указанные учетные данные не соответствуют аутентифицированным в настоящее время данным.

setRemoteCredentials

()

метод

public function setRemoteCredentials(username:String, password:String, charset:String = null):void

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Устанавливает удаленные учетные данные, которые будут переданы удаленному адресату для аутентификации во вторичных системах.

Параметры

	`username:String` — Имя пользователя.

	`password:String` — Пароль.

	`charset:String` (default = `null`) — Кодировка набора символов для использования при кодировании учетных данных в удаленной службе. По умолчанию имеет нулевое значение, при котором используется унаследованный набор символов ISO-Latin-1. В настоящее время поддерживается только еще один вариант кодировки – UTF-8.

Сведения о событии

acknowledge

Событие

Тип объекта события: mx.messaging.events.MessageAckEvent
свойство MessageAckEvent.type = mx.messaging.events.MessageAckEvent.ACKNOWLEDGE

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3, BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1, Flash Player 9, AIR 1.1

Передается при получении сообщения подтверждения для отправленного сообщения.

Тип события ACKNOWLEDGE; передается при получении подтверждения.

Значением этой константы является acknowledge.

Свойства объекта события имеют следующие значения:

Свойство	Значение
`acknowledgeMessage`	Служебное свойство для получения значения свойства message из MessageEvent в виде AcknowledgeMessage.
`bubbles`	false
`cancelable`	false
`currentTarget`	Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется `myButton.addEventListener()` для регистрации прослушивателя события, значением `currentTarget` является myButton.
`correlate`	Исходное сообщение, связанное с этим подтверждением.
`message`	Сообщение, связанное с этим событием.
`target`	Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство `currentTarget` всегда используется для получения доступа к объекту, прослушивающему событие.

channelConnect

Событие

Тип объекта события: mx.messaging.events.ChannelEvent
свойство ChannelEvent.type = mx.messaging.events.ChannelEvent.CONNECT

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Передается при подключении основного канала, используемого MessageAgent.

Тип события CONNECT; указывает, что канал подключен к конечной точке.

Значением этой константы является channelConnect.

Свойства объекта события имеют следующие значения:

Свойство	Значение
`bubbles`	false
`cancelable`	false
`channel`	Канал, сгенерировавший это событие.
`currentTarget`	Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется `myButton.addEventListener()` для регистрации прослушивателя события, значением `currentTarget` является myButton.
`target`	Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство `currentTarget` всегда используется для получения доступа к объекту, прослушивающему событие.
`reconnecting`	Указывает, выполняется ли повторное подключение канала, сгенерировавшего это событие.
`rejected`	Указывает, был ли отклонен канал, сгенерировавший это событие. При этом значение будет true, если канал был отключен вследствие отсутствия активности и не должен предпринимать попыток преодоления отказа или подключения по альтернативному каналу.

channelDisconnect

Событие

Тип объекта события: mx.messaging.events.ChannelEvent
свойство ChannelEvent.type = mx.messaging.events.ChannelEvent.DISCONNECT

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Передается при отключении основного канала, используемого MessageAgent.

Тип события DISCONNECT; указывает, что канал отключен от конечной точки.

Значением этой константы является channelDisconnect.

Свойства объекта события имеют следующие значения:

Свойство	Значение
`bubbles`	false
`cancelable`	false
`channel`	Канал, сгенерировавший это событие.
`currentTarget`	Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется `myButton.addEventListener()` для регистрации прослушивателя события, значением `currentTarget` является myButton.
`target`	Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство `currentTarget` всегда используется для получения доступа к объекту, прослушивающему событие.
`reconnecting`	Указывает, выполняется ли повторное подключение канала, сгенерировавшего это событие.
`rejected`	Указывает, был ли отклонен канал, сгенерировавший это событие. При этом значение будет true, если канал был отключен вследствие отсутствия активности и не должен предпринимать попыток преодоления отказа или подключения по альтернативному каналу.

channelFault

Событие

Тип объекта события: mx.messaging.events.ChannelFaultEvent
свойство ChannelFaultEvent.type = mx.messaging.events.ChannelFaultEvent.FAULT

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Передается при ошибке основного канала, используемого MessageAgent.

Тип события FAULT; указывает на наличие ошибки для канала.

Значением этой константы является channelFault.

Свойства объекта события имеют следующие значения:

Свойство	Значение
`bubbles`	false
`cancelable`	false
`channel`	Канал, сгенерировавший это событие.
`currentTarget`	Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется `myButton.addEventListener()` для регистрации прослушивателя события, значением `currentTarget` является myButton.
`faultCode`	Предоставляет специфичную для адреса назначения подробную информацию об ошибке.
`faultDetail`	Предоставляет доступ к специфичной для адреса назначения причине ошибки.
`faultString`	Предоставляет доступ к основной причине ошибки, если она не была вызвана непосредственно каналом.
`reconnecting`	Указывает, выполняется ли повторное подключение канала, сгенерировавшего это событие.
`rootCause`	Предоставляет доступ к основной причине ошибки, если она не была вызвана непосредственно каналом.
`target`	Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство `currentTarget` всегда используется для получения доступа к объекту, прослушивающему событие.

fault

Событие

Тип объекта события: mx.messaging.events.MessageFaultEvent
свойство MessageFaultEvent.type = mx.messaging.events.MessageFaultEvent.FAULT

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Передается при возникновении ошибки сообщения.

Тип события FAULT; передается для сообщения об ошибке.

Значением этой константы является fault.

Свойства объекта события имеют следующие значения:

Свойство	Значение
`bubbles`	false
`cancelable`	false
`currentTarget`	Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется `myButton.addEventListener()` для регистрации прослушивателя события, значением `currentTarget` является myButton.
`faultCode`	Предоставляет специфичную для адреса назначения подробную информацию об ошибке.
`faultDetail`	Предоставляет доступ к специфичной для адреса назначения причине ошибки.
`faultString`	Предоставляет доступ к основной причине ошибки, если она не была вызвана непосредственно каналом.
`message`	ErrorMessage для этого события.
`rootCause`	Предоставляет доступ к основной причине ошибки, если она существует.
`target`	Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство `currentTarget` всегда используется для получения доступа к объекту, прослушивающему событие.

propertyChange

Событие

Тип объекта события: mx.events.PropertyChangeEvent
свойство PropertyChangeEvent.type = mx.events.PropertyChangeEvent.PROPERTY_CHANGE

Язык версии:

ActionScript 3.0

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

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

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

Flash Player 9, AIR 1.1

Передается при изменении свойства connected MessageAgent. Также передается при изменении subscribed получателя.

Константа PropertyChangeEvent.PROPERTY_CHANGE определяет значение свойства type объекта события PropertyChange.

Свойства объекта события имеют следующие значения:

Свойство	Значение
`bubbles`	Определяется конструктором; по умолчанию содержит значение false.
`cancelable`	Определяется конструктором; по умолчанию содержит значение false.
`kind`	Вид изменения; PropertyChangeEventKind.UPDATE или PropertyChangeEventKind.DELETE.
`oldValue`	Исходное значение свойства.
`newValue`	Новое значение свойства, если имеется.
`property`	Измененное свойство.
`source`	Объект, содержащий измененное свойство.
`currentTarget`	Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется `myButton.addEventListener()` для регистрации прослушивателя события, значением `currentTarget` является myButton.
`target`	Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство `currentTarget` всегда используется для получения доступа к объекту, прослушивающему событие.

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

mx.messaging.Consumer

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

MessageAgent - AS3 BlazeDS LCDS

Классы x

authenticated

channelSet

clientId

connected

destination

requestTimeout

MessageAgent

acknowledge

channelConnectHandler

channelDisconnectHandler

channelFaultHandler

disconnect

fault

handleAuthenticationFault

hasPendingRequestForMessage

initChannelSet

initialized

internalSend

logout

reAuthorize

setCredentials

setRemoteCredentials

acknowledge

channelConnect

channelDisconnect

channelFault

fault

propertyChange