Socket  - AS3

Liczba bajtów, które można odczytać z bufora wejściowego.

Kod użytkownika musi uzyskać dostęp do właściwości bytesAvailable, aby upewnić się, że dostępna jest wystarczająca ilość danych, zanim nastąpi próba ich odczytania za pomocą jednej z metod read.

Wskazuje liczbę bajtów, które pozostały w buforze zapisu.

Tej właściwości należy używać łącznie ze zdarzeniem OutputProgressEvent. Zdarzenie OutputProgressEvent jest generowane, gdy dochodzi do zapisu danych z bufora zapisu do sieci. Ilość danych w buforze oczekujących na zapisanie można sprawdzić, używając właściwości bytesPending w module obsługi zdarzeń. Zerowa wartość właściwość bytesPending oznacza, że wszystkie dane zostały przeniesione z bufora zapisu do sieci — można bezpiecznie usunąć moduł obsługi zdarzeń, wyzerować odniesienia do gniazd, rozpocząć następne wysyłanie znajdujące się w kolejce itd.

Powiązane elementy interfejsu API

Wskazuje, czy obiekt Socket jest aktualnie podłączony. Wywołanie tej właściwości zwraca wartość true, jeśli gniazdo jest w danym momencie połączone, w innym przypadku wartość false.

Przedstawia porządek bajtów danych. Możliwe wartości są stałymi należącymi do klasy flash.utils.Endian: Endian.BIG_ENDIAN albo Endian.LITTLE_ENDIAN.

Wartością domyślną jest Endian.BIG_ENDIAN.

Powiązane elementy interfejsu API

Adres IP, z którym to gniazdo jest powiązane na komputerze lokalnym.

Powiązane elementy interfejsu API

Port, z którym to gniazdo jest powiązane na komputerze lokalnym.

Powiązane elementy interfejsu API

Zapewnia kontrolę nad wersją formatu AMF stosowaną przy zapisywaniu i odczycie obiektu.

Powiązane elementy interfejsu API

Adres IP komputera zdalnego, z którym jest połączone to gniazdo.

Ta właściwość umożliwia określenie adresu IP gniazda klienta przekazanego w zdarzeniu ServerSocketConnectEvent wywołanym przez obiekt ServerSocket. Za pomocą klasy DNSResolver można w razie potrzeby przekonwertować adres IP na nazwę domeny.

Powiązane elementy interfejsu API

Port komputera zdalnego, z którym jest połączone to gniazdo.

Ta właściwość umożliwia określenie numeru portu gniazda klienckiego przekazanego w zdarzeniu ServerSocketConnectEvent wywołanym przez obiekt ServerSocket.

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 Socket. 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.

Zamyka gniazdo. Po wywołaniu metody close() nie można odczytywać ani zapisywać danych.

Zdarzenie close wywoływane jest jedynie wtedy, gdy serwer zamyka połączenie; nie jest wywoływane wraz z wywołaniem metody close().

Obiektu Socket można użyć ponownie, wywołując raz jeszcze na nim metodę connect().

Łączy gniazdo z określonym komputerem i portem.

Jeśli połączenie natychmiast zakończy się niepowodzeniem, wywołane zostanie zdarzenie lub wygenerowany zostanie wyjątek. Jeśli komputer został określony, zostanie wywołane zdarzenie error, a jeśli nie określono żadnego komputera, zostanie wygenerowany wyjątek. W przeciwnym razie zdarzenie poda stan połączenia. Jeśli gniazdo jest już połączone, najpierw zostanie zamknięte istniejące połączenie.

Parametry

Usuwa wszystkie dane zgromadzone w buforze wyjściowym gniazda.

W niektórych systemach operacyjnych metoda flush() jest wywoływana automatycznie między ramkami wykonania. W innych systemach operacyjnych, takich jak Windows, dane są wysyłane tylko po jawnym wywołaniu metody flush(). Sprawdzonym sposobem zapewnienia, że aplikacja zachowuje się niezawodnie we wszystkich systemach operacyjnych, jest wywołanie metody flush() po zapisaniu do gniazda każdego komunikatu (lub powiązanej grupy danych).

Czyta z soketu wartość typu Boolean. Po odczytaniu pojedynczego bajtu metoda zwraca wartość true, jeśli bajt jest wartością niezerową, w innym wypadku wartośćfalse.

Czyta z gniazda bajt ze znakiem.

Pozwala odczytać z gniazda liczbę bajtów danych określoną przez parametr length. Bajty zczytywane są do określonej tablicy bajtów, rozpoczynając od pozycji wskazywanej przez parametr offset.

Parametry

Czyta z gniazda liczbę zmiennoprzecinkową o podwójnej precyzji (wg normy IEEE 754).

Czyta z gniazda liczbę zmiennoprzecinkową o pojedynczej precyzji (IEEE 754).

Czyta z gniazda 32-bitową liczbę całkowitą ze znakiem.

Czyta wielobajtowy ciąg ze strumienia bajtów, przy użyciu określonego zestawu znaków.

Parametry

Czyta z gniazda obiekt zakodowany w formacie AMF.

Powiązane elementy interfejsu API

Czyta z gniazda 16-bitową liczbę całkowitą ze znakiem.

Czyta z gniazda bajt bez znaku.

Czyta z gniazda 32-bitową liczbę całkowitą bez znaku.

Czyta z gniazda 16-bitową liczbę całkowitą bez znaku.

Czyta z gniazda ciąg znaków UTF-8. Zakłada się, że ciąg jest poprzedzony prefiksem w postaci liczby całkowitej typu short bez znaku, która określa długość ciągu w bajtach.

Pozwala odczytać bajty danych zapisanych systemem UTF-8 określonych w parametrze length gniazda i zwraca ciąg znaków.

Parametry

Zapisuje wartość typu Boolean w sokecie. Ta metoda zapisuje pojedynczy bajt o wartości 1 (wartość true) lub 0 (wartość false).

Parametry

Powiązane elementy interfejsu API

Zapisuje bajt w gnieździe.

Parametry

Powiązane elementy interfejsu API

Zapisuje sekwencję bajtów z określonej tablicy bajtów. Operacja write·rozpoczyna się na pozycji określonej parametrem offset.

Jeśli pominięty zostanie parametr length, jego domyślna wartość 0 spowoduje, że metoda zapisze cały bufor rozpoczynając od pozycji określonej parametrem offset.

Jeśli zostanie również pominięty parametr offset, zostanie zapisany cały bufor.

Parametry

Powiązane elementy interfejsu API

Zapisuje w gnieździe liczbę zmiennoprzecinkową o podwójnej precyzji (wg normy IEEE 754).

Parametry

Powiązane elementy interfejsu API

Zapisuje w gnieździe liczbę zmiennoprzecinkową o pojedynczej precyzji (IEEE 754).

Parametry

Powiązane elementy interfejsu API

Zapisuje w gnieździe 32-bitową liczbę całkowitą ze znakiem.

Parametry

Powiązane elementy interfejsu API

Zapisuje wielobajtowy ciąg ze strumienia bajtów, używając określonego zestawu znaków.

Parametry

Powiązane elementy interfejsu API

Zapisuje w gnieździe obiekt w formacie serializowanym AMF.

Parametry

Powiązane elementy interfejsu API

Zapisuje w gnieździe 16-bitową liczbę całkowitą. Bajty zapisywane są następujący sposób:

(v >> 8) & 0xff v & 0xff

Używanych jest 16 najmniej znaczących bitów parametru; bardziej znaczące 16 bitów jest ignorowane.

Parametry

Powiązane elementy interfejsu API

Zapisuje w gnieździe 32-bitową liczbę całkowitą bez znaku.

Parametry

Powiązane elementy interfejsu API

Zapisuje w gnieździe następujące dane: 16-bitowa liczba całkowita bez znaku, która określa długość podanego ciągu UTF-8 (w bajtach), a po niej sam ciąg.

Przed zapisaniem ciągu metoda oblicza liczbę bajtów potrzebnych do przedstawienia wszystkich znaków ciągu.

Parametry

Powiązane elementy interfejsu API

Zapisuje w gnieździe ciąg UTF.

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 metodySocket.close().

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

Wywoływane po nawiązaniu połączenia sieciowego.

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

Wywoływane, gdy wystąpi błąd wejścia lub wyjścia skutkujący niepowodzeniem operacji wysyłania lub wczytywania.

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

Wywoływane, gdy gniazdo przenosi dane z bufora zapisu do warstwy transportu sieci.

Wywoływane, jeśli wywołanie metody Socket.connect() skutkuje próbą połączenia z serwerem zabronionym przez obszar izolowany lub portem o numerze mniejszym niż 1024 i nie istnieje plik zasad gniazd zezwalający na połączenie.

Uwaga: W aplikacji AIR zawartość działająca w obszarze izolowanym aplikacji może łączyć się bez pliku zasad gniazd z dowolnym serwerem i z portem o dowolnym numerze.

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

Powiązane elementy interfejsu API

Wywoływane, gdy gniazdo odbiera dane.

Dane odebrane przez gniazdo pozostają w gnieździe, aż zostaną odczytane. Metoda obsługi tego zdarzenia nie musi odczytać wszystkich dostępnych danych.

Zdarzenia typu socketData nie używają właściwości ProgressEvent.bytesTotal.

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

1. Konstruktor tworzy instancję CustomSocket o nazwie socket i przekazuje nazwę hostalocalhost numer portu 80 jako argumenty. Ponieważ klasa CustomSocket rozszerza klasę Socket, wywołanie metody super() powoduje wywołanie konstruktora klasy Socket.
2. W przykładzie wywoływana jest następnie metoda configureListeners(), która dodaje detektory dla zdarzeń Socket.
3. Na końcu wywoływana jest metoda connect() gniazda z wartością localhost jako nazwą hosta i numerem portu 80.

Uwaga: aby uruchomić przykład, potrzebny jest serwer działający w tej samej domenie, w której znajduje się plik SWF (w przykładzie localhost), i wykrywający zdarzenia na porcie numer 80.

package {
    import flash.display.Sprite;

    public class SocketExample extends Sprite {
        private var socket:CustomSocket;
        
        public function SocketExample() {
            socket = new CustomSocket("localhost", 80);
        }
    }
}

import flash.errors.*;
import flash.events.*;
import flash.net.Socket;

class CustomSocket extends Socket {
    private var response:String;

    public function CustomSocket(host:String = null, port:uint = 0) {
        super();
        configureListeners();
        if (host && port)  {
            super.connect(host, port);
        }
    }

    private function configureListeners():void {
        addEventListener(Event.CLOSE, closeHandler);
        addEventListener(Event.CONNECT, connectHandler);
        addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
        addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        addEventListener(ProgressEvent.SOCKET_DATA, socketDataHandler);
    }

    private function writeln(str:String):void {
        str += "\n";
        try {
            writeUTFBytes(str);
        }
        catch(e:IOError) {
            trace(e);
        }
    }

    private function sendRequest():void {
        trace("sendRequest");
        response = "";
        writeln("GET /");
        flush();
    }

    private function readResponse():void {
        var str:String = readUTFBytes(bytesAvailable);
        response += str;
    }

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

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

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

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

    private function socketDataHandler(event:ProgressEvent):void {
        trace("socketDataHandler: " + event);
        readResponse();
    }
}