ChannelSet

Paket	mx.messaging
Klasse	public class ChannelSet
Vererbung	ChannelSet EventDispatcher Object
Unterklassen	AdvancedChannelSet

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 ChannelSet ist ein Satz von Kanälen, die zum Senden von Meldungen an das Ziel verwendet werden. Der ChannelSet verbessert die Dienstqualität auf dem Client, indem die Kanäle durchsucht werden, um bei Netzwerkfehlern oder Fehlern bei einzelnen Kanälen Meldungen zu senden.

Standard-MXML-Eigenschaftchannels

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		authenticated : Boolean [schreibgeschützt] Gibt an, ob der ChannelSet über einen zugrundeliegenden Kanal verfügt, der eine erfolgreiche Authentifizierung mit dem zugehörigen Endpunkt aufweist.	ChannelSet
		channelIds : Array [schreibgeschützt] Die IDs der Kanäle, die vom ChannelSet verwendet werden.	ChannelSet
		channels : Array Stellt Zugriff auf Kanäle im ChannelSet zur Verfügung.	ChannelSet
		clustered : Boolean Gibt an, ob der ChannelSet auf ein Cluster-Ziel gerichtet ist.	ChannelSet
		connected : Boolean [schreibgeschützt] Gibt an, ob der ChannelSet verbunden ist.	ChannelSet
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		currentChannel : Channel [schreibgeschützt] Gibt den aktuellen Kanal für den ChannelSet zurück.	ChannelSet
		heartbeatInterval : int Die Anzahl von Millisekunden zwischen Heartbeats, die an den Remote-Host gesendet werden, während dieser ChannelSet aktiv verbunden ist, aber inaktiv ist.	ChannelSet
		initialDestinationId : String Stellt Zugriff auf das ursprüngliche Ziel zur Verfügung, den der ChannelSet für den Zugriff verwendet.	ChannelSet
		messageAgents : Array [schreibgeschützt] Stellt Zugriff auf den Satz von MessageAgents zur Verfügung, die diesen ChannelSet verwenden.	ChannelSet

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		ChannelSet(channelIds:Array = null, clusteredWithURLLoadBalancing:Boolean = false) Erstellt einen ChannelSet.	ChannelSet
		addChannel(channel:Channel):void Fügt einen Kanal zum ChannelSet hinzu.	ChannelSet
		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 CONNECT ChannelEvent und löst das Ereignis erneut aus.	ChannelSet
		channelDisconnectHandler(event:ChannelEvent):void Verarbeitet DISCONNECT ChannelEvent und löst das Ereignis erneut aus.	ChannelSet
		channelFaultHandler(event:ChannelFaultEvent):void Verarbeitet ChannelFaultEvent und löst das Ereignis erneut aus.	ChannelSet
		connect(agent:MessageAgent):void Verbindet einen MessageAgent mit dem ChannelSet.	ChannelSet
		disconnect(agent:MessageAgent):void Trennt die Verbindung eines bestimmten MessageAgent vom ChannelSet.	ChannelSet
		disconnectAll():void Trennt die Verbindung aller verknüpften MessageAgents und trennt die Verbindung aller zugrundeliegenden verbundenen Kanäle.	ChannelSet
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		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
		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
		login(username:String, password:String, charset:String = null):mx.rpc:AsyncToken Authentifiziert den ChannelSet, wobei der Server die zur Verfügung gestellten Benutzerdaten verwendet.	ChannelSet
		logout(agent:MessageAgent = null):mx.rpc:AsyncToken Meldet den ChannelSet vom Server ab.	ChannelSet
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeChannel(channel:Channel):void Entfernt einen Kanal aus dem ChannelSet.	ChannelSet
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		send(agent:MessageAgent, message:IMessage):void Sendet eine Meldung vom MessageAgent über den derzeit verbundenen Kanal.	ChannelSet
		setCredentials(credentials:String, agent:MessageAgent, charset:String = null):void Speichert die Benutzerdaten und übergibt sie zu den verbundenen Kanälen.	ChannelSet
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String [override] Gibt einen String zurück, der die IDs der Kanäle im ChannelSet enthält.	ChannelSet
		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
		messageHandler(event:MessageEvent):void Löst Meldungsereignisse von dem derzeit verbundenen Kanal erneut aus.	ChannelSet

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
channelConnect	Ausgelöst, nachdem ein Kanal im ChannelSet eine Verbindung zum zugehörigen Endpunkt hergestellt hat.	ChannelSet
channelDisconnect	Ausgelöst, nachdem ein Kanal im ChannelSet die Verbindung vom zugehörigen Endpunkt aufgehoben hat.	ChannelSet
channelFault	Ausgelöst, nachdem ein Kanal im ChannelSet fehlgeschlagen ist.	ChannelSet
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
fault	Das Fehlerereignis wird ausgelöst, wenn ein Aufruf zur Anmeldung oder Abmeldung fehlschlägt.	ChannelSet
propertyChange	Ausgelöst, wenn eine Eigenschaft des ChannelSet sich ändert.	ChannelSet
result	Das Ergebnisereignis wird ausgelöst, wenn ein Aufruf zur Anmeldung oder Abmeldung erfolgreich zurückgegeben wird.	ChannelSet

Eigenschaftendetails

authenticated

Eigenschaft

authenticated: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 der ChannelSet über einen zugrundeliegenden Kanal verfügt, der eine erfolgreiche Authentifizierung mit dem zugehörigen Endpunkt aufweist.

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

channelIds

Eigenschaft

channelIds:Array [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

Die IDs der Kanäle, die vom ChannelSet verwendet werden.

Implementierung
public function get channelIds():Array

channels

Eigenschaft

channels:Array

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 Kanäle im ChannelSet zur Verfügung. Diese Eigenschaft kann zu einer gleichzeitigen Zuweisung eines Satzes von Kanälen verwendet werden oder Kanäle können einzeln über addChannel() direkt zum ChannelSet hinzugefügt werden. Wenn der ChannelSet automatisch konfiguriert (configured) ist, werden die einzelnen Kanäle verzögert erstellt und bei Bedarf zu dieser Eigenschaft hinzugefügt.

Implementierung
public function get channels():Array
public function set channels(value:Array):void

Auslöser

IllegalOperationError — Wenn der ChannelSet konfiguriert (configured) ist, ist keine Zuweisung zu dieser Eigenschaft möglich.

clustered

Eigenschaft

clustered: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 an, ob der ChannelSet auf ein Cluster-Ziel gerichtet ist. Wenn der Wert „true“ beträgt, fragt der ChannelSet bei einer erfolgreichen Verbindung das Ziel auf alle Cluster-Endpunkte für die zugehörigen Kanäle ab und weist diesen Ausfallsicherungs-URIs zu. Kanal-IDs werden zum Zuweisen von Ausfallsicherungs-URIs zu den richtigen Kanalinstanzen verwendet. Dazu ist erforderlich, dass alle Kanäle im ChannelSet über nicht leere IDs verfügen. Andernfalls wird ein Fehler ausgegeben, wenn diese Eigenschaft auf „true“ gesetzt ist. Wenn der ChannelSet keinen URL-Lastausgleich am Client verwendet, sollte diese Eigenschaft nicht auf „true“ gesetzt werden.

Implementierung
public function get clustered():Boolean
public function set clustered(value:Boolean):void

connected

Eigenschaft

connected:Boolean [schreibgeschützt]

Gibt an, ob der ChannelSet verbunden ist.

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

currentChannel

Eigenschaft

currentChannel:Channel [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 den aktuellen Kanal für den ChannelSet zurück.

Implementierung
public function get currentChannel():Channel

heartbeatInterval

Eigenschaft

heartbeatInterval:int

Die Anzahl von Millisekunden zwischen Heartbeats, die an den Remote-Host gesendet werden, während dieser ChannelSet aktiv verbunden ist, aber inaktiv ist. Alle ausgehenden Meldungen verzögern Heartbeats vorübergehend. Dabei vergeht diese Anzahl von Millisekunden nach der letzten gesendeten Meldung und vor der Ausgabe des nächsten Heartbeat.

Diese Eigenschaft ist hilfreich für Anwendungen, die eine Verbindung zu einem Remote-Host herstellen, um Aktualisierungen im Push-Verfahren zu erhalten ( also nicht, um Meldungen aktiv zu senden), und dabei auch dann über die Unterbrechung der Verbindung benachrichtigt werden möchten, wenn durch die Netzwerkebene eine derartige Benachrichtigung nicht zur Verfügung gestellt wird. Durch die Ausgabe von regelmäßigen Heartbeats kann der Client die Netzwerkebene zwingen, eine Zeitüberschreitung zu melden, wenn die zugrunde liegende Verbindung ohne Benachrichtigung unterbrochen wurde und die Anwendung ordnungsgemäß auf die Trennung reagieren kann.

Durch einen nicht positiven Wert werden Heartbeats an den Remote-Host deaktiviert. Der Standardwert ist 0. Dies bedeutet, dass Heartbeats deaktiviert sind. Wenn die Anwendung diesen Wert definiert, ist ein längeres vor einem kürzeren Intervall vorzuziehen, um den Remote-Host nicht unnötig zu belasten. Beispielsweise verwenden Keep-Alives mit TCP-Socket auf niedriger Ebene standardmäßig ein Intervall von zwei Stunden. Dieses Intervall ist länger als in den meisten Anwendungen, die Heartbeats aktivieren, verwendet. Das Beispiel macht jedoch deutlich, weshalb ein längeres Intervall zu bevorzugen ist.

Wenn der derzeit verbundene zugrundeliegende Kanal Abfrageanforderungen an den Remote-Host sendet, werden Heartbeats unterdrückt, da die regelmäßigen Abfrageanforderungen diese Funktion effizient übernehmen.

Implementierung
public function get heartbeatInterval():int
public function set heartbeatInterval(value:int):void

initialDestinationId

Eigenschaft

initialDestinationId: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 ursprüngliche Ziel zur Verfügung, den der ChannelSet für den Zugriff verwendet. Wenn die clustered-Eigenschaft auf „true“ gesetzt ist, wird dieser Wert zur Anforderung verfügbarer Ausfallsicherungs-URIs für die für das Ziel konfigurierten Kanäle verwendet.

Implementierung
public function get initialDestinationId():String
public function set initialDestinationId(value:String):void

messageAgents

Eigenschaft

messageAgents:Array [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 den Satz von MessageAgents zur Verfügung, die diesen ChannelSet verwenden.

Implementierung
public function get messageAgents():Array

Konstruktordetails

()

Konstruktor

public function ChannelSet(channelIds:Array = null, clusteredWithURLLoadBalancing:Boolean = false)

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

Erstellt einen ChannelSet. Wenn das channelIds-Argument vorhanden ist, verwendet der ChannelSet automatisch konfigurierte Kanäle, die über ServerConfig.getChannel() erhalten wurden, um ein Ziel zu erreichen. Die manuelle Zuweisung von Kanälen zum ChannelSet, das konfigurierte Kanäle verwendet, ist nicht zulässig.

Wenn das channelIds-Argument nicht vorhanden oder ein leerer Wert ist, müssen Kanäle manuell erstellt und zum ChannelSet hinzugefügt werden, um eine Verbindung herzustellen und Meldungen zu senden.

Wenn für den ChannelSet URL-Lastverteilungs-Clustering verwendet wird (bei dem jeder Server eine eindeutige RTMP- oder HTTP-URL deklariert und die Ausfallsicherung den Client von einer URL zur nächsten leitet), fordert das ChannelSet bei der ersten Verbindung eines Kanals des ChannelSet automatisch alle Endpunkte aller Mitgliedskanäle im Cluster an. Außerdem weist der ChannelSet diese Ausfallsicherungs-URLs den einzelnen jeweiligen Kanälen zu. Das ermöglicht für Kanäle im ChannelSet eine individuelle Ausfallsicherung. Wenn die Ausfallsicherungsoptionen für einen bestimmten Kanal erschöpft sind, versucht der ChannelSet mit dem nächsten Kanal im Satz eine erneute Verbindung herzustellen.

Unabhängig vom Clustering, wenn bei einem Kanal keine Verbindung möglich ist oder die Konnektivität verloren geht, versucht der ChannelSet mit dem nächsten verfügbaren Kanal eine erneute Verbindung herzustellen. Dadurch kann der ChannelSet die Kanäle mit verschiedenen Protokollen, Ports usw. nach einem entsprechenden Kanal durchsuchen, der mit dem zugehörigen Endpunkt verbunden werden kann.

Parameter

	`channelIds:Array` (default = `null`) — Die IDs von konfigurierten Kanälen, die von ServerConfig für diesen ChannelSet erhalten wurden. Falls kein Wert vorhanden, müssen Kanäle manuell zum ChannelSet hinzugefügt werden.

	`clusteredWithURLLoadBalancing:Boolean` (default = `false`) — Der Wert „true“, wenn die Kanäle im ChannelSet mithilfe von URL-Lastausgleich zu Clustern zusammengefügt werden.

Methodendetails

addChannel

()

Methode

public function addChannel(channel:Channel):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

Fügt einen Kanal zum ChannelSet hinzu. Ein Kanal mit einer leeren ID kann nicht zum ChannelSet hinzugefügt werden, wenn das Ziel für den ChannelSet ein Cluster-Ziel ist.

Parameter

channel:Channel — Der hinzuzufügende Kanal.

Auslöser

IllegalOperationError — Wenn der ChannelSet konfiguriert (configured) ist, wird das Hinzufügen eines Kanals nicht unterstützt. Dieser Fehler wird auch ausgegeben, wenn die Eigenschaft clustered des ChannelSet auf true gesetzt ist, aber der Kanal eine leere ID aufweist.

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 CONNECT ChannelEvent und löst das Ereignis erneut aus.

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 DISCONNECT ChannelEvent und löst das Ereignis erneut aus.

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 ChannelFaultEvent und löst das Ereignis erneut aus.

Parameter

event:ChannelFaultEvent — Das ChannelFaultEvent.

connect

()

Methode

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

Verbindet einen MessageAgent mit dem ChannelSet. Nach der Verbindungsherstellung kann der Agent ChannelSet zum Senden von Meldungen verwenden.

Parameter

agent:MessageAgent — Der zu verbindende MessageAgent.

disconnect

()

Methode

public function disconnect(agent:MessageAgent):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 Verbindung eines bestimmten MessageAgent vom ChannelSet. Wenn es sich um den letzten MessageAgent handelt, der den ChannelSet verwendet, und der aktuelle Kanal im Satz verbunden ist, wird der Kanal physisch vom Server getrennt.

Parameter

agent:MessageAgent — Der zu trennende MessageAgent.

disconnectAll

()

Methode

public function disconnectAll():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 Verbindung aller verknüpften MessageAgents und trennt die Verbindung aller zugrundeliegenden verbundenen Kanäle. Im Gegensatz zur disconnect(MessageAgent)-Methode, die durch die Trennungsimplementierungen bestimmter Dienstkomponenten aufgerufen wird, bietet diese Methode einen einzigen, praktischen Punkt, um die Konnektivität zwischen Client und Server zu trennen.

login

()

Methode

public function login(username:String, password:String, charset:String = null):mx.rpc:AsyncToken

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

Authentifiziert den ChannelSet, wobei der Server die zur Verfügung gestellten Benutzerdaten verwendet. Im Gegensatz zu anderen Vorgängen auf Kanälen und im ChannelSet, gibt dieser Vorgang ein AsyncToken zurück, zu dem der Client-Code einen Responder hinzufügen kann, um die erfolgreiche oder fehlerhafte Durchführung direkt zu verarbeiten. Wenn bei Aufruf dieser Methode der ChannelSet nicht mit dem Server verbunden ist, wird ein Verbindungsversuch ausgelöst, der bei erfolgreicher Durchführung einen Anmeldebefehl an den Server sendet. Es darf nur ein Anmelde- oder Abmeldevorgang gleichzeitig ausstehen. Durch überlappende Aufrufe wird ein IllegalOperationError generiert. Wenn der ChannelSet bereits authentifiziert ist und die Anmeldung aufgerufen wird, wird ebenfalls ein IllegalOperationError generiert.

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

Rückgabewerte

mx.rpc:AsyncToken — Gibt ein Token zurück, zu dem der Client-Code einen Responder hinzufügen kann, um die erfolgreiche oder fehlerhafte Durchführung direkt zu verarbeiten.

Auslöser

IllegalOperationError — Dies gilt in zwei Situationen. Wenn der ChannelSet bereits authentifiziert ist oder wenn ein Anmelde- oder Abmeldevorgang derzeit ausgeführt wird.

logout

()

Methode

public function logout(agent:MessageAgent = null):mx.rpc:AsyncToken

Meldet den ChannelSet vom Server ab. Im Gegensatz zu anderen Vorgängen auf Kanälen und im ChannelSet, gibt dieser Vorgang ein AsyncToken zurück, zu dem der Client-Code einen Responder hinzufügen kann, um die erfolgreiche oder fehlerhafte Durchführung direkt zu verarbeiten. Wenn eine erfolgreiche Abmeldung durchgeführt wurde, werden die für automatische Neuverbindungen gegebenenfalls zwischengespeicherten Benutzerdaten für den ChannelSet und die zugehörigen Kanäle gelöscht und deren authentifizierter Status wird auf „false“ gesetzt. Wenn bei Aufruf dieser Methode der ChannelSet nicht mit dem Server verbunden ist, wird ein Verbindungsversuch ausgelöst, der bei erfolgreicher Durchführung einen Abmeldebefehl an den Server sendet.

Das MessageAgent-Argument ist vorhanden, um älteres Abmeldeverhalten zu unterstützen, und Client-Code, der diese Methode aufruft, sollte keinen MessageAgent-Verweis übergeben. Es wird nur die logout()-Methode aufgerufen, ohne dass Argumente übergeben werden.

Diese Methode wird ebenfalls von den Dienstkomponenten der zugehörigen logout()-Methoden aufgerufen. Diese Komponenten übergeben einen MessageAgent-Verweis auf diese Methode, wenn sie sich abmelden. Durch das Auftreten dieses Arguments wird die Ausführung des älteren Abmeldeverhaltens ausgelöst. Dieses Verhalten unterscheidet sich von dem oben beschriebenen neuen Verhalten. Älteres Verhalten sendet nur eine Abmeldeanforderung an den Server, wenn der Client verbunden ist und Authentifizierung aufweist. Wenn diese Bedingungen nicht erfüllt sind, wird durch das ältere Verhalten dieser Methode nur für automatische Neuverbindungen gegebenenfalls zwischengespeicherte Benutzerdaten gelöscht.

Parameter

agent:MessageAgent (default = null) — Älteres Argument. Der MessageAgent startet die Abmeldung.

Rückgabewerte

mx.rpc:AsyncToken — Gibt ein Token zurück, zu dem der Client-Code einen Responder hinzufügen kann, um die erfolgreiche oder fehlerhafte Durchführung direkt zu verarbeiten.

Auslöser

IllegalOperationError — Im Falle, dass ein Anmelde- oder Abmeldevorgang derzeit ausgeführt wird.

messageHandler

()

Methode

protected function messageHandler(event:MessageEvent):void

Löst Meldungsereignisse von dem derzeit verbundenen Kanal erneut aus.

Parameter

event:MessageEvent — Das MessageEvent vom Kanal.

removeChannel

()

Methode

public function removeChannel(channel:Channel):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

Entfernt einen Kanal aus dem ChannelSet. Wenn der zu entfernende Kanal derzeit verbunden ist und vom ChannelSet verwendet wird, wird die Verbindung getrennt und der Kanal wird entfernt.

Parameter

channel:Channel — Der zu entfernende Kanal.

Auslöser

IllegalOperationError — Wenn der ChannelSet konfiguriert (configured) ist, wird das Entfernen eines Kanals nicht unterstützt.

send

()

Methode

public function send(agent:MessageAgent, 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 eine Meldung vom MessageAgent über den derzeit verbundenen Kanal.

Parameter

	`agent:MessageAgent` — Der MessageAgent, der die Meldung sendet.

	`message:IMessage` — Die zu sendende Meldung.

Auslöser

NoChannelAvailableError — In dem Fall, dass der ChannelSet über keine internen Kanäle verfügt.

setCredentials

()

Methode

public function setCredentials(credentials:String, agent:MessageAgent, 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

Speichert die Benutzerdaten und übergibt sie zu den verbundenen Kanälen.

Parameter

	`credentials:String` — Die Benutzerdaten für den MessageAgent.

	`agent:MessageAgent` — Der MessageAgent, von dem die Benutzerdaten festgelegt werden.

	`charset:String` (default = `null`) — Die zur Kodierung der Benutzerdaten verwendete Zeichensatzkodierung. Der Standardwert ist leer, dadurch wird die ältere Kodierung ISO-Latin-1 verwendet.

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.

toString

()

Methode

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

Gibt einen String zurück, der die IDs der Kanäle im ChannelSet enthält.

Rückgabewerte

String — Die Stringdarstellung vom ChannelSet.

Ereignisdetails

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, nachdem ein Kanal im ChannelSet eine Verbindung zum zugehörigen Endpunkt hergestellt hat.

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, nachdem ein Kanal im ChannelSet die Verbindung vom zugehörigen Endpunkt aufgehoben hat.

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, nachdem ein Kanal im ChannelSet fehlgeschlagen ist.

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.rpc.events.FaultEvent
Eigenschaft FaultEvent.type = mx.rpc.events.FaultEvent.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

Das Fehlerereignis wird ausgelöst, wenn ein Aufruf zur Anmeldung oder Abmeldung fehlschlägt.

Der FAULT-Ereignistyp.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`cancelable`	„true“; durch Aufrufen von „preventDefault()“ von der responder.fault-Methode des verknüpften Tokens wird das Auslösen dieses Ereignisses durch den Dienst oder den Vorgang verhindert.
`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.
`fault`	Das Fault-Objekt, das die Details über den Auslöser dieses Ereignisses enthält.
`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.
`token`	Das Token, das den Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet.

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 eine Eigenschaft des ChannelSet sich ändert.

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.

result

Ereignis

Ereignisobjekttyp: mx.rpc.events.ResultEvent
Eigenschaft ResultEvent.type = mx.rpc.events.ResultEvent.RESULT

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

Das Ergebnisereignis wird ausgelöst, wenn ein Aufruf zur Anmeldung oder Abmeldung erfolgreich zurückgegeben wird.

Der RESULT-Ereignistyp.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`cancelable`	true, preventDefault() aus der verknüpften responder.result-Methode des Token verhindert, dass der Dienst oder der Vorgang dieses Ereignis auslöst.
`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 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.
`result`	Vom RPC-Aufruf zurückgegebenes Ergebnis.
`token`	Token, das den einzelnen Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet.

Rechtliche Hinweise | Onlinedatenschutzerklärung

ChannelSet - AS3 BlazeDS LCDS

Klassen x

authenticated

channelIds

channels

clustered

connected

currentChannel

heartbeatInterval

initialDestinationId

messageAgents

ChannelSet

addChannel

channelConnectHandler

channelDisconnectHandler

channelFaultHandler

connect

disconnect

disconnectAll

login

logout

messageHandler

removeChannel

send

setCredentials

toString

channelConnect

channelDisconnect

channelFault

fault

propertyChange

result