HTTPService  - AS3 Flex

Stellt einen Zugriff auf das vom Dienst verwendete ChannelSet bereit. Der ChannelSet kann manuell erstellt und zugewiesen werden oder wird dynamisch erstellt, wobei er die konfigurierten Kanäle als destination dieses Dienstes verwendet

Wert, der angibt, wie mehrere Aufrufe desselben Dienstes verarbeitet werden sollen. Der Standardwert lautet multiple. Folgende Werte sind zulässig:

• multiple Existierende Anforderungen werden nicht abgebrochen; der Entwickler muss für die Konsistenz der zurückgegebenen Daten sorgen, indem er den Ereignis-Stream sorgfältig verwaltet. Dies ist der Standardwert.
• single Es ist jeweils nur eine einzelne Anforderung für den Vorgang zulässig; mehrere Anforderungen lösen einen Fehler aus.
• last Jede Anforderung bewirkt, dass alle bereits existierenden Anforderungen abgebrochen werden.

Art des Inhalts für Dienstanforderungen. Die Standardeinstellung ist application/x-www-form-urlencoded, wobei Anforderungen als normale HTTP POST mit Namen-/Wertpaaren übermittelt werden. application/xml übermittelt Anforderungen als XML.

Ein HTTPService-Zielname in der services-config.xml-Datei. Mangels einer Angabe verwendet Flex das DefaultHTTP-Ziel. Wenn Sie die url-Eigenschaft verwenden, jedoch möchten, dass die Anforderungen den Proxy über HTTPS erreichen, geben Sie DefaultHTTPS an.

Benutzerdefinierte HTTP-Header, die an Endpunkte von Drittparteien gesendet werden sollen. Wenn mehrere Header mit demselben Namen übermittelt werden sollen, muss der Wert als Array definiert werden.

Das Ergebnis des letzten Aufrufs.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das resultForBinding -Ereignis ausgelöst.

Wenn dieser Wert true ist, wird die Umwandlung zurückgegebener anonymer Objekte in bindbare Objekte erzwungen.

HTTP-Methode zum Senden der Anforderung. Zulässige Werte sind GET, POST, HEAD, OPTIONS, PUT, TRACE und DELETE. Kleinbuchstaben werden in Großbuchstaben umgewandelt. Der Standardwert ist GET.

Objekt aus Namen-/Wertpaaren, die als Parameter der URL verwendet werden. Wenn die contentType-Eigenschaft auf application/xml eingestellt ist, sollte es ein XML-Dokument sein.

Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen. Ein Wert, der kleiner oder gleich null ist, verhindert die Zeitüberschreitung der Anforderung.

Wert, der angibt, wie die Serialisierung des vom HTTP-Aufruf zurückgegebene Ergebnisses aufgehoben werden soll. Der Wert hängt von folgenden Optionen ab:

• Ob Sie XML oder Namen-/Wertpaare zurückgeben.
• Wie Sie auf Ergebnisse zugreifen möchten: als Objekt, Text oder XML.

Der Standardwert ist object. Folgende Werte sind zulässig:

• object Der zurückgegebene Wert ist XML und wird als Baum von ActionScript-Objekten geparst. Dies ist die Standardeinstellung.
• array Der zurückgegebene Wert ist XML und wird als Baum von ActionScript-Objekten geparst. Wenn jedoch das Objekt auf der höchsten Ebene kein Array ist, wird ein neues Array erstellt, dessen erstes Element das Ergebnis ist. Wenn makeObjectsBindable auf „true“ eingestellt ist, wird das Array in eine ArrayCollection eingebunden.
• xml Der zurückgegebene Wert ist XML und wird als literal XML in einem ActionScriptXMLnode-Objekt geparst.
• flashvars Der zurückgegebene Wert ist Text mit durch Und-Zeichen getrennten Name-/Wertpaaren, der in ein ActionScript-Objekt geparst wird.
• text Der zurückgegebene Wert ist Text und wird unformatiert gelassen.
• e4x Der zurückgegebene Wert ist XML und wird als Literal XML in einem ActionScript-XML-Objekt zurückgegeben, auf das mit ECMAScript für XML (E4X) zugegriffen werden kann.

Die URL, die der HTTPService bei der Berechnung relativer URLs verwenden soll. Diese Eigenschaft wird nur bei Verwendung eines Proxys verwendet. Wenn die useProxy-Eigenschaft auf false eingestellt ist, wird die relative URL automatisch aufgrund der Position der SWF-Datei berechnet, die diese Anwendung ausführt. Wenn nicht ausdrücklich ausgewählt, wird rootURL automatisch auf die URL der mx.messaging.config.LoaderConfig.url eingestellt.

Stellt einen Adapter bereit, der die Umwandlung des Hauptteils der HTTP-Antwort in ActionScript-Objekte und/oder der Parameter bzw. des Hauptteils in contentType, URL und Post-Body der HTTP-Anforderung steuert. Diese Einstellung kann auch indirekt erfolgen, indem das resultFormat durch die Registrierung eines SerializationFilter mithilfe der statischen Methode eingestellt wird: SerializationFilter.registerFilterForResultFormat("formatName", filter)

Wenn die Einstellung true ist, wird ein Aktivitäten-Cursor angezeigt, während ein Dienst ausgeführt wird. Der Standardwert ist false.

Position des Dienstes. Wenn Sie die URL und ein nicht standardmäßiges Ziel angeben, muss das Ziel in der services-config.xml-Datei die angegebene URL zulassen.

Gibt an, ob der Flex-Proxy-Dienst verwendet werden soll. Der Standardwert ist false. Wenn Sie nicht true für Proxy-Anforderungen über den Flex-Server angeben, müssen Sie sicherstellen, dass der Player die Ziel-URL erreichen kann. Sie können auch keine in der services-config.xml-Datei definierten Ziele verwenden, wenn die useProxy-Eigenschaft auf false eingestellt ist.

Der Standardwert ist false.

ActionScript-Funktion, die zum Dekodieren eines Dienstergebnisses aus XML verwendet wird. Wenn das resultFormat ein Objekt ist und die xmlDecode-Eigenschaft gesetzt ist, erstellt Flex mithilfe der vom HTTPService zurückgegebenen XML-Datei ein Objekt. Bei fehlender Definition wird dafür der Standard-XMLDecoder verwendet.

Die Funktion, auf die die xmlDecode-Eigenschaft verweist, muss ein flash.xml.XMLNode-Objekt als Parameter übernehmen und ein Objekt zurückgeben. Sie kann jede Art von Objekt zurückgeben. Wichtig ist, dass etwas zurückgeben wird: Die Rückgabe von null oder undefined erzeugt einen Fehler.

   <mx:HTTPService id="hs" xmlDecode="xmlDecoder" url="myURL" resultFormat="object" contentType="application/xml">
        <mx:request><source/>
            <obj>{RequestObject}</obj>
        </mx:request>
   </mx:HTTPService>

function xmlDecoder (myXML)
{
 // Simplified decoding logic.
 var myObj = {};
 myObj.name = myXML.firstChild.nodeValue;
 myObj.honorific = myXML.firstChild.attributes.honorific;
 return myObj;
}

ActionScript-Funktion, die zum Dekodieren einer Dienstanforderung als XML verwendet wird. Wenn die contentType einer Anforderung application/xml und das übergebene Anforderungsobjekt ein Objekt ist, versucht Flex, dieses mithilfe der in der xmlEncode-Eigenschaft angegebenen Funktion in ein flash.xml.XMLNode-Objekt umzuwandeln. Wenn die xmlEncode-Eigenschaft nicht gesetzt ist, verwendet Flex den Standard-XMLEncoder zur Umwandlung des Objektdiagramms in ein flash.xml.XMLNode-Objekt.

Die xmlEncode-Eigenschaft verwendet ein Objekt und muss ein flash.xml.XMLNode-Objekt zurückgeben. In diesem Fall kann das XMLNode-Objekt ein flash.xml.XML-Objekt sein, das eine Unterklasse von XMLNode bzw. das erste untergeordnete Element des flash.xml.XML-Objekts ist, also das Ergebnis eines <mx:XML>-Tags. Bei Rückgabe des falschen Objekttyps wird ein Fehler erzeugt. Das nachstehende Beispiel zeigt ein <mx:HTTPService>-Tag, das eine xmlEncode-Funktion angibt:

  <mx:HTTPService id="hs" xmlEncode="xmlEncoder" url="myURL" resultFormat="object" contentType="application/xml">
        <mx:request><source/>
            <obj>{RequestObject}</obj>
        </mx:request>
   </mx:HTTPService>
    

function xmlEncoder (myObj)
{
  return new XML("");
}

Erstellt einen neuen HTTPService. Wenn der Dienst beim Senden relative URLs verwenden soll, können Sie die rootURL angeben, die als Basis für die Bestimmung der vollständigen URL verwendet wird (z. B.:Application.application.url).

Bricht den letzten Dienstaufruf oder einen Aufruf mit der angegebenen ID ab. Auch wenn der Netzvorgang noch weiterläuft, wird kein Ergebnis oder Fehlerereignis ausgelöst.

Parameter

Setzt die result-Eigenschaft der aufrufenden Instanz auf null. Dies ist nützlich, wenn das Ergebnis ein großes Objekt ist, das nicht mehr verwendet wird.

Parameter

Trennt die Netzverbindung des Dienstes. Diese Methode wartet nicht, bis anstehende Netzwerkvorgänge abgeschlossen sind.

Meldet den Benutzer vom Ziel ab. Die Abmeldung von einem Ziel gilt für sämtliche verbundenen Elemente, die denselben, in der Serverkonfiguration festgelegten Kanal verwenden. Wenn Sie z. B. über den my-rtmp-Kanal verbunden sind und sich über eine der RPC-Komponenten abmelden, werden alle über my-rtmp verbundenen Elemente abgemeldet.

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

Verwandte API-Elemente

Führt eine HTTPService-Anforderung aus. Die Parameter sind optional, doch wenn sie verwendet werden, sollten sie ein Objekt mit Namen-/Wertpaaren oder ein XML-Objekt sein, je nach contentType.

Parameter

Setzt die Benutzerdaten für das Ziel, auf das über den Dienst zugegriffen wird. Die Benutzerdaten werden für alle Dienste angewandt, die über denselben ChannelSet verbunden sind. Dienste, die einen Proxy für ein Remoteziel verwenden, müssen stattdessen die setRemoteCredentials()-Methode aufrufen.

Parameter

Der Benutzername und das Kennwort für die Authentifizierung eines Benutzers für den Zugriff auf die HTTP-URL. Diese werden vom Proxy als Bestandteil des HTTP-Berechtigungs-Headers dem Endpunkt übergeben. Wenn die useProxy-Eigenschaft auf „false“ eingestellt ist, wird diese Eigenschaft ignoriert.

Parameter

Wird ausgelöst, wenn ein HTTPService-Aufruf fehlschlägt.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Das Aufrufereignis wird durch einen HTTPService-Aufruf ausgelöst, es sei denn, es wird ein Fehler ausgelöst, bevor der Kanal versucht, die Meldung zu senden.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Wird ausgelöst, wenn ein HTTPService-Aufruf erfolgreich zurückgegeben wird.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Gibt an, dass durch den HTTP-Dienst übermittelte Daten als application/x-www-form-urlencoded kodiert sind.

Gibt an, dass durch den HTTP-Dienst übermittelte Daten als application/xml kodiert sind.

Gibt an, dass das HTTPService-Objekt das DefaultHTTP-Ziel verwendet.

Gibt an, dass das HTTPService-Objekt das DefaultHTTPS-Ziel verwendet.

Gibt an, dass ein XML-formatiertes Ergebnis nicht als XML-Instanz geparst oder als Objekt dekodiert werden konnte.

Gibt an, dass ein Eingabeparameter nicht als XML kodiert werden konnten.

Gibt an, dass die useProxy-Eigenschaft auf „false“ eingestellt, jedoch keine URL angegeben wurde.

Das Ergebnisformat „array“ ist ähnlich dem Ergebnisformat „object“; der zurückgegebene Wert ist jedoch immer ein Array. Wenn das vom Ergebnisformat „object“ zurückgegebene Ergebnis nicht bereits ein Array ist, bildet es das erste Element eines neuen Array.

Das Ergebnisformat „e4x“ legt fest, dass der zurückgegebene Wert eine XML-Instanz ist, auf die unter Verwendung von ECMAScript for XML (E4X)-Ausdrücke zugegriffen werden kann.

Das Ergebnisformat „flashvars“ legt fest, dass der zurückgegebene Wert Text ist, der durch kaufmännische Und-Zeichen getrennte Name=Wertpaare enthält und in ein ActionScript-Objekt geparst wird.

Das Ergebnisformat „object“ legt fest, dass der zurückgegebene Wert XML ist, aber als Baum von ActionScript-Objekten geparst wird. Dies ist die Standardeinstellung.

Das Ergebnisformat „text“ legt fest, dass der HTTPService-Ergebnistext ein unverarbeiteter String sein soll.

Das Ergebnisformat „xml“ legt fest, dass Ergebnisse als flash.xml.XMLNode-Instanz zurückgegeben werden sollen, die auf das erste untergeordnete Element des übergeordneten flash.xml.XMLDocument weist.