XMLSocket  - AS3

Wskazuje, czy obiekt XMLSocket jest aktualnie podłączony. Istnieje również możliwość sprawdzenia, czy nawiązanie połączenia zakończyło się powodzeniem przez zarejestrowanie zdarzenia connect i zdarzenia ioError.

Powiązane elementy interfejsu API

Wskazuje czas (liczba milisekund) oczekiwania na połączenie.

Jeśli połączenie nie zostanie nawiązane w określonym czasie, połączenie zakończy się niepowodzeniem. Wartość domyślna to 20,000 (dwadzieścia sekund).

Tworzy nowy obiekt XMLSocket. Jeśli żaden parametr nie zostanie określony, utworzone zostanie gniazdo, które początkowo nie będzie połączone z żadnym hostem. Jeśli parametry zostaną określone, nastąpi próba połączenia z określonym hostem i portem.

Uwaga: zalecane jest używanie konstruktora bez parametrów, dodanie wszelkich detektorów zdarzeń, a następnie wywołanie metody connect z parametrami host i port. Ta sekwencja gwarantuje, że wszystkie detektory zdarzeń zadziałają prawidłowo.

Powiązane elementy interfejsu API

Zamyka połączenie określone przez obiekt XMLSocket. Zdarzenie close wywoływane jest jedynie wtedy, gdy serwer zamyka połączenie; nie jest wywoływane wraz z wywołaniem metody close().

Powiązane elementy interfejsu API

Ustanawia połączenie z określonym hostem internetowym za pośrednictwem określonego portu TCP.

Jeśli dla parametru host określona zostanie wartość null, połączony host jest tym, w którym znajduje się plik wywołujący metodę XMLSocket.connect(). Na przykład jeśli wywołujący plik został pobrany ze strony www.adobe.com, określenie wartości null dla parametru hosta oznacza, że użytkownik zostanie połączony ze stroną www.adobe.com.

Istnieje możliwość zapobieżenia użyciu tej metody w pliku. Należy w tym celu ustawić parametr allowNetworking znaczników object oraz embed na stronie HTML z zawartością SWF.

Więcej informacji zawiera temat Bezpieczeństwo w Centrum programistów programu Flash Player.

Parametry

Powiązane elementy interfejsu API

Konwertuje obiekt XML lub dane określone w parametrze object na ciąg znaków, a następnie przesyła go na serwer (uzupełniając go bajtem zerowym). Jeśli parametr object jest obiektem XML, ciąg znaków jest tekstową reprezentacją XML obiektu XML. Operacja send jest asynchroniczna i powraca natychmiast, ale dane mogą zostać przesłane w późniejszym czasie. Metoda XMLSocket.send() nie zwraca wartości wskazującej, czy przesyłanie danych zakończyło się pomyślnie.

Jeśli obiekt XMLSocket nie zostanie podłączony do serwera za pomocą metody XMLSocket.connect()), operacja XMLSocket.send() zakończy się niepowodzeniem.

Parametry

Powiązane elementy interfejsu API

Wywoływana, gdy serwer zamyka połączenie z gniazdem. Zdarzenie close wywoływane jest jedynie wtedy, gdy serwer zamyka połączenie; nie jest wywoływane w wyniku wywołania metodyXMLSocket.close().

To zdarzenie ma następujące właściwości:

Wywoływane po pomyślnym wywołaniu metody XMLSocket.connect().

To zdarzenie ma następujące właściwości:

Wywoływana po wysłaniu lub odbiorze surowych danych.

To zdarzenie ma następujące właściwości:

Wywoływana, gdy wystąpi błąd wejścia lub wyjścia uniemożliwiający wysyłanie lub odbieranie danych.

To zdarzenie ma następujące właściwości:

Wywoływane, jeśli wywołanie metody XMLSocket.connect() skutkuje próbą połączenia się z serwerem na zewnątrz obszaru izolowanego lub próbą połączenia się z portem o numerze niższym niż 1024.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

1. Konstruktor XMLSocketExample tworzy instancję XMLSocket o nazwie socket i przekazuje socket do metody ConfigureListeners() (opisanej poniżej) i następnie wywołuje metodę connect() instancji XMLSocket korzystając z nazwy hosta „localhost” oraz numeru portu 8080.
2. Następnie wywoływana jest metoda configureListeners(), która dodaje detektory dla każdego z obsługiwanych zdarzeń obiektu XMLSocket:
   • closeHandler(): wykrywa zdarzenie close, które wywoływane jest po zamknięciu połączenia sieciowego.
   • connectHandler(): wykrywa zdarzenie connect, które wywoływane jest po ustanowieniu połączenia.
   • dataHandler(): wykrywa zdarzenia data, ktore wywoływane są za każdym razem, kiedy obiekt XMLSocket otrzyma nowe dane.
   • progressHandler(): wykrywa zdarzenia progress, które wywoływane w momencie wywołania metody send() i w czasie wysyłania.
   • securityErrorHandler(): wykrywa zdarzenia securityError, które zostaną wywołane, jeśli nastąpi próba uzyskania dostępu do obiektu XMLSocket z niewłaściwym ustawieniem zabezpieczenia odtwarzania lokalnego lub próba użycia portu o numerze niższym niż 1024.
   • ioErrorHandler(): wykrywa zdarzenia ioError, które pojawią·się jedynie wtedy, gdy operacja wysyłania lub odbierania danych zakończy się niepowodzeniem.

Uwagi:

• Należy skompilować plik SWF z opcją „Bezpieczeństwo odtwarzania lokalnego” ustawioną na wartość „Tylko dostęp sieciowy”.
• Aby ten przykład zadziałał, potrzebny jest też serwer działający w domenie użytkownika na porcie 8080.
• Jeśli używany jest program Flash Player 9.0.124.0 lub nowsza wersja, wówczas należy umieścić na serwerze użytkownika plik reguł gniazd, który zezwala na nawiązywanie połączeń gniazd z domeny użytkownika na port 8080. Informacje na temat umieszczania plików reguł gniazd znajdują się w temacie centrum informacji dla programistów dotyczącego programu Flash Player: Konfigurowanie serwera plików reguł dotyczącej gniazd.

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