Channel

Paket	mx.messaging
Klasse	public class Channel
Vererbung	Channel EventDispatcher Object
Implementiert	IMXMLObject
Unterklassen	PollingChannel

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 Channel-Klasse ist die grundlegende Meldungskanalklasse, die alle Kanäle im Meldungssystem erweitern müssen.

Kanäle sind bestimmte protokollbasierte Übertragungen für Meldungen, die zwischen MessageAgents und Remote-Zielen gesendet werden. Vorkonfigurierte Kanäle werden in der Architektur mithilfe der ServerConfig.getChannel()-Methode erstellt. Sie können einen Kanal direkt erstellen, indem Sie den Operator new verwenden und ihn direkt zu einem ChannelSet hinzufügen.

Kanäle stellen eine physische Verbindung zu einem Remote-Endpunkt dar. Kanäle werden standardmäßig von Zielen gemeinsam verwendet. Das bedeutet, dass ein Client, der verschiedene Ziele verwendet, den gleichen Kanal für die Kommunikation mit diesen Zielen verwenden kann.

Hinweis: Diese Klasse sollte nur von erfahrenen Benutzern verwendet werden. Verwenden Sie diese Klasse zum Erstellen von benutzerdefinierten Kanälen wie die vorhandenen Kanäle RTMPChannel, AMFChannel und HTTPChannel.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		authenticated : Boolean [schreibgeschützt] Gibt an, ob dieser Kanal authentifiziert ist.	Channel
		channelSets : Array [schreibgeschützt] Bietet Zugriff auf die mit dem Kanal verbundenen ChannelSets.	Channel
		connected : Boolean [schreibgeschützt] Gibt an, ob dieser Kanal eine Verbindung zum Remote-Ziel versucht hat.	Channel
		connectTimeout : int Bietet Zugriff auf das Verbindungszeitlimit (in Sekunden) für den Kanal.	Channel
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		endpoint : String [schreibgeschützt] Bietet Zugriff auf den Endpunkt für diesen Kanal.	Channel
		failoverURIs : Array Bietet Zugriff auf den Satz von Endpunkt-URIs, für den dieser Kanal eine Ausfallsicherung versuchen kann, wenn der Endpunkt in einem Cluster vorhanden ist.	Channel
		id : String Bietet Zugriff auf die ID für diesen Kanal.	Channel
		protocol : String [schreibgeschützt] Bietet Zugriff auf das Protokoll, das der Kanal verwendet.	Channel
		reconnecting : Boolean [schreibgeschützt] Gibt an, ob dieser Kanal gerade eine Neuverbindung zu einem alternativen Endpunkt durchführt.	Channel
		recordMessageSizes : Boolean [schreibgeschützt] Die Kanaleigenschaft bestimmt die Stufe der Leistungsinformationsinjektion, das heißt, ob Meldungsgrößen injektiert werden.	Channel
		recordMessageTimes : Boolean [schreibgeschützt] Die Kanaleigenschaft bestimmt die Stufe der Leistungsinformationsinjektion, das heißt, ob Zeitstempel injektiert werden.	Channel
		requestTimeout : int Bietet Zugriff auf das standardmäßige Anforderungszeitlimit (in Sekunden) für den Kanal.	Channel
		uri : String Bietet Zugriff auf die URI, die zur Erstellung der gesamten Endpunkt-URI für diesen Kanal verwendet wird.	Channel

Geschützte Eigenschaften

	Eigenschaft		Definiert von
		shouldBeConnected : Boolean [schreibgeschützt] Gibt an, ob dieser Kanal mit dem Endpunkt verbunden werden soll.	Channel

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		Channel(id:String = null, uri:String = null) Erstellt eine Instanz eines generischen Kanals, die mit der angegebenen Endpunkt-URI verbunden wird.	Channel
		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
		applySettings(settings:XML):void Unterklassen sollte diese Methode überschreiben, um Einstellungen anzuwenden, die gegebenenfalls für einen bestimmten Kanal notwendig sind.	Channel
		connect(channelSet:ChannelSet):void Verbindet den ChannelSet mit dem Kanal.	Channel
		disconnect(channelSet:ChannelSet):void Trennt die Verbindung des ChannelSet vom Kanal.	Channel
		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
		logout(agent:MessageAgent):void Sendet eine CommandMessage an den Server, um eine Abmeldung durchzuführen, wenn der Kanal verbunden wurde.	Channel
		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
		send(agent:MessageAgent, message:IMessage):void Sendet die angegebene Meldung an das zugehörige Ziel.	Channel
		setCredentials(credentials:String, agent:MessageAgent = null, charset:String = null):void Definiert die Benutzerdaten auf den angegebenen Wert.	Channel
		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 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
		applyClientLoadBalancingSettings(props:XML):void Wendet die Client-Lastausgleich-URL an, falls vorhanden.	Channel
		connectFailed(event:ChannelFaultEvent):void Verarbeitet eine fehlgeschlagene interne Verbindung und löst das Ereignis FAULT für den Kanal aus.	Channel
		connectSuccess():void Verarbeitet eine erfolgreiche interne Verbindung und löst das Ereignis CONNECT für den Kanal aus.	Channel
		connectTimeoutHandler(event:flash.events:TimerEvent):void Verarbeitet ein Verbindungszeitlimit, indem ein ChannelFaultEvent ausgelöst wird.	Channel
		disconnectFailed(event:ChannelFaultEvent):void Verarbeitet eine fehlgeschlagene interne Verbindungstrennung und löst das Ereignis FAULT für den Kanal aus.	Channel
		disconnectSuccess(rejected:Boolean = false):void Verarbeitet eine erfolgreiche interne Verbindungstrennung und löst das Ereignis DISCONNECT für den Kanal aus.	Channel
		flexClientWaitHandler(event:PropertyChangeEvent):void Verarbeitet eine Änderung an der Schutzbedingung, um eine anfängliche Kanalverbindung für die Anwendung zu verwalten.	Channel
		getMessageResponder(agent:MessageAgent, message:IMessage):MessageResponder Gibt den entsprechenden MessageResponder für die send()-Methode des Kanals zurück.	Channel
		internalConnect():void Verbindet den Kanal mit dem zugehörigen Endpunkt.	Channel
		internalDisconnect(rejected:Boolean = false):void Trennt die Verbindung des Kanals vom zugehörigen Endpunkt.	Channel
		internalSend(messageResponder:MessageResponder):void Sendet die Meldung über den Kanal und leitet die Antwort an den Responder.	Channel

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 eine Verbindung zum zugehörigen Endpunkt hergestellt hat.	Channel
channelDisconnect	Ausgelöst, nachdem ein Kanal vom zugehörigen Endpunkt getrennt wurde.	Channel
channelFault	Ausgelöst, nachdem ein Fehler bei einem Kanal aufgetreten ist.	Channel
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
message	Ausgelöst, wenn ein Kanal eine Meldung vom zugehörigen Endpunkt erhält.	Channel
propertyChange	Ausgelöst, wenn eine Eigenschaft des Kanals sich ändert.	Channel

Geschützte Konstanten

	Konstante		Definiert von
		CONNECT_TIMEOUT_SECONDS : String = "connect-timeout-seconds" [statisch]	Channel
		ENABLE_SMALL_MESSAGES : String = "enable-small-messages" [statisch]	Channel
		FALSE : String = "false" [statisch]	Channel
		RECORD_MESSAGE_SIZES : String = "record-message-sizes" [statisch]	Channel
		RECORD_MESSAGE_TIMES : String = "record-message-times" [statisch]	Channel
		REQUEST_TIMEOUT_SECONDS : String = "request-timeout-seconds" [statisch]	Channel
		SERIALIZATION : String = "serialization" [statisch]	Channel
		TRUE : String = "true" [statisch]	Channel

Eigenschaftendetails

authenticated

Eigenschaft

authenticated:Boolean [schreibgeschützt]

Gibt an, ob dieser Kanal authentifiziert 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 authenticated():Boolean

channelSets

Eigenschaft

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

Bietet Zugriff auf die mit dem Kanal verbundenen ChannelSets.

Implementierung
public function get channelSets():Array

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 Kanal eine Verbindung zum Remote-Ziel versucht hat.

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

connectTimeout

Eigenschaft

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

Bietet Zugriff auf das Verbindungszeitlimit (in Sekunden) für den Kanal. Ein Wert von 0 oder weniger bedeutet, dass ein Verbindungsversuch niemals eine Zeitüberschreitung auf dem Client erhält. Bei Kanälen, für die eine Ausfallsicherung konfiguriert ist, entspricht dieser Wert der Gesamtzeit für das Warten auf eine herzustellende Verbindung. Sie wird für keine Ausfallsicherungs-URI, zu der der Kanal eine Verbindungsherstellung versucht, zurückgesetzt.

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

endpoint

Eigenschaft

endpoint:String [schreibgeschützt]

Bietet Zugriff auf den Endpunkt für diesen Kanal. Dieser Wert wird basierend auf dem Wert der Eigenschaft uri berechnet.

Implementierung
public function get endpoint():String

failoverURIs

Eigenschaft

failoverURIs:Array

Bietet Zugriff auf den Satz von Endpunkt-URIs, für den dieser Kanal eine Ausfallsicherung versuchen kann, wenn der Endpunkt in einem Cluster vorhanden ist.

Diese Eigenschaft wird automatisch gefüllt, wenn Clustering aktiviert ist. Wenn Sie kein Clustering verwenden, können Sie eigene Werte festlegen.

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

id

Eigenschaft

id:String

Bietet Zugriff auf die ID für diesen Kanal.

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

protocol

Eigenschaft

protocol:String [schreibgeschützt]

Bietet Zugriff auf das Protokoll, das der Kanal verwendet.

Hinweis: Unterklassen des Kanals müssen diese Methode überschreiben und einen String zurückgeben, der dem zugehörigen unterstützten Protokoll entspricht. Beispiele von unterstützten Protokollstrings sind „rtmp“, „http“ oder „https“.

Implementierung
public function get protocol():String

reconnecting

Eigenschaft

reconnecting:Boolean [schreibgeschützt]

Gibt an, ob dieser Kanal gerade eine Neuverbindung zu einem alternativen Endpunkt durchführt.

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

recordMessageSizes

Eigenschaft

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

Die Kanaleigenschaft bestimmt die Stufe der Leistungsinformationsinjektion, das heißt, ob Meldungsgrößen injektiert werden.

Implementierung
public function get recordMessageSizes():Boolean

recordMessageTimes

Eigenschaft

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

Die Kanaleigenschaft bestimmt die Stufe der Leistungsinformationsinjektion, das heißt, ob Zeitstempel injektiert werden.

Implementierung
public function get recordMessageTimes():Boolean

requestTimeout

Eigenschaft

requestTimeout:int

Bietet Zugriff auf das standardmäßige Anforderungszeitlimit (in Sekunden) für den Kanal. Ein Wert von 0 oder weniger bedeutet, dass ausgehende Anforderungen niemals eine Zeitüberschreitung auf dem Client erhalten.

Anforderungszeitlimits sind sehr hilfreich bei RPC-Stilmeldungen, für die eine Antwort vom Remote-Ziel erforderlich ist.

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

shouldBeConnected

Eigenschaft

shouldBeConnected:Boolean [schreibgeschützt]

Gibt an, ob dieser Kanal mit dem Endpunkt verbunden werden soll. Dieser Flag sollte zur Steuerung verwendet werden, wenn Ausfallsicherung versucht werden soll und wenn eine Benachrichtigung zur Verbindungstrennung an den Remote-Endpunkt nach einer Verbindungstrennung oder eines Fehlers gesendet werden soll.

Implementierung
protected function get shouldBeConnected():Boolean

uri

Eigenschaft

uri:String

Bietet Zugriff auf die URI, die zur Erstellung der gesamten Endpunkt-URI für diesen Kanal verwendet wird. Die URI kann ein Teilpfad sein. In diesem Fall wird die vollständige Endpunkt-URI bei Bedarf berechnet.

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

Konstruktordetails

()

Konstruktor

public function Channel(id:String = null, uri:String = null)

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 eine Instanz eines generischen Kanals, die mit der angegebenen Endpunkt-URI verbunden wird. Hinweis: Der Channel-Typ sollte nicht direkt erstellt werden. Erstellen Sie stattdessen Instanzen von protokollspezifischen Unterklassen wie RTMPChannel oder AMFChannel.

Parameter

	`id:String` (default = `null`) — Die ID dieses Kanals.

	`uri:String` (default = `null`) — Die Endpunkt-URI dieses Kanals.

Methodendetails

applyClientLoadBalancingSettings

()

Methode

protected function applyClientLoadBalancingSettings(props:XML):void

Wendet die Client-Lastausgleich-URL an, falls vorhanden. Es wird zufällig eine URL aus einem Satz von Client-Lastausgleich-URLs ausgewählt und als Haupt-URL des Kanals festgelegt. Anschließend werden die restlichen als failoverURIs des Kanals zugewiesen.

Parameter

props:XML — Der Eigenschaftenabschnitt des XML-Fragments der Datei services-config.xml für diesen Kanal.

applySettings

()

Methode

public function applySettings(settings:XML):void

Unterklassen sollte diese Methode überschreiben, um Einstellungen anzuwenden, die gegebenenfalls für einen bestimmten Kanal notwendig sind. Vergewissern Sie sich, super.applySettings() aufzurufen, um allgemeine Einstellungen für den Kanal anzuwenden. Diese Methode wird primär in den Channel-Unterklassen verwendet.

Parameter

settings:XML — XML-Fragment der Datei services-config.xml für diesen Kanal.

connect

()

Methode

public final function connect(channelSet:ChannelSet):void

Verbindet den ChannelSet mit dem Kanal. Wenn der Kanal noch keine Verbindung mit dem zugehörigen Endpunkt hergestellt hat, wird dies versucht. Kanalunterklassen müssen die internalConnect()-Methode überschreiben und die connectSuccess()-Methode aufrufen, nachdem die zugrundeliegende Verbindung hergestellt wurde.

Parameter

channelSet:ChannelSet — Der ChannelSet, der mit dem Kanal verbunden werden soll.

connectFailed

()

Methode

protected function connectFailed(event:ChannelFaultEvent):void

Verarbeitet eine fehlgeschlagene interne Verbindung und löst das Ereignis FAULT für den Kanal aus. Wenn der Kanal failoverURI-Werte aufweist, wird eine automatische Neuverbindung versucht, indem diese URI-Werte ausprobiert werden, bis eine Verbindung hergestellt wurde oder die verfügbaren Werte erschöpft sind.

Parameter

event:ChannelFaultEvent — Das ChannelFaultEvent für die fehlgeschlagene Verbindung.

connectSuccess

()

Methode

protected function connectSuccess():void

Verarbeitet eine erfolgreiche interne Verbindung und löst das Ereignis CONNECT für den Kanal aus.

connectTimeoutHandler

()

Methode

protected function connectTimeoutHandler(event:flash.events:TimerEvent):void

Verarbeitet ein Verbindungszeitlimit, indem ein ChannelFaultEvent ausgelöst wird. Untertypen können diesen Wert überschreiben, um den aktuellen Verbindungsversuch zu beenden, müssen jedoch super.connectTimeoutHandler(event) aufrufen.

Parameter

event:flash.events:TimerEvent — Das Timerereignis, das bedeutet, dass das Verbindungszeitlimit erreicht wurde.

disconnect

()

Methode

public final function disconnect(channelSet:ChannelSet):void

Trennt die Verbindung des ChannelSet vom Kanal. Wenn der Kanal mit dem Endpunkt verbunden ist und keine ChannelSets mehr verbunden sind, wird die interne Verbindung des Kanals getrennt.

Kanalunterklassen müssen die internalDisconnect()-Methode überschreiben und die disconnectSuccess()-Methode aufrufen, wenn die zugrundeliegende Verbindung abgeschlossen wurde.

Parameter

channelSet:ChannelSet — Der vom Kanal zu trennende ChannelSet.

disconnectFailed

()

Methode

protected function disconnectFailed(event:ChannelFaultEvent):void

Verarbeitet eine fehlgeschlagene interne Verbindungstrennung und löst das Ereignis FAULT für den Kanal aus.

Parameter

event:ChannelFaultEvent — Das ChannelFaultEvent für die fehlgeschlagene Verbindungstrennung.

disconnectSuccess

()

Methode

protected function disconnectSuccess(rejected:Boolean = false):void

Verarbeitet eine erfolgreiche interne Verbindungstrennung und löst das Ereignis DISCONNECT für den Kanal aus. Wenn die Verbindungstrennung durch einen Netzwerkfehler verursacht und der Kanal failoverURI-Werte aufweist, wird eine automatische Neuverbindung versucht, indem diese URI-Werte ausprobiert werden, bis eine Verbindung hergestellt wurde oder die verfügbaren Werte erschöpft sind.

Parameter

rejected:Boolean (default = false) — „true“, wenn die Verbindungstrennung eine gegebenenfalls vorhandene Ausfallsicherungsverarbeitung überspringen soll, die ansonsten versucht würde. „false“, wenn die Ausführung der Ausfallsicherungsverarbeitung erlaubt ist.

flexClientWaitHandler

()

Methode

protected function flexClientWaitHandler(event:PropertyChangeEvent):void

Verarbeitet eine Änderung an der Schutzbedingung, um eine anfängliche Kanalverbindung für die Anwendung zu verwalten. Bei diesem Aufruf bedeutet dies, dass dieser Kanal auf einen Verbindungsversuch wartet.

Parameter

event:PropertyChangeEvent — Das PropertyChangeEvent, das von FlexClient-Singleton ausgelöst wurde.

getMessageResponder

()

Methode

protected function getMessageResponder(agent:MessageAgent, message:IMessage):MessageResponder

Gibt den entsprechenden MessageResponder für die send()-Methode des Kanals zurück. Muss überschrieben werden.

Parameter

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

	`message:IMessage` — Die zu sendende Meldung.

Rückgabewerte

MessageResponder — Der MessageResponder zur Verarbeitung des Ergebnisses oder des Fehlers.

Auslöser

IllegalOperationError — In dem Fall, dass die Kanalunterklasse diese Methode nicht überschreibt.

internalConnect

()

Methode

protected function internalConnect():void

Verbindet den Kanal mit dem zugehörigen Endpunkt. Muss überschrieben werden.

internalDisconnect

()

Methode

protected function internalDisconnect(rejected:Boolean = false):void

Trennt die Verbindung des Kanals vom zugehörigen Endpunkt. Muss überschrieben werden.

Parameter

rejected:Boolean (default = false) — „true“, wenn die Verbindungstrennung durch eine Verbindungszurückweisung oder ein Verbindungszeitlimit verursacht wurde und eine Neuverbindung nicht automatisch durchgeführt werden soll. In anderen Fällen ist der Wert „false“.

internalSend

()

Methode

protected function internalSend(messageResponder:MessageResponder):void

Sendet die Meldung über den Kanal und leitet die Antwort an den Responder. Muss überschrieben werden.

Parameter

messageResponder:MessageResponder — Der MessageResponder für die Verarbeitung der Antwort.

logout

()

Methode

public function logout(agent:MessageAgent):void

Sendet eine CommandMessage an den Server, um eine Abmeldung durchzuführen, wenn der Kanal verbunden wurde. Die aktuellen Benutzerdaten werden gelöscht.

Parameter

agent:MessageAgent — Der abzumeldende MessageAgent.

send

()

Methode

public function send(agent:MessageAgent, message:IMessage):void

Sendet die angegebene Meldung an das zugehörige Ziel. Unterklassen müssen die internalSend()-Methode überschreiben, um das tatsächliche Senden auszuführen.

Parameter

	`agent:MessageAgent` — Der MessageAgent, von dem die Meldung gesendet wird.

	`message:IMessage` — Die zu sendende Meldung.

Auslöser

InvalidDestinationError — In dem Fall, dass weder von MessageAgent noch von der Meldung ein Ziel angegeben ist.

setCredentials

()

Methode

public function setCredentials(credentials:String, agent:MessageAgent = null, charset:String = null):void

Definiert die Benutzerdaten auf den angegebenen Wert. Wenn die Benutzerdaten nicht leer sind und der Kanal verbunden ist, sendet diese Methode auch eine CommandMessage an den Server, um eine Anmeldung mit den Benutzerdaten durchzuführen.

Parameter

	`credentials:String` — Der Benutzerdatenstring.

	`agent:MessageAgent` (default = `null`) — Der MessageAgent für die Anmeldung, durch das das Anmeldeergebnis verarbeitet wird.

	`charset:String` (default = `null`) — Die zur Kodierung der Benutzerdaten verwendete Zeichensatzkodierung. Der Standardwert ist leer, dadurch wird der ältere Zeichensatz 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.

Ereignisdetails

channelConnect

Ereignis

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

Ausgelöst, nachdem ein Kanal eine Verbindung zum zugehörigen Endpunkt hergestellt hat.

Die Channel-Klasse und deren Unterklassen geben einen Channel.Connect.Failed-Code aus, sobald in einem Kanal ein Problem beim Herstellen einer Verbindung zu einem Remote-Ziel auftritt. Ein AMFChannel-Objekt gibt einen Channel.Call.Failed-Code aus, wenn der Kanal bereits verbunden ist, jedoch einen Call.Failed-Code von der zugrunde liegenden NetConnection erhält.

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 vom zugehörigen Endpunkt getrennt wurde.

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 Fehler bei einem Kanal aufgetreten 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.

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 ein Kanal eine Meldung vom zugehörigen Endpunkt erhält.

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

Der Wert dieser Konstante ist "message".

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

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

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

Konstantendetails

CONNECT_TIMEOUT_SECONDS

Konstante

protected static const CONNECT_TIMEOUT_SECONDS:String = "connect-timeout-seconds"

ENABLE_SMALL_MESSAGES

Konstante

protected static const ENABLE_SMALL_MESSAGES:String = "enable-small-messages"

FALSE

Konstante

protected static const FALSE:String = "false"

RECORD_MESSAGE_SIZES

Konstante

protected static const RECORD_MESSAGE_SIZES:String = "record-message-sizes"

RECORD_MESSAGE_TIMES

Konstante

protected static const RECORD_MESSAGE_TIMES:String = "record-message-times"

REQUEST_TIMEOUT_SECONDS

Konstante

protected static const REQUEST_TIMEOUT_SECONDS:String = "request-timeout-seconds"

SERIALIZATION

Konstante

protected static const SERIALIZATION:String = "serialization"

TRUE

Konstante

protected static const TRUE:String = "true"

Rechtliche Hinweise | Onlinedatenschutzerklärung

Channel - AS3 BlazeDS LCDS

Klassen x

authenticated

channelSets

connected

connectTimeout

endpoint

failoverURIs

id

protocol

reconnecting

recordMessageSizes

recordMessageTimes

requestTimeout

shouldBeConnected

uri

Channel

applyClientLoadBalancingSettings

applySettings

connect

connectFailed

connectSuccess

connectTimeoutHandler

disconnect

disconnectFailed

disconnectSuccess

flexClientWaitHandler

getMessageResponder

internalConnect

internalDisconnect

internalSend

logout

send

setCredentials

channelConnect

channelDisconnect

channelFault

message

propertyChange

CONNECT_TIMEOUT_SECONDS

ENABLE_SMALL_MESSAGES

FALSE

RECORD_MESSAGE_SIZES

RECORD_MESSAGE_TIMES

REQUEST_TIMEOUT_SECONDS

SERIALIZATION

TRUE