MultiTopicConsumer

Paket	mx.messaging
Klasse	public class MultiTopicConsumer
Vererbung	MultiTopicConsumer AbstractConsumer MessageAgent EventDispatcher Object

Sprachversion:

ActionScript 3.0

Produktversionen:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services für Java EE 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Genauso wie ein Verbraucher (Consumer) kann MultiTopicConsumer ein Ziel durch eine einzige ClientId abonnieren und Meldungen einer einzigen Ereignisprozedur zustellen. Im Gegensatz zu einem Verbraucher können Abonnements für eine Liste von untergeordneten Themen und Selektor-Ausdrücke gleichzeitig von einer einzigen Meldungsprozedur registriert werden. Wenn der Verbraucher über die Eigenschaften subtopic und selector verfügt, verwendet diese Komponente eine Methode des Typs addSubscription(subtopic, selector) zum Hinzufügen eines neuen Abonnements zu einem vorhandenen Satz von Abonnements. Stattdessen können Sie die Eigenschaft „subscriptions“ mit einer Liste von SubscriptionInfo-Instanzen ausfüllen, die die Abonnements für dieses Ziel definieren.

Genauso wie ein normaler Verbraucher (Consumer) sendet MultiTopicConsumer Meldungen zum Abonnement bzw. zur Abonnementaufhebung, die ein MessageAckEvent oder MessageFaultEvent generieren, je nachdem, ob der Vorgang erfolgreich war. Nach einer Abonnierung löst MultiTopicConsumer ein MessageEvent für jede erhaltene Meldung aus.

MXML-Syntax expanded

MXML-Syntax ausblenden

The <mx:MultiTopicConsumer> tag has these properties:

       <mx:Consumer
        Properties
        subscriptions=""an empty ArrayCollection of SubscriptionInfo objects"
        resubscribeAttempts="5"
        resubscribeInterval="5000"
        timestamp="No default."
      />

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		authenticated : Boolean [schreibgeschützt] Gibt an, ob dieser MessageAgent eine authentifizierte Verbindung zum Ziel verwendet.	MessageAgent
		channelSet : ChannelSet Stellt Zugriff auf den ChannelSet zur Verfügung, der von dem MessageAgent verwendet wird.	MessageAgent
		clientId : String [schreibgeschützt] Stellt Zugriff auf die Client-ID für den MessageAgent zur Verfügung.	MessageAgent
		connected : Boolean [schreibgeschützt] Gibt an, ob dieser MessageAgent derzeit über den zugehörigen ChannelSet mit dem jeweiligen Ziel verbunden ist.	MessageAgent
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		destination : String Stellt Zugriff auf das Ziel für den MessageAgent zur Verfügung.	MessageAgent
		maxFrequency : uint Bestimmt die maximale Anzahl von Meldungen pro Sekunde, die der Verbraucher erhalten möchte.	AbstractConsumer
		requestTimeout : int Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen.	MessageAgent
		resubscribeAttempts : int Die Anzahl der Versuche für erneute Abonnementerstellung durch den Verbraucher, falls das Ziel nicht verfügbar ist oder die Verbindung zum Ziel fehlschlägt.	AbstractConsumer
		resubscribeInterval : int Die Anzahl in Millisekunden zwischen Versuchen zum erneuten Abonnement.	AbstractConsumer
		subscribed : Boolean [schreibgeschützt] Gibt an, ob derzeit ein Abonnement des Verbrauchers besteht.	AbstractConsumer
		subscriptions : ArrayCollection Speichert ein Array von SubscriptionInfo-Objekten.	MultiTopicConsumer
		timestamp : Number Enthält den Zeitstempel der letzten Meldung, die dieser Verbraucher erhalten hat.	AbstractConsumer

Geschützte Eigenschaften

Vererbte geschützte Eigenschaften ausblenden

Vererbte geschützte Eigenschaften anzeigen

	Eigenschaft		Definiert von
		_shouldBeSubscribed : Boolean Flag, der angibt, ob für diesen Verbraucher ein Abonnement erstellt werden soll.	AbstractConsumer

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		MultiTopicConsumer() Konstruktor.	MultiTopicConsumer
		acknowledge(ackMsg:AcknowledgeMessage, msg:IMessage):void Aufgerufen von MessageResponder nach Erhalt eines Ergebnisses für eine gesendete Meldung.	MessageAgent
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	EventDispatcher
		addSubscription(subtopic:String = null, selector:String = null, maxFrequency:uint = 0):void Dies ist eine bequeme Methode zum Hinzufügen eines neuen Abonnements.	MultiTopicConsumer
		channelConnectHandler(event:ChannelEvent):void Verarbeitet ein CONNECT ChannelEvent.	MessageAgent
		channelDisconnectHandler(event:ChannelEvent):void Verarbeitet ein DISCONNECT ChannelEvent.	MessageAgent
		channelFaultHandler(event:ChannelFaultEvent):void Verarbeitet ein ChannelFaultEvent.	MessageAgent
		disconnect():void [override] Trennt den Verbraucher von dem Remote-Ziel.	AbstractConsumer
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		fault(errMsg:ErrorMessage, msg:IMessage):void Aufgerufen von einem MessageResponder nach Erhalt eines Fehlers für eine gesendete Meldung.	MessageAgent
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		hasPendingRequestForMessage(msg:IMessage):Boolean Gibt true zurück, wenn anstehende Anforderungen für die übergebene Meldung vorliegen.	MessageAgent
		initialized(document:Object, id:String):void Wird aufgerufen, nachdem das implementierende Objekt erstellt wurde und alle für das Tag angegebenen Eigenschaften zugewiesen wurden.	MessageAgent
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		logout():void Meldet MessageAgent vom Remote-Ziel ab.	MessageAgent
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		receive(timestamp:Number = 0):void Fordert alle Meldungen an, die sich für diesen Verbraucher am Server in der Warteschlange befinden.	AbstractConsumer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		removeSubscription(subtopic:String = null, selector:String = null):void Diese Methode entfernt das Abonnement, das vom untergeordneten Thema und Selektor angegeben wurde.	MultiTopicConsumer
		setCredentials(username:String, password:String, charset:String = null):void Definieren Sie die Benutzerdaten, die der MessageAgent zur Authentifizierung an den Zielen verwendet.	MessageAgent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		setRemoteCredentials(username:String, password:String, charset:String = null):void Definiert die Remote-Benutzerdaten, die an das Remote-Ziel zur Authentifizierung von sekundären Systemen übergeben werden.	MessageAgent
		subscribe(clientId:String = null):void Erstellt das Abonnement am Remote-Ziel.	AbstractConsumer
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		unsubscribe(preserveDurable:Boolean = false):void Hebt das Abonnement am Remote-Ziel auf.	AbstractConsumer
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Geschützte Methoden

Vererbte geschützte Methoden ausblenden

Vererbte geschützte Methoden anzeigen

	Methode		Definiert von
		buildSubscribeMessage():CommandMessage [override] Gibt eine Meldung zum Abonnement zurück.	MultiTopicConsumer
		buildUnsubscribeMessage(preserveDurable:Boolean):CommandMessage [override] Gibt eine Meldung zur Abonnementaufhebung zurück.	MultiTopicConsumer
		handleAuthenticationFault(errMsg:ErrorMessage, msg:IMessage):void Verarbeitet den Authentifizierungsfehler auf dem Server.	MessageAgent
		initChannelSet(message:IMessage):void Wird zum automatischen Initialisieren der Eigenschaft „channelSet“ für den MessageAgent verwendet, bevor erstmalig eine Verbindung hergestellt wird.	MessageAgent
		internalSend(message:IMessage, waitForClientId:Boolean = true):void Sendet mithilfe des ChannelSet des Agenten eine Meldung von dem MessageAgent zum Ziel.	MessageAgent
		reAuthorize(msg:IMessage):void Diese Funktion muss von Unterklassen überschrieben werden, um eine erneute Authentifizierung aufgrund der Zeitüberschreitung der Serversitzung zu implementieren.	MessageAgent

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
acknowledge	Ausgelöst, wenn eine Bestätigungsmeldung für eine gesendete Meldung erhalten wird.	MessageAgent
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
channelConnect	Ausgelöst, wenn der zugrundeliegende Kanal, der von dem MessageAgent verwendet wird, eine Verbindung herstellt.	MessageAgent
channelDisconnect	Ausgelöst, wenn die Verbindung beim zugrundeliegende Kanal, der von dem MessageAgent verwendet wird, getrennt wird.	MessageAgent
channelFault	Ausgelöst, wenn beim zugrundeliegende Kanal, der von dem MessageAgent verwendet wird, Fehler auftreten.	MessageAgent
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
fault	Ausgelöst, wenn ein Meldungsfehler auftritt.	MessageAgent
message	Ausgelöst, wenn eine Meldung vom Verbraucher erhalten wird.	MultiTopicConsumer
propertyChange	Ausgelöst, wenn die Eigenschaft „connected“ von dem MessageAgent geändert wird.	MessageAgent

Eigenschaftendetails

subscriptions

Eigenschaft

subscriptions:ArrayCollection

Sprachversion:

ActionScript 3.0

Produktversionen:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services für Java EE 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Speichert ein Array von SubscriptionInfo-Objekten. Jedes Abonnement enthält ein untergeordnetes Thema und einen Selektor, die beide einen leeren Wert aufweisen können. Ein Abonnement mit einem nicht leeren Wert für das untergeordnete Thema beschränkt das Abonnement auf Meldungen, die nur mit diesem untergeordneten Thema zugestellt wurden. Wenn ein untergeordnetes Thema einen leeren Wert aufweist, verwendet es den Selektor ohne untergeordnetes Thema. Wenn der Selektor und das untergeordnete Thema einen leeren Wert aufweisen, empfängt das Abonnement alle Meldungen, die ohne untergeordnetes Thema an das Ziel gerichtet sind. Das untergeordnete Thema kann eine Platzhalterspezifikation enthalten.

Vor einem Aufruf der subscribe()-Methode kann diese Eigenschaft ohne Nebeneffekte gesetzt werden. Nachdem MultiTopicConsumer an dem Ziel abonniert wurde, wird durch Ändern dieses Werts außerdem das Abonnement von MultiTopicConsumer aktualisiert, um neue Abonnements einzuschließen und alle aus ArrayCollection gelöschten Abonnements zu entfernen.

Das Remote-Ziel muss den Wert des Selektor-Ausdrucks verstehen.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.

Implementierung
public function get subscriptions():ArrayCollection
public function set subscriptions(value:ArrayCollection):void

Konstruktordetails

()

Konstruktor

public function MultiTopicConsumer()

Sprachversion:

ActionScript 3.0

Produktversionen:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services für Java EE 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Beispiel ( Verwendung dieses Beispiels )

           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());
           }

Methodendetails

addSubscription

()

Methode

public function addSubscription(subtopic:String = null, selector:String = null, maxFrequency:uint = 0):void

Sprachversion:

ActionScript 3.0

Produktversionen:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services für Java EE 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Dies ist eine bequeme Methode zum Hinzufügen eines neuen Abonnements. Es wird ein neues SubscriptionInfo-Objekt erstellt und zur Eigenschaft „subscriptions“ hinzugefügt. Um diese Methode aufzurufen, geben Sie den String für das untergeordnete Thema und den Selektor für das neue Abonnement an. Wenn das untergeordnete Thema keinen Wert aufweist, gilt das Abonnement für Meldungen, für die kein untergeordnetes Thema im Produzenten gesetzt ist. Wenn der Selektor-String keinen Wert aufweist, werden alle gesendeten Meldungen, die dem String für das untergeordnete Thema entsprechen, von diesem Verbraucher empfangen.

Parameter

	`subtopic:String` (default = `null`) — Das untergeordnete Thema für das neue Abonnement.

	`selector:String` (default = `null`) — Der Selektor für das neue Abonnement.

	`maxFrequency:uint` (default = `0`) — Die maximal Anzahl von Meldungen pro Sekunde, die der Verbraucher für das Abonnement erhalten möchte. Dieser Wert überschreibt den verbraucherweiten Wert von maxFrequency.

buildSubscribeMessage

()

Methode

override protected function buildSubscribeMessage():CommandMessage

Sprachversion:

ActionScript 3.0

Produktversionen:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services für Java EE 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt eine Meldung zum Abonnement zurück.

Rückgabewerte

CommandMessage — Die Abonnement-CommandMessage.

buildUnsubscribeMessage

()

Methode

override protected function buildUnsubscribeMessage(preserveDurable:Boolean):CommandMessage

Sprachversion:

ActionScript 3.0

Produktversionen:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services für Java EE 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt eine Meldung zur Abonnementaufhebung zurück.

Parameter

preserveDurable:Boolean — Bei dem Wert „true“ werden permanente JMS-Abonnements nicht zerstört. Dadurch können Verbraucher zu einem späteren Zeitpunkt erneut ein Abonnement durchführen und fehlende Meldungen empfangen.

Rückgabewerte

CommandMessage — Die Abonnementaufhebungs-CommandMessage.

removeSubscription

()

Methode

public function removeSubscription(subtopic:String = null, selector:String = null):void

Sprachversion:

ActionScript 3.0

Produktversionen:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services für Java EE 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Diese Methode entfernt das Abonnement, das vom untergeordneten Thema und Selektor angegeben wurde.

Parameter

	`subtopic:String` (default = `null`) — Das untergeordnete Thema für das Abonnement.

	`selector:String` (default = `null`) — Der Selektor für das Abonnement.

Ereignisdetails

message

Ereignis

Ereignisobjekttyp: mx.messaging.events.MessageEvent
Eigenschaft MessageEvent.type = mx.messaging.events.MessageEvent.MESSAGE

Sprachversion:

ActionScript 3.0

Produktversionen:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services für Java EE 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ausgelöst, wenn eine Meldung vom Verbraucher erhalten wird.

Der Ereignistyp MESSAGE. Wird nach Erhalt einer Meldung ausgelöst.

Der Wert dieser Konstante ist "message".

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`cancelable`	false
`currentTarget`	Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise `myButton.addEventListener()` zur Registrierung eines Ereignis-Listeners verwenden, weist `currentTarget` den Wert „myButton“ auf.
`message`	Die Meldung, die mit diesem Ereignis verknüpft ist.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die `currentTarget`-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

Rechtliche Hinweise | Onlinedatenschutzerklärung

MultiTopicConsumer - AS3 BlazeDS LCDS

Klassen x

subscriptions