| Пакет | mx.messaging |
| Класс | public class MultiTopicConsumer |
| Наследование | MultiTopicConsumer  AbstractConsumer MessageAgent EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версии продуктов: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Как обычный получатель, MultiTopicConsumer отправляет сообщения о подписке и отмене подписки, генерирующие MessageAckEvent или MessageFaultEvent в зависимости от того, была операция успешно выполнена или нет. Будучи однажды подписан, MultiTopicConsumer передает MessageEvent для каждого получаемого им сообщения.
Синтаксис MXML
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <mx:MultiTopicConsumer> tag has these properties:
<mx:Consumer
Properties
subscriptions=""an empty ArrayCollection of SubscriptionInfo objects"
resubscribeAttempts="5"
resubscribeInterval="5000"
timestamp="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 | |
| maxFrequency : uint
Определяет максимальное количество сообщений в секунду, установленное получателем. | AbstractConsumer | |
| requestTimeout : int
Предоставляет доступ к тайм-ауту запроса в секундах для переданных сообщений. | MessageAgent | |
| resubscribeAttempts : int
Количество выполняемых получателем повторных попыток подписки при недоступном адресате или при ошибке подключения к адресату. | AbstractConsumer | |
| resubscribeInterval : int
Количество миллисекунд между повторными попытками подписки. | AbstractConsumer | |
| subscribed : Boolean [только для чтения]
Указывает, подписан ли в настоящее время получатель. | AbstractConsumer | |
| subscriptions : ArrayCollection
Сохраняет массив объектов SubscriptionInfo. | MultiTopicConsumer | ||
| timestamp : Number
Содержит временную метку последнего сообщения, полученного этим получателем. | AbstractConsumer | |
Защищенные свойства
Общедоступные методы
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | MultiTopicConsumer | ||
|
Вызываемый MessageResponder при приеме результата для отправленного сообщения. | MessageAgent | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Это стандартный метод добавления подписки. | MultiTopicConsumer | ||
|
Обрабатывает ChannelEvent CONNECT. | MessageAgent | |
|
Обрабатывает ChannelEvent DISCONNECT. | MessageAgent | |
|
Обрабатывает ChannelFaultEvent. | MessageAgent | |
| [переопределить]
Отключает получатель от его удаленного адресата. | AbstractConsumer | |
|
Посылает событие в поток событий. | EventDispatcher | |
|
Вызываемый MessageResponder при приеме ошибки для отправленного сообщения. | MessageAgent | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Возвращает значение true при наличии запросов в очереди для переданного сообщения. | MessageAgent | |
|
Вызывается после создания объекта реализации и присвоения всех свойств, указанных в теге. | MessageAgent | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Отключает MessageAgent от его удаленного адресата. | MessageAgent | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Запрашивает любые сообщения, которые поставлены в очередь для этого получателя на сервере. | AbstractConsumer | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Этот метод удаляет подписку, указанную с помощью подтемы и селектора. | MultiTopicConsumer | ||
|
Устанавливает учетные данные, которые MessageAgent использует для аутентификации к адресатам. | MessageAgent | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Устанавливает удаленные учетные данные, которые будут переданы удаленному адресату для аутентификации во вторичных системах. | MessageAgent | |
|
Подписывается на удаленный адресат. | AbstractConsumer | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Отмена подписки на удаленный адресат. | AbstractConsumer | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
Защищенные методы
| Метод | Определено | ||
|---|---|---|---|
[переопределить]
Возвращает сообщение о подписке. | MultiTopicConsumer | ||
[переопределить]
Возвращает сообщение об отмене подписки. | MultiTopicConsumer | ||
|
Обрабатывает ошибки аутентификации на сервере. | MessageAgent | |
|
Используется для автоматической инициализации свойства channelSet для MessageAgent перед первым подключением. | MessageAgent | |
|
Отправляет сообщение от MessageAgent его адресату с помощью ChannelSet агента. | MessageAgent | |
|
Эта функция должна быть перезаписана подклассами для реализации повторной аутентификации вследствие специфичного для них поведения тайм-аута сеанса сервера. | MessageAgent | |
События
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| Передается при получении сообщения подтверждения для отправленного сообщения. | MessageAgent | ||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| Передается при подключении основного канала, используемого MessageAgent. | MessageAgent | ||
| Передается при отключении основного канала, используемого MessageAgent. | MessageAgent | ||
| Передается при ошибке основного канала, используемого MessageAgent. | MessageAgent | ||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Передается при возникновении ошибки сообщения. | MessageAgent | ||
| Передается при получении сообщения получателем. | MultiTopicConsumer | |||
| Передается при изменении свойства connected MessageAgent. | MessageAgent | ||
Сведения о свойстве
subscriptions | свойство |
subscriptions:ArrayCollection| Язык версии: | ActionScript 3.0 |
| Версии продуктов: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сохраняет массив объектов SubscriptionInfo. Каждая подписка содержит подтему и селектор, которые могут иметь значение null. Подписка со значением подтемы, отличным от null, ограничивает подписку на сообщения, поставляемые только с этой подтемой. Если значение подтемы null, используется селектор без подтемы. Если селектор и подтема имеют значение null, подписка получает любые сообщения, нацеленные на адресат без подтемы. Подтема может содержать спецификацию подстановочного символа.
До вызова метода subscribe() это свойство может быть установлено без побочных эффектов. После того, как MultiTopicConsumer подписался на его адресат, изменение этого значения имеет побочный эффект обновления подписки MultiTopicConsumer для включения любых новых подписок и удаления любых подписок, удаленных из ArrayCollection.
Удаленный адресат должен распознать значение селекторного выражения.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .
Реализация
public function get subscriptions():ArrayCollection public function set subscriptions(value:ArrayCollection):voidСведения о конструкторе
MultiTopicConsumer | () | Конструктор |
public function MultiTopicConsumer()| Язык версии: | ActionScript 3.0 |
| Версии продуктов: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
Пример ( Использование этого примера )
function initConsumer():void
{
var consumer:Consumer = new MultiTopicConsumer();
consumer.destination = "NASDAQ";
consumer.addEventListener(MessageEvent.MESSAGE, messageHandler);
consumer.addSubscription("myStock1", "operation IN ('BID', 'Ask')");
consumer.addSubscription("myStock2", "operation IN ('BID', 'Ask')");
consumer.subscribe();
}
function messageHandler(event:MessageEvent):void
{
var msg:IMessage = event.message;
var info:Object = msg.body;
trace("-App recieved message: " + msg.toString());
}
Сведения о методе
addSubscription | () | метод |
public function addSubscription(subtopic:String = null, selector:String = null, maxFrequency:uint = 0):void| Язык версии: | ActionScript 3.0 |
| Версии продуктов: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Это стандартный метод добавления подписки. С его помощью создается только новый объект SubscriptionInfo, который добавляется к свойству подписок. Для вызова этого метода следует обеспечить подтему и селекторную строку для новой подписки. Если значение подтемы равно null, подписка применяется к сообщениям, для которых не установлена подтема в отправителе. Если значение селекторной строки равно null, все отправленные сообщения, соответствующие строке подтемы, получены этим получателем.
Параметры
subtopic:String (default = null) | |
selector:String (default = null) | |
maxFrequency:uint (default = 0) |
buildSubscribeMessage | () | метод |
override protected function buildSubscribeMessage():CommandMessage| Язык версии: | ActionScript 3.0 |
| Версии продуктов: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает сообщение о подписке.
ВозвращаетCommandMessage — CommandMessage подписки.
|
buildUnsubscribeMessage | () | метод |
override protected function buildUnsubscribeMessage(preserveDurable:Boolean):CommandMessage| Язык версии: | ActionScript 3.0 |
| Версии продуктов: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает сообщение об отмене подписки.
Параметры
preserveDurable:Boolean — Если значение true, длительные подписки JMS не удаляются, что позволяет получателям повторно подписываться и получать пропущенные сообщения позже.
|
CommandMessage — CommandMessage отмены подписки.
|
removeSubscription | () | метод |
public function removeSubscription(subtopic:String = null, selector:String = null):void| Язык версии: | ActionScript 3.0 |
| Версии продуктов: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Этот метод удаляет подписку, указанную с помощью подтемы и селектора.
Параметры
subtopic:String (default = null) | |
selector:String (default = null) |
Сведения о событии
message | Событие |
Тип объекта события:
свойство MessageEvent.type =
mx.messaging.events.MessageEventсвойство MessageEvent.type =
mx.messaging.events.MessageEvent.MESSAGE| Язык версии: | ActionScript 3.0 |
| Версии продуктов: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Передается при получении сообщения получателем.
Тип события MESSAGE; обрабатывается по получении сообщения.Значением этой константы является message.
Свойства объекта события имеют следующие значения:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
message | Сообщение, связанное с этим событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Tue Jun 12 2018, 11:34 AM Z