XMLSocket  - AS3

Anger om det här XMLSocket-objektet är anslutet. Du kan även kontrollera om anslutningen gick bra genom att registrera händelserna connect och ioError.

Relaterade API-element

Indikerar antal millisekunder som du behöver vänta för en anslutning.

Om anslutningen inte lyckas inom specificerad tid, avbryts anslutningarna. Standardvärdet är 20 000 (tjugo sekunder).

Skapar ett nytt XMLSocket-objekt. Om inga parametrar anges skapas en socket som är frånkopplad. Om parametrarna anges görs ett försök att ansluta till angiven värdenhet och port.

Obs! Du bör absolut använda konstruktorformen utan parametrar, sedan lägga till händelseavlyssnare och anropa metoden connect med parametrarna host och port. Denna sekvens garanterar att alla händelseavlyssnare fungerar ordentligt.

Relaterade API-element

Stänger anslutningen som anges av XMLSocket-objektet. Händelsen close skickas endast om servern stänger anslutningen; den skickas inte när du anropar metoden close().

Relaterade API-element

Upprättar en anslutning till den angivna Internetvärden med den angivna TCP-porten.

Om du anger null för parametern host är den värd som kontaktas samma som den som filen som anropar XMLSocket.connect() finns på. Om till exempel den anropande filen lästes in från www.adobe.com och specificerade null för värdparametern, innebär det att du är ansluten till www.adobe.com.

Du kan förhindra att metoden används av en fil genom att ange parametern allowNetworking i object- och embed-taggarna på den HTML-sida där SWF-innehållet finns.

Mer information finns i avsnittet Security på Flash Player Developer Center.

Parametrar

Relaterade API-element

Konverterar XML-objektet eller data som anges i parametern object till en sträng och överför den till servern följd av en nollbyte (0). Om object är ett XML-objekt är strängen dess XML-textbeteckning. Send-åtgärden är asynkron. Den returnerar direkt, men data kan skickas vid ett senare tillfälle. Metoden XMLSocket.send() returnerar inte ett värde som anger om data kunde skickas.

Om du inte ansluter objektet XMLSocket till servern via XMLSocket.connect() misslyckas åtgärden XMLSocket.send().

Parametrar

Relaterade API-element

Skickas när servern stänger socketanslutningen. Händelsen close skickas endast om servern stänger anslutningen; den skickas inte när du anropar metoden XMLSocket.close().

Den här händelsen har följande egenskaper:

Skickas efter ett lyckat anrop till metoden XMLSocket.connect().

Den här händelsen har följande egenskaper:

Skickas när råa data skickas eller tas emot.

Den här händelsen har följande egenskaper:

Skickas om ett in-/utdatafel orsakar en misslyckad åtgärd för att skicka eller ta emot data.

Den här händelsen har följande egenskaper:

Skickas om ett anrop till metoden XMLSocket.connect() försöker ansluta till antingen en server utanför anroparens säkerhetssandlåda eller till en port lägre än 1024.

Den här händelsen har följande egenskaper:

Relaterade API-element

1. Med XMLSocketExample-konstruktorn skapas XMLSocket-instansen socket som överför socket till ConfigureListeners() (beskrivs nedan). Sedan anropas metoden connect() för XMLSocket via värdnamnet "localhost" och portnumret 8080.
2. Därefter anropas metoden configureListeners() som lägger till avlyssnare för varje XMLSocket-händelse som används:
   • closeHandler(): avlyssnar händelsen close som skickas när nätverksanslutningen stängs
   • connectHandler(): avlyssnar händelsen connect som skickas när nätverksanslutningen har upprättats
   • dataHandler(): avlyssnar händelserna data som skickas varje gång som XMLSocket tar emot nya data
   • progressHandler(): avlyssnar händelserna progress som skickas när ett anrop till send() görs och medan sändningen pågår
   • securityErrorHandler(): avlyssnar securityError-händelser som skickas vid försök att använda XMLSocket med fel lokala säkerhetsinställning för uppspelning eller en port som är lägre än 1024
   • ioErrorHandler(): avlyssnar ioError-händelser som inträffar endast vid en misslyckad åtgärd för att skicka eller ta emot data.

Obs!

• Du måste kompilera SWF-filen med ”Lokal uppspelningssäkerhet” angiven till ”Använd bara nätverket”.
• Du behöver en server som körs på din domän och som använder port 8080 för att exemplet ska fungera.
• Om du kör Flash Player 9.0.124.0 eller en senare version, behöver du placera en socketprincipfil på din server som tillåter socketanslutninar från din domän till port 8080. Mer information om hur socketprincipfiler körs finns i avsnittet Skapa en socketprincipfilserver på Flash Player Developer Center.

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.XMLSocket;

    public class XMLSocketExample extends Sprite {
        private var hostName:String = "localhost";
        private var port:uint = 8080;
        private var socket:XMLSocket;

        public function XMLSocketExample() {
            socket = new XMLSocket();
            configureListeners(socket);
            if (hostName && port) {
                socket.connect(hostName, port);
            }
        }

        public function send(data:Object):void {
            socket.send(data);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.CLOSE, closeHandler);
            dispatcher.addEventListener(Event.CONNECT, connectHandler);
            dispatcher.addEventListener(DataEvent.DATA, dataHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

        private function closeHandler(event:Event):void {
            trace("closeHandler: " + event);
        }

        private function connectHandler(event:Event):void {
            trace("connectHandler: " + event);
        }

        private function dataHandler(event:DataEvent):void {
            trace("dataHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }
    }
}