ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.messaging 

MultiTopicConsumer  - AS3 BlazeDS LCDS
Paketmx.messaging
Klassepublic class MultiTopicConsumer
VererbungMultiTopicConsumer Inheritance AbstractConsumer Inheritance MessageAgent Inheritance EventDispatcher Inheritance 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-SyntaxexpandedMXML-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
 EigenschaftDefiniert von
 Inheritedauthenticated : Boolean
[schreibgeschützt] Gibt an, ob dieser MessageAgent eine authentifizierte Verbindung zum Ziel verwendet.
MessageAgent
 InheritedchannelSet : ChannelSet
Stellt Zugriff auf den ChannelSet zur Verfügung, der von dem MessageAgent verwendet wird.
MessageAgent
 InheritedclientId : String
[schreibgeschützt] Stellt Zugriff auf die Client-ID für den MessageAgent zur Verfügung.
MessageAgent
 Inheritedconnected : Boolean
[schreibgeschützt] Gibt an, ob dieser MessageAgent derzeit über den zugehörigen ChannelSet mit dem jeweiligen Ziel verbunden ist.
MessageAgent
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 Inheriteddestination : String
Stellt Zugriff auf das Ziel für den MessageAgent zur Verfügung.
MessageAgent
 InheritedmaxFrequency : uint
Bestimmt die maximale Anzahl von Meldungen pro Sekunde, die der Verbraucher erhalten möchte.
AbstractConsumer
 InheritedrequestTimeout : int
Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen.
MessageAgent
 InheritedresubscribeAttempts : 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
 InheritedresubscribeInterval : int
Die Anzahl in Millisekunden zwischen Versuchen zum erneuten Abonnement.
AbstractConsumer
 Inheritedsubscribed : Boolean
[schreibgeschützt] Gibt an, ob derzeit ein Abonnement des Verbrauchers besteht.
AbstractConsumer
  subscriptions : ArrayCollection
Speichert ein Array von SubscriptionInfo-Objekten.
MultiTopicConsumer
 Inheritedtimestamp : Number
Enthält den Zeitstempel der letzten Meldung, die dieser Verbraucher erhalten hat.
AbstractConsumer
Geschützte Eigenschaften
 EigenschaftDefiniert von
 Inherited_shouldBeSubscribed : Boolean
Flag, der angibt, ob für diesen Verbraucher ein Abonnement erstellt werden soll.
AbstractConsumer
Öffentliche Methoden
 MethodeDefiniert von
  
MultiTopicConsumer()
Konstruktor.
MultiTopicConsumer
 Inherited
acknowledge(ackMsg:AcknowledgeMessage, msg:IMessage):void
Aufgerufen von MessageResponder nach Erhalt eines Ergebnisses für eine gesendete Meldung.
MessageAgent
 Inherited
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
 Inherited
channelConnectHandler(event:ChannelEvent):void
Verarbeitet ein CONNECT ChannelEvent.
MessageAgent
 Inherited
channelDisconnectHandler(event:ChannelEvent):void
Verarbeitet ein DISCONNECT ChannelEvent.
MessageAgent
 Inherited
channelFaultHandler(event:ChannelFaultEvent):void
Verarbeitet ein ChannelFaultEvent.
MessageAgent
 Inherited
disconnect():void
[override] Trennt den Verbraucher von dem Remote-Ziel.
AbstractConsumer
 Inherited
dispatchEvent(event:Event):Boolean
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
fault(errMsg:ErrorMessage, msg:IMessage):void
Aufgerufen von einem MessageResponder nach Erhalt eines Fehlers für eine gesendete Meldung.
MessageAgent
 Inherited
hasEventListener(type:String):Boolean
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
hasPendingRequestForMessage(msg:IMessage):Boolean
Gibt true zurück, wenn anstehende Anforderungen für die übergebene Meldung vorliegen.
MessageAgent
 Inherited
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
 Inherited
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
 Inherited
logout():void
Meldet MessageAgent vom Remote-Ziel ab.
MessageAgent
 Inherited
propertyIsEnumerable(name:String):Boolean
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
receive(timestamp:Number = 0):void
Fordert alle Meldungen an, die sich für diesen Verbraucher am Server in der Warteschlange befinden.
AbstractConsumer
 Inherited
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
 Inherited
setCredentials(username:String, password:String, charset:String = null):void
Definieren Sie die Benutzerdaten, die der MessageAgent zur Authentifizierung an den Zielen verwendet.
MessageAgent
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
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
 Inherited
subscribe(clientId:String = null):void
Erstellt das Abonnement am Remote-Ziel.
AbstractConsumer
 Inherited
toLocaleString():String
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
toString():String
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
unsubscribe(preserveDurable:Boolean = false):void
Hebt das Abonnement am Remote-Ziel auf.
AbstractConsumer
 Inherited
valueOf():Object
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
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
 MethodeDefiniert 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
 Inherited
handleAuthenticationFault(errMsg:ErrorMessage, msg:IMessage):void
Verarbeitet den Authentifizierungsfehler auf dem Server.
MessageAgent
 Inherited
initChannelSet(message:IMessage):void
Wird zum automatischen Initialisieren der Eigenschaft „channelSet“ für den MessageAgent verwendet, bevor erstmalig eine Verbindung hergestellt wird.
MessageAgent
 Inherited
internalSend(message:IMessage, waitForClientId:Boolean = true):void
Sendet mithilfe des ChannelSet des Agenten eine Meldung von dem MessageAgent zum Ziel.
MessageAgent
 Inherited
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.
 Ereignis Übersicht Definiert von
 Inherited
acknowledge
Ausgelöst, wenn eine Bestätigungsmeldung für eine gesendete Meldung erhalten wird.MessageAgent
 Inherited
activate
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited
channelConnect
Ausgelöst, wenn der zugrundeliegende Kanal, der von dem MessageAgent verwendet wird, eine Verbindung herstellt.MessageAgent
 Inherited
channelDisconnect
Ausgelöst, wenn die Verbindung beim zugrundeliegende Kanal, der von dem MessageAgent verwendet wird, getrennt wird.MessageAgent
 Inherited
channelFault
Ausgelöst, wenn beim zugrundeliegende Kanal, der von dem MessageAgent verwendet wird, Fehler auftreten.MessageAgent
 Inherited
deactivate
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
 Inherited
fault
Ausgelöst, wenn ein Meldungsfehler auftritt.MessageAgent
  
message
Ausgelöst, wenn eine Meldung vom Verbraucher erhalten wird.MultiTopicConsumer
 Inherited
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

MultiTopicConsumer

()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:

EigenschaftWert
bubblesfalse
cancelablefalse
currentTargetDas 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.
messageDie Meldung, die mit diesem Ereignis verknüpft ist.
targetDas 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.



© 2015 Adobe Systems Incorporated. All rights reserved.
Tue Jun 12 2018, 10:04 AM Z
 

 

Rechtliche Hinweise | Onlinedatenschutzerklärung
[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.