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

HTTPChannel  - AS3 BlazeDS LCDS

Paketmx.messaging.channels
Klassepublic class HTTPChannel
VererbungHTTPChannel Inheritance PollingChannel Inheritance Channel Inheritance EventDispatcher Inheritance Object
Unterklassen SecureHTTPChannel, StreamingHTTPChannel

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 HTTPChannel-Klasse bietet HTTP-Unterstützung für Meldungen. Sie können diesen Kanal konfigurieren, um die Abfrage vom Server in einem sich an den Server-Push annähernden Intervall abzufragen. Sie können diesen Kanal auch bei deaktivierter Abfrage verwenden, um RPC-Meldungen an Remote-Ziele senden und die zugehörigen Methoden aufzurufen.

Der HTTPChannel greift auf Netzwerkdienste zurück, die in Flash Player und AIR nativ sind, und wird für ActionScript von der URLLoader-Klasse bereitgestellt. Dieser Kanal verwendet ausschließlich das URLLoader, und erstellt auf Anforderung ein neues URLLoader.

Kanäle werden innerhalb der Architektur mithilfe der ServerConfig.getChannel()-Methode erstellt. Kanäle können direkt erstellt und einem ChannelSet gegebenenfalls zugewiesen werden.

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.

Im Abfragemodus fragt dieser Kanal den Server nach neuen Meldungen basierend auf der Eigenschaft polling-interval-seconds in der Konfigurationsdatei ab. Dieser Wert kann in der Eigenschaft pollingInterval geändert werden. Die Standardeinstellung ist 3 Sekunden. Um die Abfrage zu aktivieren, muss der Kanal verbunden sein und die Eigenschaft polling-enabled in der Konfigurationsdatei auf true gesetzt sein bzw. die Eigenschaft pollingEnabled des Kanals auf true gesetzt sein.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedauthenticated : Boolean
[schreibgeschützt] Gibt an, ob dieser Kanal authentifiziert ist.
Channel
 InheritedchannelSets : Array
[schreibgeschützt] Bietet Zugriff auf die mit dem Kanal verbundenen ChannelSets.
Channel
 Inheritedconnected : Boolean
[schreibgeschützt] Gibt an, ob dieser Kanal eine Verbindung zum Remote-Ziel versucht hat.
Channel
 InheritedconnectTimeout : int
Bietet Zugriff auf das Verbindungszeitlimit (in Sekunden) für den Kanal.
Channel
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 Inheritedendpoint : String
[schreibgeschützt] Bietet Zugriff auf den Endpunkt für diesen Kanal.
Channel
 InheritedfailoverURIs : 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
 Inheritedid : String
Bietet Zugriff auf die ID für diesen Kanal.
Channel
  piggybackingEnabled : Boolean
Gibt an, ob dieser Kanal Abfrageanforderungen zusammen mit normalen ausgehenden Meldungen ausführt, wenn keine ausstehende Abfrage durchgeführt wird.
HTTPChannel
  polling : Boolean
[schreibgeschützt] Gibt an, ob der Kanal derzeit aktiv eine Abfrage durchführt.
HTTPChannel
  pollingEnabled : Boolean
Gibt an, ob dieser Kanal für eine Abfrage aktiviert ist.
HTTPChannel
  pollingInterval : Number
Bietet Zugriff auf das Abfrageintervall für diesen Kanal.
HTTPChannel
  protocol : String
[override] [schreibgeschützt] Gibt das Protokoll für diesen Kanal zurück (http).
HTTPChannel
 Inheritedreconnecting : Boolean
[schreibgeschützt] Gibt an, ob dieser Kanal gerade eine Neuverbindung zu einem alternativen Endpunkt durchführt.
Channel
 InheritedrecordMessageSizes : Boolean
[schreibgeschützt] Die Kanaleigenschaft bestimmt die Stufe der Leistungsinformationsinjektion, das heißt, ob Meldungsgrößen injektiert werden.
Channel
 InheritedrecordMessageTimes : Boolean
[schreibgeschützt] Die Kanaleigenschaft bestimmt die Stufe der Leistungsinformationsinjektion, das heißt, ob Zeitstempel injektiert werden.
Channel
 InheritedrequestTimeout : int
Bietet Zugriff auf das standardmäßige Anforderungszeitlimit (in Sekunden) für den Kanal.
Channel
 Inheriteduri : String
Bietet Zugriff auf die URI, die zur Erstellung der gesamten Endpunkt-URI für diesen Kanal verwendet wird.
Channel
Geschützte Eigenschaften
 EigenschaftDefiniert von
 InheritedshouldBeConnected : Boolean
[schreibgeschützt] Gibt an, ob dieser Kanal mit dem Endpunkt verbunden werden soll.
Channel
Öffentliche Methoden
 MethodeDefiniert von
  
HTTPChannel(id:String = null, uri:String = null)
Konstruktor.
HTTPChannel
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
 Inherited
Unterklassen sollte diese Methode überschreiben, um Einstellungen anzuwenden, die gegebenenfalls für einen bestimmten Kanal notwendig sind.
Channel
 Inherited
connect(channelSet:ChannelSet):void
Verbindet den ChannelSet mit dem Kanal.
Channel
 Inherited
Deaktiviert die Abfrage je nach Anzahl des Aufrufens von enablePolling() und disablePolling().
PollingChannel
 Inherited
Trennt die Verbindung des ChannelSet vom Kanal.
Channel
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Aktiviert die Abfrage je nach Anzahl des Aufrufens von enablePolling() und disablePolling().
PollingChannel
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Sendet eine CommandMessage an den Server, um eine Abmeldung durchzuführen, wenn der Kanal verbunden wurde.
Channel
 Inherited
Leitet eine Abfrage ein, wenn Verbraucher diesen Kanal abonniert haben. Die Abfrage wird für diesen Kanal aktiviert.
PollingChannel
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
send(agent:MessageAgent, message:IMessage):void
[override] Sendet die angegebene Meldung an das zugehörige Ziel.
PollingChannel
 Inherited
setCredentials(credentials:String, agent:MessageAgent = null, charset:String = null):void
Definiert die Benutzerdaten auf den angegebenen Wert.
Channel
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Geschützte Methoden
 MethodeDefiniert von
 Inherited
Wendet die Client-Lastausgleich-URL an, falls vorhanden.
Channel
 Inherited
Verarbeitet eine fehlgeschlagene interne Verbindung und löst das Ereignis FAULT für den Kanal aus.
Channel
 Inherited
Verarbeitet eine erfolgreiche interne Verbindung und löst das Ereignis CONNECT für den Kanal aus.
Channel
 Inherited
Verarbeitet ein Verbindungszeitlimit, indem ein ChannelFaultEvent ausgelöst wird.
Channel
 Inherited
Verarbeitet eine fehlgeschlagene interne Verbindungstrennung und löst das Ereignis FAULT für den Kanal aus.
Channel
 Inherited
disconnectSuccess(rejected:Boolean = false):void
Verarbeitet eine erfolgreiche interne Verbindungstrennung und löst das Ereignis DISCONNECT für den Kanal aus.
Channel
 Inherited
Verarbeitet eine Änderung an der Schutzbedingung, um eine anfängliche Kanalverbindung für die Anwendung zu verwalten.
Channel
 Inherited
Gibt den entsprechenden MessageResponder für die send()-Methode des Kanals zurück.
Channel
 Inherited
Verbindet den Kanal mit dem zugehörigen Endpunkt.
Channel
 Inherited
internalDisconnect(rejected:Boolean = false):void
Trennt die Verbindung des Kanals vom zugehörigen Endpunkt.
Channel
 Inherited
Sendet die Meldung über den Kanal und leitet die Antwort an den Responder.
Channel
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 InheritedAusgelöst, nachdem ein Kanal eine Verbindung zum zugehörigen Endpunkt hergestellt hat.Channel
 InheritedAusgelöst, nachdem ein Kanal vom zugehörigen Endpunkt getrennt wurde.Channel
 InheritedAusgelöst, nachdem ein Fehler bei einem Kanal aufgetreten ist.Channel
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
 InheritedAusgelöst, wenn ein Kanal eine Meldung vom zugehörigen Endpunkt erhält.Channel
 InheritedAusgelöst, wenn eine Eigenschaft des Kanals sich ändert.Channel
Eigenschaftendetails

piggybackingEnabled

Eigenschaft
piggybackingEnabled: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 dieser Kanal Abfrageanforderungen zusammen mit normalen ausgehenden Meldungen ausführt, wenn keine ausstehende Abfrage durchgeführt wird. Dadurch kann der Server Daten für den Client zusammen mit der zugehörigen Antwort auf die Meldung des Client ausführen.



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

polling

Eigenschaft 
polling: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 Kanal derzeit aktiv eine Abfrage durchführt.



Implementierung
    public function get polling():Boolean

pollingEnabled

Eigenschaft 
pollingEnabled: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 dieser Kanal für eine Abfrage aktiviert ist.



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

pollingInterval

Eigenschaft 
pollingInterval:Number

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 Abfrageintervall für diesen Kanal. Der Wert wird in Millisekunden angegeben. Dieser Wert bestimmt, wie oft dieser Kanal Meldungen vom Server anfordert, um sich an den Server-Push anzunähern.



Implementierung
    public function get pollingInterval():Number
    public function set pollingInterval(value:Number):void

Auslöser
ArgumentError — In dem Fall, dass dem pollingInterval ein Wert von 0 oder weniger zugewiesen ist.

protocol

Eigenschaft 
protocol:String  [schreibgeschützt] [override]

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 das Protokoll für diesen Kanal zurück (http).



Implementierung
    override public function get protocol():String
Konstruktordetails

HTTPChannel

()Konstruktor
public function HTTPChannel(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

Konstruktor.

Parameter
id:String (default = null) — Die ID dieses Kanals.
 
uri:String (default = null) — Der URI dieses Kanals.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

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