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 

AbstractProducer  - AS3 BlazeDS LCDS

Paketmx.messaging
Klassepublic class AbstractProducer
VererbungAbstractProducer Inheritance MessageAgent Inheritance EventDispatcher Inheritance Object
Unterklassen MultiTopicProducer, Producer

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

Der AbstractProducer ist die Basisklasse für die Klassen „Producer“ und „MultiTopicConsumer“. Diese Klassen werden zum Weiterleiten von Meldungen an den Server verwendet.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedauthenticated : Boolean
[schreibgeschützt] Gibt an, ob dieser MessageAgent eine authentifizierte Verbindung zum Ziel verwendet.
MessageAgent
  autoConnect : Boolean
Beim Wert „true“ stellt der Produzent automatisch eine Verbindung zum Ziel her, wenn die send()-Methode das erste Mal aufgerufen wird.
AbstractProducer
 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
  defaultHeaders : Object
Die standardmäßigen Header, die auf Meldungen angewendet werden sollen, die vom Produzenten gesendet wurden.
AbstractProducer
 Inheriteddestination : String
Stellt Zugriff auf das Ziel für den MessageAgent zur Verfügung.
MessageAgent
  priority : int
Die standardmäßige Meldungspriorität für die vom Produzenten gesendeten Meldungen.
AbstractProducer
  reconnectAttempts : int
Die Anzahl der Neuverbindungsversuche durch einen Produzenten, falls das Ziel nicht verfügbar ist oder die Verbindung zum Ziel geschlossen wird.
AbstractProducer
  reconnectInterval : int
Die Anzahl der Millisekunden zwischen Neuverbindungsversuchen.
AbstractProducer
 InheritedrequestTimeout : int
Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen.
MessageAgent
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
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
 Inherited
Verarbeitet ein CONNECT ChannelEvent.
MessageAgent
 Inherited
Verarbeitet ein DISCONNECT ChannelEvent.
MessageAgent
 Inherited
Verarbeitet ein ChannelFaultEvent.
MessageAgent
  
Der Produzent wird mit dem Ziel verbunden.
AbstractProducer
  
[override] Trennt den Produzenten von dem Remote-Ziel.
AbstractProducer
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Aufgerufen von einem MessageResponder nach Erhalt eines Fehlers für eine gesendete Meldung.
MessageAgent
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt true zurück, wenn anstehende Anforderungen für die übergebene Meldung vorliegen.
MessageAgent
 Inherited
Wird aufgerufen, nachdem das implementierende Objekt erstellt wurde und alle für das Tag angegebenen Eigenschaften zugewiesen wurden.
MessageAgent
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Meldet MessageAgent vom Remote-Ziel ab.
MessageAgent
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
  
send(message:IMessage):void
Sendet die angegebene Meldung an das zugehörige Ziel.
AbstractProducer
 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
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
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Ü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
 Inherited
Verarbeitet den Authentifizierungsfehler auf dem Server.
MessageAgent
 Inherited
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
Diese Funktion muss von Unterklassen überschrieben werden, um eine erneute Authentifizierung aufgrund der Zeitüberschreitung der Serversitzung zu implementieren.
MessageAgent
Ereignisse
 Ereignis Übersicht Definiert von
 InheritedAusgelöst, wenn eine Bestätigungsmeldung für eine gesendete Meldung erhalten wird.MessageAgent
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 InheritedAusgelöst, wenn der zugrundeliegende Kanal, der von dem MessageAgent verwendet wird, eine Verbindung herstellt.MessageAgent
 InheritedAusgelöst, wenn die Verbindung beim zugrundeliegende Kanal, der von dem MessageAgent verwendet wird, getrennt wird.MessageAgent
 InheritedAusgelöst, wenn beim zugrundeliegende Kanal, der von dem MessageAgent verwendet wird, Fehler auftreten.MessageAgent
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
 InheritedAusgelöst, wenn ein Meldungsfehler auftritt.MessageAgent
 InheritedAusgelöst, wenn die Eigenschaft „connected“ von dem MessageAgent geändert wird.MessageAgent
Eigenschaftendetails

autoConnect

Eigenschaft
autoConnect:Boolean

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

Beim Wert true stellt der Produzent automatisch eine Verbindung zum Ziel her, wenn die send()-Methode das erste Mal aufgerufen wird. Beim Wert false muss die connect()-Methode ausdrücklich aufgerufen werden, um eine Verbindung zum Ziel herzustellen. Diese Eigenschaft erhält standardmäßig den Wert true. Anwendungen, die in einem Offline-Modus verwendet werden, können diesen Wert jedoch auf false setzen, um zu verhindern, dass die send()-Methode eine implizite Verbindung herstellt.

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 autoConnect():Boolean
    public function set autoConnect(value:Boolean):void

defaultHeaders

Eigenschaft 
defaultHeaders: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

Die standardmäßigen Header, die auf Meldungen angewendet werden sollen, die vom Produzenten gesendet wurden. Alle standardmäßigen Header, die nicht in der Meldung vorhanden sind, werden erstellt. Wenn die Meldung bereits einen entsprechenden Header enthält, hat der Wert in der Meldung Vorrang und der standardmäßige Header-Wert wird ignoriert.

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 defaultHeaders():Object
    public function set defaultHeaders(value:Object):void

priority

Eigenschaft 
priority:int

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

Die standardmäßige Meldungspriorität für die vom Produzenten gesendeten Meldungen. Gültige Werte sind von 0 bis 9 (0 ist der niedrigste Wert) und -1 bedeutet, dass der Produzent über keinen Prioritätensatz verfügt. Wenn bei einer Meldung bereits eine Priorität definiert ist, hat diese Vorrang vor der Priorität des Produzenten.

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 priority():int
    public function set priority(value:int):void

reconnectAttempts

Eigenschaft 
reconnectAttempts:int

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

Die Anzahl der Neuverbindungsversuche durch einen Produzenten, falls das Ziel nicht verfügbar ist oder die Verbindung zum Ziel geschlossen wird. Ein Wert von -1 ermöglicht eine unendliche Anzahl von Versuchen. Ein Wert von null deaktiviert Neuverbindungsversuche.

Neuverbindungsversuche werden gemäß des Intervallwerts für Neuverbindungen konstant durchgeführt. Wenn bei einem Neuverbindungsversuch der zugrundeliegende Kanal für den Produzenten nicht verbunden ist oder eine Verbindungsherstellung versucht, beginnt der Kanal einen Verbindungsversuch. Nachfolgende Verbindungsversuche vom Produzenten, die während des zugrundeliegenden Verbindungsversuchs vom Kanal durchgeführt werden, werden effektiv ignoriert, bis der ausstehende Verbindungsversuch des Kanals erfolgreich ist oder fehlschlägt.

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 reconnectAttempts():int
    public function set reconnectAttempts(value:int):void

Verwandte API-Elemente

reconnectInterval

Eigenschaft 
reconnectInterval:int

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

Die Anzahl der Millisekunden zwischen Neuverbindungsversuchen. Wenn ein Produzent keine Bestätigung für einen Verbindungsversuch erhält, wartet er die angegebene Anzahl von Millisekunden, bevor er einen nachfolgenden Neuverbindungsversuch durchführt. Durch Festlegen des Werts auf null werden Neuverbindungsversuche deaktiviert.

Neuverbindungsversuche werden gemäß dieses Werts konstant durchgeführt. Wenn bei einem Neuverbindungsversuch der zugrundeliegende Kanal für den Produzenten nicht verbunden ist oder eine Verbindungsherstellung versucht, beginnt der Kanal einen Verbindungsversuch. Nachfolgende Verbindungsversuche vom Produzenten, die während des zugrundeliegenden Verbindungsversuchs vom Kanal durchgeführt werden, werden effektiv ignoriert, bis der ausstehende Verbindungsversuch des Kanals erfolgreich ist oder fehlschlägt.

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 reconnectInterval():int
    public function set reconnectInterval(value:int):void

Auslöser
ArgumentError — Im Falle, dass der zugewiesene Wert negativ ist.

Verwandte API-Elemente

Methodendetails

connect

()Methode
public function connect():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

Der Produzent wird mit dem Ziel verbunden. Wenn eine Verbindung hergestellt wird, ändert sich der Wert der Eigenschaft connected zu true. Diese Eigenschaft ist bindend und erstellt Ereignisse des Typs PropertyChangeEvent. Die intern gesendete CommandMessage TRIGGER_CONNECT_OPERATION führt zu einem Bestätigungs- oder Fehlerereignis, je nachdem, ob der zugrundeliegende Kanal eine Verbindung herstellt.


Auslöser
InvalidDestinationError — In dem Falle, dass kein Ziel festgelegt ist.

Beispiel
Verwendung dieses Beispiels
         var producer:Producer = new Producer();
         producer.destination = "TestTopic";
         producer.addEventListener(PropertyChangeEvent.PROPERTY_CHANGE, handleConnect);
         producer.connect();
      

disconnect

()Methode 
override public function disconnect():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

Trennt den Produzenten von dem Remote-Ziel. Diese Methode wartet nicht auf den Abschluss von ausstehenden Netzwerkvorgängen. Nach dem Aufrufen von disconnect() meldet der Produzent, dass keine Verbindung besteht, und es werden keine ausstehenden Meldungsbestätigungen oder -fehler erhalten. Durch die Trennung der Verbindung werden automatische Neuverbindungsversuche gestoppt, falls diese ausgeführt werden.

send

()Methode 
public function send(message:IMessage):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

Sendet die angegebene Meldung an das zugehörige Ziel. Wenn der Produzent zum Veröffentlichen/Abonnieren von Meldungen verwendet wird, sollten nur Meldungen des Typs AsyncMessage gesendet werden, es sei denn der benutzerdefinierte Meldungstyp wird verwendet und das Meldungsziel am Server wurde zur Verarbeitung des benutzerdefinierten Meldungstyps konfiguriert.

Parameter

message:IMessage — Die zu sendende Meldung.


Auslöser
InvalidDestinationError — In dem Falle, dass kein Ziel festgelegt ist.

Beispiel
Verwendung dieses Beispiels
         var producer:Producer = new Producer();
         producer.destination = "TestTopic";
         var msg:AsyncMessage = new AsyncMessage();
         msg.body = "test message";
         producer.send(msg);
      




[ 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.