입력 버퍼에서 읽을 수 있는 데이터 바이트 수를 반환합니다. read 메서드 중 하나를 사용하여 읽기 전에 충분한 데이터가 있는지 확인하도록 bytesAvailable 속성을 호출하는 코드를 포함해야 합니다.

이 URLStream 객체가 현재 연결된 상태인지 여부를 나타냅니다. 이 속성에 대한 호출은 URLStream 객체가 연결되어 있으면 true 값을, 그렇지 않으면 false 값을 반환합니다.

데이터의 바이트 순서를 나타내며, BIG_ENDIAN 또는 LITTLE_ENDIAN 값을 가질 수 있습니다.

기본값은 Endian.BIG_ENDIAN.

참고 사항

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

참고 사항

스트림을 즉시 닫고 다운로드 작업을 취소합니다. close() 메서드를 호출한 후에는 스트림에서 데이터를 읽을 수 없습니다.

request 매개 변수에 정의된 URL을 다운로드하기 시작합니다.

참고: 로드되는 파일에 ASCII가 아닌 문자(영어가 아닌 다른 언어에서 사용)가 포함되어 있는 경우 UTF-8 또는 UTF-16과 같은 유니코드 인코딩을 사용하여 파일을 저장하는 것이 좋습니다. ASCII는 유니코드 형식이 아닙니다.

로드 작업 시작 즉시 실패할 경우 실패를 알리는 IOError 또는 SecurityError(로컬 파일 보안 오류 포함) 예외가 발생합니다. 그렇지 않으면, URL 다운로드에서 성공적으로 다운로드를 시작한 경우 open 이벤트가 전달되거나 오류가 발생한 경우 오류 이벤트가 전달됩니다.

이 메서드를 사용할 경우 Adobe^(r) Flash^(r) Player 보안 모델을 고려할 수 있습니다.

• 호출하는 SWF 파일이 local-with-file-system 샌드박스에 있고 대상 리소스가 네트워크 샌드박스에서 가져온 것이면 데이터를 로드할 수 없습니다.
• 호출하는 SWF 파일이 네트워크 샌드박스에서 가져온 것이고 대상 리소스가 로컬 시스템에 있는 경우에도 데이터를 로드할 수 없습니다.
• 기본적으로 로드하는 URL은 호출하는 SWF 파일과 동일한 도메인에 있어야 합니다. 예를 들어, www.adobe.com에 있는 SWF 파일은 같은 도메인인 www.adobe.com에 있는 소스에서만 데이터를 로드할 수 있습니다. 다른 도메인에서 데이터를 로드하려면 해당 데이터를 호스팅하는 서버에 크로스 도메인 정책 파일을 배치합니다.
• SWF 내용을 포함하는 HTML 페이지에서 object 및 embed 태그의 allowNetworking 매개 변수를 설정하여 SWF 파일에서 이 메서드를 사용하지 못하도록 할 수 있습니다.

자세한 내용은 다음을 참조하십시오.

• 보안 장(ActionScript 3.0 프로그래밍 설명서) 및 LiveDocs의 최신 의견
• Flash Player 9 보안 백서

매개 변수

참고 사항

스트림에서 부울 값을 읽습니다. 단일 바이트를 읽고 해당 바이트가 0이 아니면 true를, 그렇지 않으면 false를 반환합니다.

스트림에서 부호 있는 바이트를 읽습니다.

반환된 값의 범위는 -128에서 127 사이입니다.

스트림에서 length 바이트의 데이터를 읽습니다. ByteArray 객체에 대한 offset 바이트에서 시작하여 bytes로 지정된 ByteArray 객체로 바이트를 읽어들입니다.

매개 변수

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

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

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

반환된 값의 범위는 -2147483648에서 2147483647 사이입니다.

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

매개 변수

소켓에서 AMF로 인코딩된 객체를 읽습니다.

참고 사항

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

반환된 값의 범위는 -32768에서 32767 사이입니다.

스트림에서 부호 없는 바이트를 읽습니다.

반환된 값의 범위는 0에서 255 사이입니다.

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

반환된 값의 범위는 0에서 4294967295 사이입니다.

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

반환된 값의 범위는 0에서 65535 사이입니다.

스트림으로부터 UTF-8 문자열을 읽습니다. 문자열 앞에는 문자열의 길이를 바이트 단위로 나타내는 unsigned short가 있어야 합니다.

스트림에서 length UTF-8 바이트 시퀀스를 읽고 문자열을 반환합니다.

매개 변수

데이터가 성공적으로 로드되면 전달됩니다.

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

URLStream.load() 호출로 HTTP를 통해 데이터 액세스를 시도하고 현재의 Flash Player에서 이 요청에 대한 상태 코드를 감지 및 반환할 수 있을 때 전달됩니다. 일부 브라우저 환경에서는 이 정보를 제공할 수 없습니다. httpStatus는 complete 또는 error 이벤트 발생 전에 추가로 전송됩니다.

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

참고 사항

로드 작업을 실패하게 만드는 입력/출력 오류가 발생할 때 전달됩니다.

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

참고 사항

로드 작업이 시작될 때 전달됩니다.

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

참고 사항

다운로드 작업이 진행되어 데이터가 수신되면 전달됩니다. 수신된 데이터는 URLStream 클래스의 메서드를 사용하여 즉시 읽을 수 있습니다.

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

참고 사항

URLStream.load() 호출로 보안 샌드박스 외부의 서버에서 데이터 로드를 시도할 때 전달됩니다.

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

참고 사항

이 예제를 실행하려면 URLStreamExample.swf라는 이름의 파일을 사용자의 SWF 파일과 동일한 디렉토리에 넣습니다.

package {
    import flash.display.Sprite;
    import flash.errors.*;
    import flash.events.*;
    import flash.net.URLRequest;
    import flash.net.URLStream;

    public class URLStreamExample extends Sprite {
        private static const ZLIB_CODE:String = "CWS";
        private var stream:URLStream;

        public function URLStreamExample() {
            stream = new URLStream();
            var request:URLRequest = new URLRequest("URLStreamExample.swf");
            configureListeners(stream);
            try {
                stream.load(request);
            } catch (error:Error) {
                trace("Unable to load requested URL.");
            }
        }

        private function configureListeners(dispatcher:EventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

        private function parseHeader():void {
            trace("parseHeader");
            trace("isCompressed: " + isCompressed());
            trace("version: " + stream.readByte());
        }

        private function isCompressed():Boolean {
            return (stream.readUTFBytes(3) == ZLIB_CODE);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
            parseHeader();
        }

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

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

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

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

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