XMLSocket  - AS3

이 XMLSocket 객체가 현재 연결되어 있는지 여부를 나타냅니다. 또한 connect 이벤트 및 ioError 이벤트에 등록하여 연결 성공 여부를 확인할 수 있습니다.

관련 API 요소

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

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

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

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

관련 API 요소

XMLSocket 객체에 의해 지정된 연결을 종료합니다. close 이벤트는 서버가 연결을 종료할 때만 전달됩니다. close() 메서드를 호출할 때는 전달되지 않습니다.

관련 API 요소

지정된 TCP 포트를 사용하여 지정된 인터넷 호스트에 연결합니다.

host 매개 변수에 대해 null을 지정하면 연결된 호스트는 XMLSocket.connect()를 호출하는 파일이 있는 호스트입니다. 예를 들어 www.adobe.com에서 파일을 다운로드한 경우 host 매개 변수에 null을 지정하면 www.adobe.com에 연결하게 됩니다.

SWF 내용이 들어 있는 HTML 페이지에서 allowNetworking 매개 변수(object 및 embed 태그)를 설정하여 SWF 파일에서 이 메서드를 사용하지 않게 할 수 있습니다.

자세한 내용은 Flash Player 개발자 센터 항목(보안)을 참조하십시오.

매개 변수

관련 API 요소

object 매개 변수에 지정된 XML 객체 또는 데이터를 문자열로 변환하여 서버로 전송하고, 끝에 0바이트를 붙입니다. object가 XML 객체인 경우 문자열은 XML 객체의 XML 텍스트 표현입니다. 보내기 작업은 비동기적입니다. 따라서 즉시 반환하지만 데이터는 나중에 전송될 수 있습니다. XMLSocket.send() 메서드는 데이터가 성공적으로 전송되었는지 여부를 나타내는 값을 반환하지 않습니다.

XMLSocket.connect()를 사용하여 XMLSocket 객체를 서버에 연결하지 않는 경우, XMLSocket.send() 작업에 실패합니다.

매개 변수

관련 API 요소

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

이 이벤트에는 다음과 같은 속성이 있습니다.

XMLSocket.connect() 메서드에 대한 호출이 성공하면 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

원시 데이터를 전송하거나 수신한 후에 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

전송 또는 수신 작업의 실패를 유발하는 입력/출력 오류가 발생할 때 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

XMLSocket.connect() 메서드 호출로 호출자의 보안 샌드박스 외부에 있는 서버 또는 1024 미만의 포트에 대한 연결을 시도하면 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

1. XMLSocketExample 생성자는 socket이라는 이름의 XMLSocket 인스턴스를 만들고 socket을 ConfigureListeners()에 전달한 다음(아래 참조) 호스트 이름 "localhost"와 포트 번호 8080을 사용하여 XMLSocket의 connect() 메서드를 호출합니다.
2. configureListeners() 메서드가 호출되어 지원되는 각 XMLSocket 이벤트에 대해 리스너를 추가합니다.
   • closeHandler(): close 이벤트를 수신합니다. 이 이벤트는 네트워크 연결이 종료된 후 전달됩니다.
   • connectHandler(): connect 이벤트를 수신합니다. 이 이벤트는 네트워크 연결이 설정되면 전달됩니다.
   • dataHandler(): data 이벤트를 수신합니다. 이 이벤트는 XMLSocket이 새 데이터를 받을 때마다 전달됩니다.
   • progressHandler(): progress 이벤트를 수신합니다. 이 이벤트는 send()를 호출하여 전송이 진행되는 동안에 전달됩니다.
   • securityErrorHandler(): securityError 이벤트를 수신합니다. 이 이벤트는 잘못된 로컬 재생 보안 설정으로 또는 1024 미만의 포트 번호를 사용하여 XMLSocket에 액세스하려고 할 때 전달됩니다.
   • ioErrorHandler(): ioError 이벤트를 수신합니다. 이 이벤트는 데이터 전송 또는 수신 작업에 실패했을 때만 전달됩니다.

참고:

• "로컬 재생 보안"을 "네트워크에만 액세스"로 설정하여 SWF 파일을 컴파일해야 합니다.
• 이 예제가 실행되려면 도메인에서 포트 8080을 사용하여 서버가 실행 중이어야 합니다.
• Flash Player 9.0.124.0 이상을 실행하는 경우 해당 도메인에서 포트 8080으로 소켓 연결을 허용하는 소켓 정책 파일을 서버에 배치해야 합니다. 소켓 정책 파일 제공에 대한 자세한 내용은 Flash Player 개발자 센터 항목인 소켓 정책 파일 서버 설정을 참조하십시오.

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