입력 버퍼로 읽어낼 수가 있는 데이터의 바이트수를 돌려줍니다. read Methods를 사용하기 전에, 코드로 bytesAvailable property를 호출해, 읽어내는 데이터가 충분히 있는 것을 확인합니다.

이 URLStream object가 현재, 접속되고 있는지 어떤지를 나타냅니다. 이 property의 호출에 의해, URLStream object가 접속되고 있는 경우는 true 의 값을, 그 이외의 경우는 false 의 값을 돌려줍니다.

데이터의 바이트 순서를 나타냅니다. 지정할 수 있는 값은 BIG_ENDIAN 또는 LITTLE_ENDIAN 입니다.

디폴트치Endian.BIG_ENDIAN.

See also

object의 기입해 또는 읽어내 때에 사용되는 Action Message Format (AMF)의 버젼을 제어합니다.

See also

곧바로 스트림(Stream)을 닫아 다운로드 처리를 캔슬합니다. close() Methods의 호출 후는, 스트림(Stream)로부터 데이터를 읽어들이지 않습니다.

request Parameters로 지정된 URL 에서의 다운로드를 개시합니다.

메모 :로드안의 파일에 ASCII 캐릭터 이외의 캐릭터 (영어 이외가 많은 언어에 존재한다)가 포함되어 있는 경우는, ASCII 와 같은 비 Unicode 형식은 아니고 UTF-8 또는 UTF-16 인코딩 형식에서 파일을 보존하는 것을 추천합니다.

로드 처리가 곧바로 실패하면, 에러에 대해 설명하는 IOError 또는 SecurityError (로컬 파일의 시큐러티 에러를 포함한다) 예외가 슬로우 됩니다. 그 외에, URL 다운로드로 다운로드가 정상적으로 개시했을 경우는 open 이벤트가 dispatch되어 에러가 발생했을 경우는 에러 이벤트가 dispatch됩니다.

이 Methods를 사용할 때는, Adobe^® Flash^® Player 시큐러티 모델을 고려해 주세요.

• 호출원 SWF 파일이 로컬 파일 시스템의 샌드 박스에 있어, 타겟 리소스가 네트워크상의 샌드 박스에 있는 경우, 데이터를 로드할 수 없습니다.
• 호출원 SWF 파일이 네트워크상의 샌드 박스에 있어, 타겟 리소스가 로컬에 있는 경우, 데이터를 로드할 수 없습니다.
• 디폴트로, 로드하는 URL 는 호출해 원의 SWF 파일과 같은 도메인에 놓여져 있을 필요가 있습니다. 예를 들어 www.adobe.com 에 놓여져 있는 SWF 파일은, www.adobe.com 에 놓여져 있는 소스로부터로만 데이터를 로드할 수 있습니다. 다른 도메인으로부터 데이터를 로드하는 경우는, SWF 파일의 호스트로서 동작하는 서버에 크로스 도메인 policy 파일을 놓아둘 필요가 있습니다.

상세한 것에 대하여는, 다음의 주제를 참조해 주세요.

• 「ActionScript 3.0 의 프로그래밍」의시큐러티의 장과 LiveDocs 의 최신 코멘트
• Flash Player 9 시큐러티에 관한 화이트 페이퍼

스트림(Stream)로부터 불리언 값을 읽어냅니다. 1 바이트가 읽어내져 바이트가 제로 이외의 경우는 true, 그 이외의 경우는 false 가 돌려주어집니다.

스트림(Stream)로부터 부호 첨부 바이트를 읽어냅니다.

돌려주어지는 값은 -128 ~ 127 의 범위입니다.

스트림(Stream)로부터 length 바이트의 데이터를 읽어냅니다. 이 바이트는,bytes 로 지정한 ByteArray object에 읽혀offset 바이트로부터 개시해 ByteArray object까지됩니다.

스트림(Stream)로부터 IEEE 754 배 정밀도 부동 소수점수(실수)를 읽어냅니다.

바이트 스트림(Byte Stream)로부터 IEEE 754 단정밀도 부동 소수점수(실수)를 읽어냅니다.

스트림(Stream)로부터 부호 첨부 32 비트 정수를 읽어냅니다.

돌려주어지는 값은 -2147483648 ~ 2147483647 의 범위입니다.

지정한 캐릭터 세트를 사용해, 바이트 스트림(Byte Stream)로부터 지정한 길이의 멀티 byte string를 읽어냅니다.

소켓으로부터 Action Message Format (AMF) 형식에서 encode 된 object를 읽어냅니다.

See also

스트림(Stream)로부터 부호 첨부 16 비트 정수를 읽어냅니다.

돌려주어지는 값은 -32768 ~ 32767 의 범위입니다.

스트림(Stream)로부터 부호 없음 바이트를 읽어냅니다.

돌려주어지는 값은 0 ~ 255 의 범위입니다.

스트림(Stream)로부터 부호 없음 32 비트 정수를 읽어냅니다.

돌려주어지는 값은 0 ~ 4294967295 의 범위입니다.

스트림(Stream)로부터 부호 없음 16 비트 정수를 읽어냅니다.

돌려주어지는 값은 0 ~ 65535 의 범위입니다.

스트림(Stream)로부터 UTF-8 string를 읽어냅니다. 이 string에는, 바이트 단위로 길이를 나타내는 부호 없음 short 가 접두사로서 붙는 것이 전제가 되고 있습니다.

스트림(Stream)로부터 length 의 UTF-8 바이트를 읽어내, string를 돌려줍니다.

데이터가 정상적으로 로드 되었을 때에 dispatch됩니다.

complete event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

URLStream.load() 를 호출해 HTTP 를 개입시켜 데이터에 액세스를 시도해 현재의 Flash Player 로 요구의 스테이터스 코드를 검출해 돌려줄 수가 있는 경우에 dispatch됩니다. (일부의 브라우저 환경에서는 이 정보를 제공할 수 없습니다). httpStatus 가 존재하는 경우는,complete 또는 error 이벤트의 전에 송신됩니다.

httpStatus event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

See also

입출력 에러가 발생해 로드 조작이 실패했을 때에 dispatch됩니다.

ioError event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

See also

로드 조작이 개시했을 때에 dispatch됩니다.

open event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

See also

다운로드 처리를 실행중에 데이터를 수신했을 때에 dispatch됩니다. 받은 데이터는, URLStream 클래스의 Methods를 사용하자 마자 읽어낼 수가 있습니다.

progress event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

See also

URLStream.load() 의 호출에 의해 시큐러티 샌드 박스의 외부에 있는 서버로부터 데이터를 로드하려고 하면 dispatch됩니다.

SecurityErrorEvent.SECURITY_ERROR 정수는,securityError event object의 type property치를 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

See also

예를 실행하기 위해서, 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);
        }
    }
}