Socket  - AS3

입력 버퍼에서 읽을 수 있는 데이터 바이트 수입니다.

read 메서드 중 하나를 사용하여 읽기를 시도하기 전에 충분한 데이터가 있는지 확인하기 위해 코드에서 bytesAvailable에 액세스해야 합니다.

쓰기 버퍼에 남아 있는 바이트 수를 나타냅니다.

이 속성은 OutputProgressEvent와 결합하여 사용합니다. OutputProgressEvent는 쓰기 버퍼에서 네트워크로 데이터가 씌어질 때마다 발생합니다. 이벤트 처리기에서 bytesPending을 선택하면 버퍼에서 쓰기 작업을 대기하느라 남아 있는 데이터 양을 확인할 수 있습니다. bytesPending에서 0을 반환하면 모든 데이터가 쓰기 버퍼에서 네트워크에 전송된 것이며, 이 경우 이벤트 핸들러 제거, 소켓 참조 null 설정, 대기열 내 다음 업로드 시작 등의 작업을 안전하게 실행할 수 있습니다.

관련 API 요소

이 소켓 객체가 현재 연결되어 있는지 여부를 나타냅니다. 현재 소켓이 연결된 경우, 이 속성을 호출하면 true 값이 반환됩니다. 그렇지 않으면 false가 반환됩니다.

데이터의 바이트 순서를 나타냅니다. flash.utils.Endian 클래스의 Endian.BIG_ENDIAN 또는 Endian.LITTLE_ENDIAN 상수 값이 가능합니다.

기본값: Endian.BIG_ENDIAN.

관련 API 요소

로컬 컴퓨터에서 이 소켓이 바인딩된 IP 주소입니다.

관련 API 요소

로컬 컴퓨터에서 이 소켓이 바인딩된 포트입니다.

관련 API 요소

객체를 쓰거나 읽을 때 사용되는 AMF 버전을 제어합니다.

관련 API 요소

이 소켓을 연결할 원격 컴퓨터의 IP 주소입니다.

이 속성을 사용하여 ServerSocketConnectEvent에서 ServerSocket 객체에 의해 전달된 클라이언트 소켓의 IP 주소를 결정할 수 있습니다. 필요한 경우 DNSResolver 클래스를 사용하여 IP 주소를 도메인 이름으로 변환합니다.

관련 API 요소

이 소켓을 연결할 원격 컴퓨터의 포트입니다.

이 속성을 사용하여 ServerSocketConnectEvent에서 ServerSocket 객체에 의해 전달된 클라이언트 소켓의 포트 번호를 결정할 수 있습니다.

관련 API 요소

연결을 기다릴 시간(밀리초)를 나타냅니다.

지정된 시간 내에 연결되지 않으면 연결에 실패합니다. 기본값은 20,000(20초)입니다.

새 Socket 객체를 만듭니다. 매개 변수가 지정되지 않은 경우 처음에는 연결 해제된 소켓이 만들어집니다. 매개 변수가 지정되면 지정된 호스트 및 포트와의 연결이 시도됩니다.

참고: 생성자의 매개 변수가 없는 형태를 사용한 다음 이벤트 리스너를 추가하고 connect 메서드(host 및 port 매개 변수 사용)를 호출하는 것이 좋습니다. 이 순서대로 하면 모든 이벤트 리스너가 정상적으로 작동합니다.

소켓을 닫습니다. close() 메서드가 호출된 후에는 데이터를 읽거나 쓸 수 없습니다.

close 이벤트는 서버가 연결을 종료할 때만 전달됩니다. close() 메서드를 호출할 때는 전달되지 않습니다.

Socket 객체에 대해 connect() 메서드를 호출하여 이 객체를 다시 사용할 수 있습니다.

소켓을 지정된 호스트 및 포트에 연결합니다.

연결에 바로 실패하면 이벤트가 전달되거나 예외가 발생합니다. 호스트가 지정된 경우 오류 이벤트가 전달되고, 지정된 호스트가 없으면 예외가 발생합니다. 그렇지 않으면 이벤트에서 연결 상태를 보고합니다. 소켓이 이미 연결된 경우 기존 연결이 먼저 종료됩니다.

매개 변수

소켓의 출력 버퍼에 축적된 데이터를 모두 플러시합니다.

실행 프레임 사이에 flush()가 자동으로 호출되는 운영 체제도 있고, 명시적으로 flush()를 호출해야만 데이터를 전송하는 운영 체제(예: Windows)도 있습니다. 응용 프로그램이 운영 체제에 상관없이 안정적으로 동작하려면 소켓에 각 메시지(또는 관련 데이터 그룹)를 작성한 후 flush() 메서드를 호출하는 것이 좋습니다.

소켓에서 부울 값을 읽습니다. 메서드는 단일 바이트를 읽은 후 바이트가 0이 아니면 true를 반환하고 그렇지 않으면 false를 반환합니다.

소켓에서 부호 있는 바이트를 읽습니다.

소켓에서 length 매개 변수로 지정된 만큼의 데이터 바이트를 읽습니다. offset에서 표시하는 위치부터 시작하여 지정된 바이트 배열로 바이트를 읽어들입니다.

매개 변수

소켓에서 IEEE 754 배정밀도 부동 소수점 숫자를 읽습니다.

소켓에서 IEEE 754 단정밀도 부동 소수점 숫자를 읽습니다.

소켓에서 부호 있는 32비트 정수를 읽습니다.

지정된 문자 세트를 사용하여 바이트 스트림에서 멀티바이트 문자열을 읽습니다.

매개 변수

소켓에서 AMF 직렬 형식으로 인코딩된 객체를 읽습니다.

관련 API 요소

소켓에서 부호 있는 16비트 정수를 읽습니다.

소켓에서 부호 없는 바이트를 읽습니다.

소켓에서 부호 없는 32비트 정수를 읽습니다.

소켓에서 부호 없는 16비트 정수를 읽습니다.

소켓에서 UTF-8 문자열을 읽습니다. 문자열 앞에는 길이를 바이트 단위로 나타낸 부호 없는 짧은 정수가 붙는 것으로 취급합니다.

소켓에서 length 매개 변수로 지정된 만큼의 UTF-8 데이터 바이트를 읽고 문자열을 반환합니다.

매개 변수

소켓에 부울 값을 씁니다. 이 메서드는 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. 생성자는 socket이라는 CustomSocket 인스턴스를 만들고 호스트 이름 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();
    }
}