XMLSocket  - AS3

Geeft aan of dit object XMLSocket momenteel is verbonden. U kunt ook controleren of de verbinding is geslaagd via registratie voor de gebeurtenis connect en de gebeurtenis ioError.

Verwante API-elementen

Hiermee wordt aangegeven hoeveel milliseconden er op een verbinding wordt gewacht.

Als de verbinding niet binnen de opgegeven tijd tot stand kan worden gebracht, is de verbinding mislukt. De standaardwaarde is 20,000 (twintig seconden).

Hiermee wordt een nieuw object XMLSocket gemaakt. Wanneer geen parameters worden opgegeven, wordt een aanvankelijk niet-verbonden socket gemaakt. Wanneer wel parameters worden opgegeven, wordt geprobeerd verbinding te maken met de opgegeven host en poort.

Opmerking: het wordt sterk aanbevolen om gebruik te maken van het constructorformulier zonder parameters, vervolgens eventuele gebeurtenislisteners toe te voegen en vervolgens de methode connect aan te roepen met de parameters host en poort. Deze volgorde zorgt ervoor dat alle gebeurtenislisteners goed werken.

Verwante API-elementen

Sluit de verbinding die door het object XMLSocket is opgegeven. De gebeurtenis close wordt alleen verzonden wanneer de server de verbinding sluit. De gebeurtenis wordt niet verzonden wanneer u de methode close() aanroept.

Verwante API-elementen

Brengt via de opgegeven TCP-poort een verbinding met de opgegeven internethost tot stand.

Wanneer u de parameter host op null instelt, wordt verbinding gemaakt met de host waarop het bestand zich bevindt dat XMLSocket.connect() aanroept. Als het aanroepende bestand bijvoorbeeld is gedownload van www.adobe.com en u stelt de parameter host in op null, betekent dit dat u verbinding maakt met www.adobe.com.

U kunt voorkomen dat een bestand deze methode gebruikt door de parameter allowNetworking in te stellen van de tags object en embed op de HTML-pagina die de SWF-inhoud bevat.

Lees voor meer informatie het onderwerp Security in het Flash Player Developer Center.

Parameters

Verwante API-elementen

Zet het XML-object of de gegevens die in de parameter object zijn opgegeven om in een tekenreeks en verzendt deze naar de server, gevolgd door een nulbyte (0). Wanneer object een XML-object is, is de tekenreeks de tekstuele XML-representatie van het XML-object. De verzendbewerking is asynchroon; er wordt direct geretourneerd, maar de gegevens kunnen later worden verzonden. De methode XMLSocket.send() retourneert geen waarde die aangeeft of de gegevens zijn verzonden.

Wanneer u het object XMLSocket niet met de server verbindt via XMLSocket.connect() ), mislukt de bewerking XMLSocket.send().

Parameters

Verwante API-elementen

Wordt verzonden wanneer de server de socketverbinding sluit. De gebeurtenis close wordt alleen verzonden wanneer de server de verbinding sluit. De gebeurtenis wordt niet verzonden wanneer u de methode XMLSocket.close() aanroept.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden na een geslaagde aanroep van de methode XMLSocket.connect().

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden nadat onbewerkte gegevens zijn verzonden of ontvangen.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer een invoer-/uitvoerfout optreedt die ertoe leidt dat een verzend- of ontvangstbewerking mislukt.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer een aanroep van de methode XMLSocket.connect() probeert verbinding te maken met een server buiten de beveiligingssandbox van het aanroepende bestand of met een poort lager dan 1024.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

1. De constructor XMLSocketExample maakt een instantie XMLSocket genaamd socket en geeft socket door aan ConfigureListeners() (zoals hieronder wordt beschreven). Vervolgens wordt de methode connect() van XMLSocket aangeroepen met de hostnaam "localhost" en poortnummer 8080.
2. Daarna wordt de methode configureListeners() aangeroepen, die listeners toevoegt voor elk van de ondersteunde gebeurtenissen XMLSocket:
   • closeHandler(): luistert naar de gebeurtenis close die wordt verzonden nadat de netwerkverbinding is gesloten.
   • connectHandler(): luistert naar de gebeurtenis connect die wordt verzonden wanneer de netwerkverbinding tot stand is gebracht.
   • dataHandler(): luistert naar de gebeurtenis data die wordt verzonden telkens wanneer XMLSocket nieuwe gegevens ontvangt.
   • progressHandler(): luistert naar de gebeurtenis progress die wordt verzonden wanneer send() wordt aangeroepen en terwijl de verzending plaatsvindt.
   • securityErrorHandler(): luistert naar de gebeurtenis securityError die wordt verzonden wanneer wordt geprobeerd toegang te verkrijgen tot XMLSocket met een onjuiste instelling voor lokale afspeelbeveiliging of via een poort lager dan 1024.
   • ioErrorHandler(): luistert naar de gebeurtenis ioError die alleen plaatsvindt wanneer een bewerking om gegevens te verzenden of te ontvangen mislukt.

Opmerkingen:

• U moet het SWF-bestand compileren met Lokale afspeelbeveiliging ingesteld op Alleen netwerk benaderen.
• Dit voorbeeld werkt alleen met een server die op uw domein via poort 8080 wordt uitgevoerd.
• Als u Flash Player 9.0.124.0 of hoger hebt, moet u een bestand met socketbeleid op de server plaatsen dat socketverbindingen toestaat vanaf uw domein naar poort 8080. Meer informatie over het op de server plaatsen van bestanden met socketbeleid vindt u in het volgende onderwerp op het Flash Player Developer Center: Een server voor een bestand met socketbeleid instellen.

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);
        }
    }
}