Socket  - AS3

Число байт данных, доступных для чтения во входном буфере.

В вашем коде должен быть вызов свойства bytesAvailable, проверяющий доступность необходимого объема данных до того, как вы попытаетесь сосчитать их с помощью одного из методов read.

Указывает количество байт, оставшихся в буфере записи.

Используйте это свойство вместе с OutputProgressEvent. Событие OutputProgressEvent отправляется каждый раз при записи данных из буфера записи в сетевое местоположение. В обработчике события можно проверить bytesPending, чтобы узнать, сколько данных осталось в буфере и ожидает записи. Когда bytesPending возвращает 0, это значит, что все данные переданы из буфера записи в сетевое местоположение и теперь можно удалять обработчики событий, обнулять ссылки на сокеты, начинать следующую отправку в очереди и т.д.

Связанные элементы API

Определяет, подключен ли в настоящий момент этот объект Socket. Вызов этого свойства возвращает значение true, если сокет в настоящий момент подключен, или значение false, если не подключен.

Определяет порядок байтов данных. Возможными значениями являются константы из класса flash.utils.Endian, Endian.BIG_ENDIAN или Endian.LITTLE_ENDIAN.

Значением по умолчанию является Endian.BIG_ENDIAN.

Связанные элементы API

IP-адрес, с которым связан этот сокет, на локальном компьютере.

Связанные элементы API

Порт, с которым связан этот сокет, на локальном компьютере.

Связанные элементы API

Управляет версией AMF, применяемой при записи или чтении объекта.

Связанные элементы API

IP-адрес удаленного компьютера, к которому подключен этот сокет.

С помощью этого свойства можно определить IP-адрес клиентского сокета, отправленный объектом ServerSocket в событии ServerSocketConnectEvent. Если потребуется, используйте класс DNSResolver для преобразования IP-адреса в имя домена.

Связанные элементы API

Порт на удаленном компьютере, к которому подключен этот сокет.

С помощью этого свойства можно определить номер порта клиентского сокета, отправленный объектом ServerSocket в событии ServerSocketConnectEvent.

Связанные элементы API

Указывает время ожидания подключения в миллисекундах.

Если подключение не будет установлено в течение заданного срока, попытка завершается ошибкой. Значение по умолчанию: 20,000 (двадцать секунд).

Создает новый объект Socket. Если не указаны никакие параметры, создается первоначально отключенный сокет. Если параметры указаны, производится попытка подключиться к указанному узлу и порту.

Примечание. Настоятельно рекомендуется использовать форму конструктора без параметров, затем добавить любые прослушиватели событий, после чего вызвать метод connect с параметрами host и port. Эта последовательность гарантирует правильную работу всех приемников событий.

Закрывает сокет. После вызова метода close() вы не сможете считать или записать какие-либо данные.

Событие close отправляется только в тот момент, когда сервер закрывает соединение. Оно не отправляется при вызове метода close().

Для повторного использования объекта Socket снова вызовите для него метод connect().

Подключает сокет к заданному узлу и порту.

Мгновенный сбой подключения приводит к отправке события или созданию исключения: если узел был указан, отправляется событие ошибки, а если узел не был указан, то создается исключение. В противном случае, состояние подключения сообщается посредством события. Если сокет уже подключен, то сначала закрывается именно существующее подключение.

Параметры

Очищает любые накопленные данные в выходном буфере сокета.

В одних операционных системах метод flush() автоматически вызывается между кадрами выполнения, а в других, таких как Windows, данные никогда не отправляются, пока в коде не будет вызван метод flush(). Чтобы обеспечить надежное поведение приложения во всех операционных системах, рекомендуется вызывать метод flush() после записи каждого сообщения (или связанной группы данных) в сокет.

Считывает из сокета логическое значение. После считывания одного байта метод возвращает true, если этот байт ненулевой, в противном случае, возвращается значение false.

Считывает из сокета байт со знаком.

Считывает из сокета число байт данных, заданное параметром length. Байты считываются в указанный байтовый массив, при этом начальная позиция указывается в параметре offset.

Параметры

Считывает из сокета число IEEE 754 двойной точности с плавающей запятой.

Считывает из сокета число IEEE 754 одинарной точности с плавающей запятой.

Считывает из сокета 32-разрядное целое число со знаком.

Считывает многобайтовую строку из потока байт с использованием заданного набора знаков.

Параметры

Считывает объект из сокета, зашифрованного в сериализованный формат AMF.

Связанные элементы API

Считывает из сокета 16-разрядное целое число со знаком.

Считывает из сокета байт без знака.

Считывает из сокета 32-разрядное целое число без знака.

Считывает из сокета 16-разрядное целое число без знака.

Считывает из сокета строку UTF-8. Предполагается, что в строку вставляется префикс с неподписанным коротким целым числом, указывающим длину в байтах.

Считывает из сокета число байт данных UTF-8, заданное параметром length и возвращает строку.

Параметры

Записывает логическое значение в сокет. Данный метод записывает один байт со значением 1 (true) или 0 (false).

Параметры

Связанные элементы API

Записывает байт в сокет.

Параметры

Связанные элементы API

Записывает последовательность байт из заданного массива байт. Операция записи начинается в позиции, указанной в offset.

Если будет опущен параметр length, применение длины по умолчанию, равной 0, приведет к тому, что метод будет записывать весь буфер, начиная со смещения offset.

Если также опустить параметр offset, будет записываться весь буфер.

Параметры

Связанные элементы API

Записывает в сокет число IEEE 754 двойной точности с плавающей запятой.

Параметры

Связанные элементы API

Записывает в сокет число IEEE 754 одинарной точности с плавающей запятой.

Параметры

Связанные элементы API

Записывает в сокет 32-разрядное целое число со знаком.

Параметры

Связанные элементы API

Записывает многобайтовую строку из потока байт с использованием заданного набора знаков.

Параметры

Связанные элементы API

Записывает объект в сокет в сериализованном формате AMF.

Параметры

Связанные элементы API

Записывает в сокет 16-разрядное целое число. Записанные байты выглядят следующим образом:

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

Используются 16 младших битов параметра, а 16 старших битов игнорируются.

Параметры

Связанные элементы API

Записывает в сокет 32-разрядное целое число без знака.

Параметры

Связанные элементы API

Записывает следующие данные в сокет: 16-разрядное целое число без знака, указывающее на длину заданной строки UTF-8 в байтах, а затем саму строку.

Перед тем как записать строку, метод рассчитывает количество байтов, необходимое для представления всех символов строки.

Параметры

Связанные элементы API

Записывает строку UTF-8 в сокет.

Параметры

Связанные элементы API

Отправляется, когда сервер закрывает подключение к сокету.

Событие close отправляется только в тот момент, когда сервер закрывает соединение. Оно не отправляется при вызове метода Socket.close().

Это событие имеет следующие свойства:

Отправляется после установления сетевого подключения.

Это событие имеет следующие свойства:

Отправляется, когда происходит ошибка ввода-вывода, приводящая к сбою операции отправки или загрузки.

Это событие имеет следующие свойства:

Передается при перемещении данных сокетом из буфера записи на уровень сетевого транспорта

Отправляется, если метод Socket.connect() предпринимает попытку подключиться к серверу, который запрещен изолированной средой безопасности вызывающего приложения, или к порту с номером меньше 1024, когда нет файла политики сокетов, разрешающего такое подключение.

Примечание. В приложении AIR содержимое, выполняемое внутри изолированной среды безопасности этого приложения, получает разрешение на подключение к любому серверу и порту без даже файла политики сокетов.

Это событие имеет следующие свойства:

Связанные элементы API

Отправляется, когда сокет получает данные.

Данные, полученные сокетом, остаются в нем, пока не будут прочитаны. Необязательно считывать все доступные данные при обработке этого события.

В событиях типа socketData не используется свойство ProgressEvent.bytesTotal.

Это событие имеет следующие свойства:

1. Конструктор создает экземпляр CustomSocket с именем socket и передает в качестве аргументов имя узла localhost и порт 80. Так как CustomSocket расширяет Socket, вызов метода super() расширяет конструктор Socket.
2. Затем в примере вызывается метод configureListeners(), добавляющий прослушивателей для событий Socket.
3. В завершение, вызывается метод connect() сокета с именем узла localhost и номером порта 80.

Примечание. Для запуска данного примера вам потребуется сервер, запущенный в том же домене, где размещен SWF-файл (в данном примере: localhost), и прослушивающий порт 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();
    }
}