MultiTopicConsumer

Пакет	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 подписывается на адресат с одним clientId и поставляет сообщения одному обработчику событий. В отличие от получателя, он позволяет регистрировать подписки для списка подтем и селекторных выражений одновременно из одного обработчика сообщений. Если получатель имеет свойства подтемы и селекторные свойства, у этого компонента есть метод addSubscription(subtopic, selector), используемый для добавления новой подписки к существующему набору подписок. В качестве альтернативы можно заполнить свойство подписок списком экземпляров SubscriptionInfo, определяющих подписки для этого адресата.

Как обычный получатель, MultiTopicConsumer отправляет сообщения о подписке и отмене подписки, генерирующие MessageAckEvent или MessageFaultEvent в зависимости от того, была операция успешно выполнена или нет. Будучи однажды подписан, MultiTopicConsumer передает MessageEvent для каждого получаемого им сообщения.

Синтаксис MXML expanded

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

The <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

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

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

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

	Свойство		Определено
		_shouldBeSubscribed : Boolean Флаг, указывающий, должен ли этот получатель быть подписан или нет.	AbstractConsumer

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

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

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

	Метод		Определено
		MultiTopicConsumer() Конструктор.	MultiTopicConsumer
		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
		addSubscription(subtopic:String = null, selector:String = null, maxFrequency:uint = 0):void Это стандартный метод добавления подписки.	MultiTopicConsumer
		channelConnectHandler(event:ChannelEvent):void Обрабатывает ChannelEvent CONNECT.	MessageAgent
		channelDisconnectHandler(event:ChannelEvent):void Обрабатывает ChannelEvent DISCONNECT.	MessageAgent
		channelFaultHandler(event:ChannelFaultEvent):void Обрабатывает ChannelFaultEvent.	MessageAgent
		disconnect():void [переопределить] Отключает получатель от его удаленного адресата.	AbstractConsumer
		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
		receive(timestamp:Number = 0):void Запрашивает любые сообщения, которые поставлены в очередь для этого получателя на сервере.	AbstractConsumer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		removeSubscription(subtopic:String = null, selector:String = null):void Этот метод удаляет подписку, указанную с помощью подтемы и селектора.	MultiTopicConsumer
		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
		subscribe(clientId:String = null):void Подписывается на удаленный адресат.	AbstractConsumer
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		unsubscribe(preserveDurable:Boolean = false):void Отмена подписки на удаленный адресат.	AbstractConsumer
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

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

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

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

	Метод		Определено
		buildSubscribeMessage():CommandMessage [переопределить] Возвращает сообщение о подписке.	MultiTopicConsumer
		buildUnsubscribeMessage(preserveDurable:Boolean):CommandMessage [переопределить] Возвращает сообщение об отмене подписки.	MultiTopicConsumer
		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
message	Передается при получении сообщения получателем.	MultiTopicConsumer
propertyChange	Передается при изменении свойства 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

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

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

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

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

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

MultiTopicConsumer - AS3 BlazeDS LCDS

Пакетыx

Элементы языка

Приложения

Пакет mx.messaging

subscriptions

addSubscription

buildSubscribeMessage

buildUnsubscribeMessage

removeSubscription

message

	`subtopic:String` (default = `null`) — Подтема для новой подписки.

	`selector:String` (default = `null`) — Селектор для новой подписки.

	`maxFrequency:uint` (default = `0`) — Максимальное количество сообщений в секунду, которое получатель предпочитает получать для подписки. Следует отметить, что это значение переписывает maxFrequency ширины получателя.