MessageAgent

Paket	mx.messaging
Klasse	public class MessageAgent
Vererbung	MessageAgent EventDispatcher Object
Implementiert	IMXMLObject
Unterklassen	AbstractConsumer, AbstractProducer

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 MessageAgent-Klasse stellt die grundlegende Funktion auf niedriger Ebene zur Verfügung, die bei der Meldungsverarbeitung für ein Ziel üblich ist.

Hinweis: Nur für fortgeschrittene Benutzer. Verwenden Sie diese Klasse zum Erstellen von benutzerdefinierten Meldungsagenten wie die vorhandenen Producer- und Consumer-Klassen.

MXML-Syntax expanded

MXML-Syntax ausblenden

All message agent classes, including the Producer and Consumer classes, extend MessageAgent and inherit the following tag attributes:

   <mx:tagname

    Properties
    channelSet="No default."
    clientId="No default."
    connected="false"
    destination="No default."
    requestTimeout="-1"
    subtopic="No default."
 
 
   Events
    acknowledge="No default."
    channelConnect="No default."
    channelDisconnect="No default."
    channelFault="No default."
    fault="No default."
    propertyChange="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
		requestTimeout : int Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen.	MessageAgent

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		MessageAgent() Konstruktor.	MessageAgent
		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
		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 Trennt die Netzwerkverbindung des MessageAgent.	MessageAgent
		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
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		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
		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
		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

	Methode		Definiert von
		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
propertyChange	Ausgelöst, wenn die Eigenschaft „connected“ von dem MessageAgent geändert wird.	MessageAgent

Eigenschaftendetails

authenticated

Eigenschaft

authenticated:Boolean [schreibgeschützt]

Gibt an, ob dieser MessageAgent eine authentifizierte Verbindung zum Ziel verwendet.

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

channelSet

Eigenschaft

channelSet:ChannelSet

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

Stellt Zugriff auf den ChannelSet zur Verfügung, der von dem MessageAgent verwendet wird. Der ChannelSet kann manuell erstellt und zugewiesen werden oder wird dynamisch initialisiert, um die konfigurierten Kanäle für das Ziel dieses MessageAgent zu verwenden.

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

clientId

Eigenschaft

clientId:String [schreibgeschützt]

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

Stellt Zugriff auf die Client-ID für den MessageAgent zur Verfügung. Bei MessageAgents wird die Client-ID durch das Remote-Ziel zugewiesen. Dieser Wert wird zum Leiten von Meldungen vom Remote-Ziel an den richtigen MessageAgent verwendet.

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

connected

Eigenschaft

connected:Boolean [schreibgeschützt]

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 an, ob dieser MessageAgent derzeit über den zugehörigen ChannelSet mit dem jeweiligen Ziel verbunden ist. Das Ereignis propertyChange wird ausgelöst, wenn diese Eigenschaft sich ändert.

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

destination

Eigenschaft

destination:String

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

Stellt Zugriff auf das Ziel für den MessageAgent zur Verfügung. Durch Ändern des Ziels wird die Verbindung des MessageAgent getrennt, falls derzeit eine Verbindung besteht.

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

Auslöser

InvalidDestinationError — In dem Fall, dass der Zielwert leer ist oder eine Länge von null aufweist.

requestTimeout

Eigenschaft

requestTimeout: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

Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen. Wenn vor Erreichen der Zeitüberschreitung keine Bestätigung, keine Antwort oder kein Fehler von einem Remote-Ziel erhalten wurde, gilt die Meldung am Client als fehlgeschlagen. Ein Wert, der kleiner oder gleich null ist, verhindert die Zeitüberschreitung der Anforderung.

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

Konstruktordetails

()

Konstruktor

public function MessageAgent()

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.

Methodendetails

acknowledge

()

Methode

public function acknowledge(ackMsg:AcknowledgeMessage, msg: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

Aufgerufen von MessageResponder nach Erhalt eines Ergebnisses für eine gesendete Meldung. Unterklassen können diese Methode überschreiben, wenn eine benutzerdefinierte Bestätigungsverarbeitung durchgeführt werden soll, müssen jedoch auch super.acknowledge() aufrufen. Durch diese Methode wird MessageAckEvent ausgelöst.

Parameter

	`ackMsg:AcknowledgeMessage` — Die zurückgesendete AcknowledgMessage.

	`msg:IMessage` — Die ursprünglich gesendete Meldung.

channelConnectHandler

()

Methode

public function channelConnectHandler(event:ChannelEvent):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

Verarbeitet ein CONNECT ChannelEvent. Unterklassen, die eine benutzerdefinierte Verarbeitung durchführen müssen, sollten diese Methode überschreiben und super.channelConnectHandler() aufrufen.

Parameter

event:ChannelEvent — Das ChannelEvent.

channelDisconnectHandler

()

Methode

public function channelDisconnectHandler(event:ChannelEvent):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

Verarbeitet ein DISCONNECT ChannelEvent. Unterklassen, die eine benutzerdefinierte Verarbeitung durchführen müssen, sollten diese Methode überschreiben und super.channelDisconnectHandler() aufrufen.

Parameter

event:ChannelEvent — Das ChannelEvent.

channelFaultHandler

()

Methode

public function channelFaultHandler(event:ChannelFaultEvent):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

Verarbeitet ein ChannelFaultEvent. Unterklassen, die eine benutzerdefinierte Verarbeitung durchführen müssen, sollten diese Methode überschreiben und super.channelFaultHandler() aufrufen.

Parameter

event:ChannelFaultEvent — ChannelFaultEvent

disconnect

()

Methode

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 die Netzwerkverbindung des MessageAgent. Diese Methode wartet nicht, bis anstehende Netzwerkvorgänge abgeschlossen sind.

fault

()

Methode

public function fault(errMsg:ErrorMessage, msg: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

Aufgerufen von einem MessageResponder nach Erhalt eines Fehlers für eine gesendete Meldung. Unterklassen können diese Methode überschreiben, wenn eine benutzerdefinierte Fehlerverarbeitung durchgeführt werden soll, müssen jedoch auch super.fault() aufrufen. Durch diese Methode wird ein MessageFaultEvent ausgelöst.

Parameter

	`errMsg:ErrorMessage` — Die Fehlermeldung (ErrorMessage).

	`msg:IMessage` — Die ursprünglich gesendete Meldung, durch die der Fehler verursacht wurde.

handleAuthenticationFault

()

Methode

protected function handleAuthenticationFault(errMsg:ErrorMessage, msg: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

Verarbeitet den Authentifizierungsfehler auf dem Server. Wenn das Flag zur Authentifizierung auf „true“ gesetzt ist, muss der Authentifizierungsfehler durch das Ablaufen der Sitzung auf dem Server verursacht worden sein. Setzen Sie den Authentifizierungsstatus auf „false“ und falls das loginAfterDisconnect-Flag aktiviert ist, senden Sie Benutzerdaten erneut an den Server, indem Sie die Verbindung trennen und die Meldung anschließend erneut senden.

Parameter

	`errMsg:ErrorMessage` — Die Fehlermeldung.

	`msg:IMessage` — Die den Fehler verursachende Meldung sollte erneut gesendet werden, nachdem durch eine Verbindungsaufhebung/Verbindung eine erneute Autorisierung durchgeführt wurde.

hasPendingRequestForMessage

()

Methode

public function hasPendingRequestForMessage(msg:IMessage):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

Gibt „true“ zurück, falls ausstehende Anforderungen für die übergebene Meldung vorhanden sind. Diese Methode sollte von Unterklassen überschrieben werden.

Parameter

msg:IMessage — Die Meldung, für die das Vorhandensein anstehender Anforderungen überprüft wird.

Rückgabewerte

Boolean — Gibt true zurück, wenn anstehende Anforderungen für die übergebene Meldung vorliegen.

initChannelSet

()

Methode

protected function initChannelSet(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

Wird zum automatischen Initialisieren der Eigenschaft channelSet für den MessageAgent verwendet, bevor erstmalig eine Verbindung hergestellt wird. Untergeordnete Typen können eine Überschreibung verwenden, um eine benutzerdefinierte Initialisierung durchzuführen.

Parameter

message:IMessage — Die zu sendende Meldung.

initialized

()

Methode

public function initialized(document:Object, id:String):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

Wird aufgerufen, nachdem das implementierende Objekt erstellt wurde und alle für das Tag angegebenen Eigenschaften zugewiesen wurden.

Parameter

	`document:Object` — Das MXML-Dokument, durch das dieses Objekt erstellt wurde.

	`id:String` — Die von dem Dokument verwendete ID, um dieses Objekt zu referenzieren. Wenn das Objekt eine tiefe Eigenschaft im Dokument ist, ist die ID null.

internalSend

()

Methode

protected function internalSend(message:IMessage, waitForClientId:Boolean = true):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 mithilfe des ChannelSet des Agenten eine Meldung von dem MessageAgent zum Ziel. Die MessageAgent-Unterklassen müssen diese Methode zum Senden der Meldungen verwenden.

Parameter

	`message:IMessage` — Die zu sendende Meldung.

	`waitForClientId:Boolean` (default = `true`) — Wenn der Wert „true“ beträgt, kann die Meldung in die Warteschlange gestellt werden, bis eine clientId dem Agenten zugewiesen wurde. Im Allgemeinen ist dies das gewünschte Verhalten. Für ein besonderes Verhalten (automatische Neuverbindung und erneutes Abonnement) kann der Agent auch den Wert „false“ akzeptieren, um das standardmäßige Warteschlangenverhalten zu überschreiben.

Auslöser

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

logout

()

Methode

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

Meldet MessageAgent vom Remote-Ziel ab. Die Abmeldung von einem Zielpfad wird auf alle verbundenen Elemente angewandt, die denselben ChannelSet verwenden, der in der Serverkonfiguration angegeben ist. Wenn beispielsweise verschiedene DataService-Komponenten über einen RTMP-Kanal verbunden sind und logout() auf einem dieser Kanäle aufgerufen wird, werden alle mit dem gleichen ChannelSet verbundenen Client-Komponenten ebenfalls abgemeldet.

Hinweis: Adobe empfiehlt, statt dieser Methode die mx.messaging.ChannelSet.logout()-Methode zu verwenden.

Verwandte API-Elemente

mx.messaging.ChannelSet.logout()

reAuthorize

()

Methode

protected function reAuthorize(msg: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

Diese Funktion muss von Unterklassen überschrieben werden, um eine erneute Authentifizierung aufgrund der Zeitüberschreitung der Serversitzung zu implementieren. Im Allgemeinen ist nach folgendem Muster vorzugehen: Trennung der Verbindung, Verbindung, erneutes Senden der Meldung.

Parameter

msg:IMessage — Die den Fehler verursachende Meldung muss erneut gesendet werden, nachdem durch eine Verbindungsaufhebung/Verbindung eine erneute Authentifizierung durchgeführt wurde.

setCredentials

()

Methode

public function setCredentials(username:String, password:String, charset: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

Definieren Sie die Benutzerdaten, die der MessageAgent zur Authentifizierung an den Zielen verwendet. Die Benutzerdaten werden auf alle Dienste angewendet, die über den gleichen ChannelSet verbunden sind.

Parameter

	`username:String` — Der Benutzername.

	`password:String` — Das Kennwort.

	`charset:String` (default = `null`) — Die zu verwendende Zeichensatzkodierung für die Kodierung der Daten. Der Standardwert ist null, d. h. dass der ältere Zeichensatz ISO Lateinisch-1 unterstützt wird. Der einzige unterstützte Zeichensatz ist „UTF-8“.

Auslöser

IllegalOperationError — Dies gilt in zwei Situationen. Wenn Benutzerdaten bereits definiert und eine Authentifizierung am Remote-Ziel durchgeführt wird oder wenn eine Authentifizierung durchgeführt und die angegebenen Benutzerdaten nicht mit den derzeit authentifizierten Benutzerdaten übereinstimmen.

setRemoteCredentials

()

Methode

public function setRemoteCredentials(username:String, password:String, charset: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

Definiert die Remote-Benutzerdaten, die an das Remote-Ziel zur Authentifizierung von sekundären Systemen übergeben werden.

Parameter

	`username:String` — Der Benutzername.

	`password:String` — Das Kennwort.

	`charset:String` (default = `null`) — Die für die Kodierung der Remotedaten zu verwendende Zeichensatzkodierung. Der Standardwert ist null, d. h. dass der ältere Zeichensatz ISO Lateinisch-1 unterstützt wird. Der einzige weitere unterstützte Option ist „UTF-8“.

Ereignisdetails

acknowledge

Ereignis

Ereignisobjekttyp: mx.messaging.events.MessageAckEvent
Eigenschaft MessageAckEvent.type = mx.messaging.events.MessageAckEvent.ACKNOWLEDGE

Sprachversion:

ActionScript 3.0

Produktversionen:

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

Laufzeitversionen:

Flash Player 9, AIR 1.1, Flash Player 9, AIR 1.1

Ausgelöst, wenn eine Bestätigungsmeldung für eine gesendete Meldung erhalten wird.

Der Ereignistyp ACKNOWLEDGE. Wird nach Erhalt einer Bestätigung ausgelöst.

Der Wert dieser Konstante ist "acknowledge".

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`acknowledgeMessage`	Dienstprogrammeigenschaft, um die Meldungseigenschaft von MessageEvent als eine AcknowledgeMessage abzurufen.
`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.
`correlate`	Die ursprüngliche Meldung, die dieser Bestätigung entspricht.
`message`	Die mit diesem Ereignis verknüpfte Meldung.
`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.

channelConnect

Ereignis

Ereignisobjekttyp: mx.messaging.events.ChannelEvent
Eigenschaft ChannelEvent.type = mx.messaging.events.ChannelEvent.CONNECT

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 der zugrundeliegende Kanal, der von dem MessageAgent verwendet wird, eine Verbindung herstellt.

Der Ereignistyp CONNECT. Weist darauf hin, dass der Kanal mit dem zugehörigen Endpunkt verbunden ist.

Der Wert dieser Konstante lautet "channelConnect".

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`cancelable`	false
`channel`	Der Kanal, durch den dieses Ereignis generiert wurde.
`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.
`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.
`reconnecting`	Gibt an, ob der Kanal, der dieses Ereignis generiert hat, eine erneute Verbindung erstellt.
`rejected`	Gibt an, ob der Kanal, der dieses Ereignis generiert hat, zurückgewiesen wurde. Dies wäre der Fall, wenn die Verbindung des Kanals aufgrund von Inaktivität aufgehoben ist und keine Ausfallsicherung oder Verbindung zu einem alternativen Kanal versucht werden sollte.

channelDisconnect

Ereignis

Ereignisobjekttyp: mx.messaging.events.ChannelEvent
Eigenschaft ChannelEvent.type = mx.messaging.events.ChannelEvent.DISCONNECT

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 die Verbindung beim zugrundeliegende Kanal, der von dem MessageAgent verwendet wird, getrennt wird.

Der Ereignistyp DISCONNECT. Weist darauf hin, dass die Verbindung des Kanals mit dem zugehörigen Endpunkt aufgehoben ist.

Der Wert dieser Konstante lautet "channelDisconnect".

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`cancelable`	false
`channel`	Der Kanal, durch den dieses Ereignis generiert wurde.
`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.
`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.
`reconnecting`	Gibt an, ob der Kanal, der dieses Ereignis generiert hat, eine erneute Verbindung erstellt.
`rejected`	Gibt an, ob der Kanal, der dieses Ereignis generiert hat, zurückgewiesen wurde. Dies wäre der Fall, wenn die Verbindung des Kanals aufgrund von Inaktivität aufgehoben ist und keine Ausfallsicherung oder Verbindung zu einem alternativen Kanal versucht werden sollte.

channelFault

Ereignis

Ereignisobjekttyp: mx.messaging.events.ChannelFaultEvent
Eigenschaft ChannelFaultEvent.type = mx.messaging.events.ChannelFaultEvent.FAULT

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 beim zugrundeliegende Kanal, der von dem MessageAgent verwendet wird, Fehler auftreten.

Der Ereignistyp FAULT. Weist darauf hin, dass Fehler beim Kanal aufgetreten sind.

Der Wert dieser Konstante ist "channelFault".

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`cancelable`	false
`channel`	Der Kanal, durch den dieses Ereignis generiert wurde.
`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.
`faultCode`	Stellt zielspezifische Details zum Fehler zur Verfügung.
`faultDetail`	Stellt Zugriff auf den zielspezifischen Grund für den Fehler zur Verfügung.
`faultString`	Stellt Zugriff auf den zugrundeliegenden Grund für den Fehler zur Verfügung, wenn der Fehler nicht durch den Kanal selbst entstanden ist.
`reconnecting`	Gibt an, ob der Kanal, der dieses Ereignis generiert hat, eine erneute Verbindung erstellt.
`rootCause`	Stellt Zugriff auf den zugrundeliegenden Grund für den Fehler zur Verfügung, wenn der Fehler nicht durch den Kanal selbst entstanden 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.

fault

Ereignis

Ereignisobjekttyp: mx.messaging.events.MessageFaultEvent
Eigenschaft MessageFaultEvent.type = mx.messaging.events.MessageFaultEvent.FAULT

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 ein Meldungsfehler auftritt.

Der Ereignistyp FAULT. Wird für einen Meldungsfehler ausgelöst.

Der Wert dieser Konstante lautet "fault".

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.
`faultCode`	Stellt zielspezifische Details zum Fehler zur Verfügung.
`faultDetail`	Stellt Zugriff auf den zielspezifischen Grund für den Fehler zur Verfügung.
`faultString`	Stellt Zugriff auf den zugrundeliegenden Grund für den Fehler zur Verfügung, wenn der Fehler nicht durch den Kanal selbst entstanden ist.
`message`	Die ErrorMessage für dieses Ereignis.
`rootCause`	Stellt Zugriff auf den zugrundeliegenden Grund für den Fehler (falls vorhanden) zur Verfügung.
`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.

propertyChange

Ereignis

Ereignisobjekttyp: mx.events.PropertyChangeEvent
Eigenschaft PropertyChangeEvent.type = mx.events.PropertyChangeEvent.PROPERTY_CHANGE

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 die Eigenschaft connected von dem MessageAgent geändert wird. Ebenfalls ausgelöst, wenn die Eigenschaft subscribed von einem Verbraucher geändert wird.

Die PropertyChangeEvent.PROPERTY_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein PropertyChange-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	Wird vom Konstruktor bestimmt; standardmäßig „false“.
`cancelable`	Wird vom Konstruktor bestimmt; standardmäßig „false“.
`kind`	Art der Änderung; PropertyChangeEventKind.UPDATE oder PropertyChangeEventKind.DELETE.
`oldValue`	Der ursprüngliche Eigenschaftswert.
`newValue`	Der neue Eigenschaftswert, falls vorhanden.
`property`	Die geänderte Eigenschaft.
`source`	Das Objekt mit der geänderten Eigenschaft.
`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.
`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.

Verwandte API-Elemente

mx.messaging.Consumer

Rechtliche Hinweise | Onlinedatenschutzerklärung

MessageAgent - AS3 BlazeDS LCDS

Klassen x

authenticated

channelSet

clientId

connected

destination

requestTimeout

MessageAgent

acknowledge

channelConnectHandler

channelDisconnectHandler

channelFaultHandler

disconnect

fault

handleAuthenticationFault

hasPendingRequestForMessage

initChannelSet

initialized

internalSend

logout

reAuthorize

setCredentials

setRemoteCredentials

acknowledge

channelConnect

channelDisconnect

channelFault

fault

propertyChange