flash.net.URLRequest (Flex™ 2 레퍼런스 가이드)

	property	정의
		constructor : Object 특정의 object 인스턴스의 클래스 object 또는 constructor　　 함수에의 참조입니다.	Object
		contentType : String 임의의 `POST` 데이터의 MIME 컨텐츠 타입입니다.	URLRequest
		data : Object URL 리퀘스트로 송신되는 데이터를 포함한 object입니다.	URLRequest
		method : String HTTP 폼 송신 Methods가 `GET` 또는 `POST` 의 어느 쪽의 조작인지를 제어합니다.	URLRequest
		prototype : Object [static] 클래스 또는 함수 object의 prototype object에의 참조입니다.	Object
		requestHeaders : Array HTTP 리퀘스트 헤더의 배열이 HTTP 리퀘스트에 추가됩니다.	URLRequest
		url : String 리퀘스트 되는 URL 입니다.	URLRequest

	Methods	정의
		URLRequest (url:String = null) URLRequest object를 작성합니다.	URLRequest
		hasOwnProperty (name:String ):Boolean object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.	Object
		isPrototypeOf (theClass:Object ):Boolean Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.	Object
		propertyIsEnumerable (name:String ):Boolean 지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.	Object
		setPropertyIsEnumerable (name:String , isEnum:Boolean = true):void 루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.	Object
		toString ():String 지정된 object의 string 표현을 돌려줍니다.	Object
		valueOf ():Object 지정된 object의 원시적치를 돌려줍니다.	Object

property의 상세

contentType

property

contentType:String [read-write]

임의의 POST 데이터의 MIME 컨텐츠 타입입니다.

메모 : FileReference.upload() Methods 및 FileReference.download() Methods에서는 URLRequest.contentType Parameters를 지원(support)하고 있습니다.

Implements
public function get contentType():String
public function set contentType(value:String ):void

data

property

data:Object [read-write]

URL 리퀘스트로 송신되는 데이터를 포함한 object입니다.

이 property는 method property와 함께 사용합니다. URLRequest.method 의 값이 POST 의 경우, 데이터는 HTTP POST Methods로 URLRequest object에 의해 전송 됩니다.

URLRequest.method 의 값이 GET 의 경우, 데이터는 HTTP GET Methods로 URLRequest object에 의해 송신되는 변수를 정의합니다.

URLRequest API 는, string 이외에, 바이너리 POST 와 URL encode 변수도 지원(support)합니다. 데이터 object형에는, ByteArray, URLVariables, 또는 String 를 지정할 수 있습니다.

데이터가 사용되는 방법은, 사용되는 object의 형태에 따라서 다릅니다.

object가 ByteArray object의 경우, ByteArray object의 바이너리 데이터는 POST 데이터로서 사용됩니다. GET 의 경우, ByteArray 형의 데이터는 지원(support)되지 않습니다. 게다가FileReference.upload() 및 FileReference.download() 로 ByteArray 형의 데이터는 지원(support)되지 않습니다.
object가 URLVariables object로, Methods가 POST 의 경우, 변수는 x-www-form-urlencoded 형식을 사용해 encode 되어 결과의 string가 POST 데이터로서 사용됩니다. 예외는 FileReference.upload() 의 호출입니다. 이 경우, 변수는,multipart/form-data 포스트의 개별의 필드로서 송신됩니다.
object가 URLVariables object로, Methods가 GET 의 경우, URLVariables object는 URLRequest object에 의해 송신되는 변수를 정의합니다.
그 이외의 경우, object는 string에 변환되어 그 string가 POST 또는 GET 데이터로서 사용됩니다.

이 데이터는,navigateToURL() 나 FileReference.upload() 등의 Methods로 URLRequest object가 사용될 때까지 송신되지 않습니다.

Implements
public function get data():Object
public function set data(value:Object ):void

Example
다음의 예에서는, 새로운 윈도우로 http://www. [yourDomain]. com/application.jsp 로 호스트 되는 리모트 어플리케이션을 열어, URLVariables object로 포착한 유저 세션에 관한 데이터를 어플리케이션에 건네줍니다.

이 예의 하이라이트는, 다음과 같습니다.

constructor　　 함수는 request 라는 이름의, 리모트 어플리케이션의 URL 를 Parameters로서 취하는 URLRequest 인스턴스를 작성합니다.
URLVariables object가 작성되어 그 2 개의 property에 값을 할당할 수 있습니다.
URLVariables object가 URLRequest object의data property에 할당할 수 있습니다.
이 예에서는,navigateToURL 를 호출해, 새로운 브라우저 윈도우를 열어, 리모트 어플리케이션의 URL 에 접속합니다.

메모: 이 예를 실행하려면 , 이 예의 리모트 어플리케이션의 URL 를 실제의 URL 에 옮겨놓을 필요가 있습니다. 게다가 URLVariables object의 Flash Player 로 포착한 정보를 처리하기 위한 서버 코드가 필요합니다.

package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLVariables;

    public class URLVariablesExample extends Sprite {

        public function URLVariablesExample() {
            var url:String = "http://www. [yourDomain]. com/application.jsp";
            var request:URLRequest = new URLRequest(url);
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date(). getTime();
            variables.exampleUserLabel = "guest";
            request.data = variables;
            navigateToURL(request);
        }
    }
}

method

property

method:String [read-write]

HTTP 폼 송신 Methods가 GET 또는 POST 의 어느 쪽의 조작인지를 제어합니다. 유효한 값은,URLRequestMethod.GET 또는 URLRequestMethod.POST 입니다.

디폴트치URLRequestMethod.GET.

Implements
public function get method():String
public function set method(value:String ):void

Throws

ArgumentError — value Parameters가 URLRequestMethod.GET 도 URLRequestMethod.POST 도 아닌 경우.

See also

URLRequestMethod class
외부 데이터의 조작

Example
다음의 예에서는, 새로운 윈도우로 http://www. [yourDomain]. com/application.jsp 로 호스트 되는 리모트 어플리케이션을 열어, URLVariables object로 포착한 유저 세션에 관한 데이터를 어플리케이션에 건네줍니다. URLRequest.method property의 값을, 다음과 같이 명시적으로 설정합니다. URLRequestMethod.POST.

이 예의 하이라이트는, 다음과 같습니다.

constructor　　 함수는 request 라는 이름의, 리모트 어플리케이션의 URL 를 Parameters로서 취하는 URLRequest 인스턴스를 작성합니다.
URLVariables object가 작성되어 그 2 개의 property에 값을 할당할 수 있습니다.
URLVariables object가 URLRequest object의data property에 할당할 수 있습니다.
URLRequest.method property의 값이, 다음과 같이 설정됩니다. URLRequestMethod.POST.
이 예에서는,navigateToURL 를 호출해, 새로운 브라우저 윈도우를 열어, 리모트 어플리케이션의 URL 에 접속합니다.

package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLRequestMethod;
    import flash.net.URLVariables;

    public class URLRequest_method extends Sprite {

        public function URLRequest_method() {
            var url:String = "http://www. [yourDomain]. com/application.jsp";
            var request:URLRequest = new URLRequest(url);
            
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date(). getTime();
            variables.exampleUserLabel = "guest";
            request.data = variables;
            request.method = URLRequestMethod.POST;
            
            navigateToURL(request);
        }
    }
}

requestHeaders

property

requestHeaders:Array [read-write]

HTTP 리퀘스트 헤더의 배열이 HTTP 리퀘스트에 추가됩니다. 배열은 URLRequestHeader object로부터 구성됩니다. 배열의 각 object는, 다음과 같이 이름 string와 값string를 포함한 URLRequestHeader object일 필요가 있습니다.

  var rhArray:Array = new Array(new URLRequestHeader("Content-Type", "text/html"));

Flash Player 에서는 리퀘스트 헤더에 대해서 일정한 제한이 설정되어 있습니다. 상세한 것에 대하여는, URLRequestHeader 클래스의 설명을 참조해 주세요.

FileReference.upload() 및 FileReference.download() Methods는 URLRequest.requestHeaders Parameters를 지원(support)하고 있습니다.

Implements
public function get requestHeaders():Array
public function set requestHeaders(value:Array ):void

See also

URLRequestHeader

url

property

url:String [read-write]

리퀘스트 되는 URL 입니다. 디폴트로, URL 는 서브 도메인을 포함해 호출원의 SWF 파일과 같은 도메인에 놓여져 있을 필요가 있습니다. 예를 들어, www.adobe.com 와 store.adobe.com 에 있는 SWF 파일은 다른 도메인에 있습니다. 다른 도메인으로부터 데이터를 로드하려면 , SWF 파일을 호스트 하는 서버에 크로스 도메인 policy 파일을 배치합니다. 상세한 것에 대하여는, URLRequest 클래스의 설명의 시큐러티에 관한 설명을 참조해 주세요.

Implements
public function get url():String
public function set url(value:String ):void

constructor　　 의 상세

URLRequest

()

constructor　　

public 함수 URLRequest(url:String = null)

URLRequest object를 작성합니다. System.useCodePage 가 true 의 경우, 리퀘스트는 Unicode 는 아니고, 시스템의 code page를 사용해 encode 됩니다. System.useCodePage 가 false 의 경우, 리퀘스트는 시스템의 code page는 아니고, Unicode 를 사용해 encode 됩니다.

Parameters

url:String (default = null) — 리퀘스트 되는 URL 입니다. url property를 사용해, URL 를 나중에 설정할 수 있습니다.

See also

flash.system.System.useCodePage

Examples

다음의 예에서는, 새로운 Loader object를 작성해, 거기에 XML 파일에의 패스를 포함한 URLRequest object를 건네줍니다. 로드 처리가 성공했을 경우,complete 이벤트가 dispatch되어 XML 파일내의 데이터가 출력됩니다. 추가의 event 핸들러는 에러 이벤트를 포함한 다른 이벤트를 capther 합니다.

이 예를 실행하려면 , XMLFile.xml 라고 하는 파일을 SWF 파일과 같은 디렉토리에 배치합니다.


package {
    import flash.display.Sprite;
    import flash.events. *;
    import flash.net. *;

    public class URLRequestExample extends Sprite {

        public function URLRequestExample() {
            var loader:URLLoader = new URLLoader();
            configureListeners(loader);

            var request:URLRequest = new URLRequest("XMLFile.xml");
            try {
                loader.load(request);
            } catch (error:Error) {
                trace("Unable to load requested document. ");
            }
        }

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

        private function completeHandler(event:Event) :void {
            var loader:URLLoader = URLLoader(event.target);
            trace("completeHandler: " + loader.data);
        }

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

        private function progressHandler(event:ProgressEvent) :void {
            trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal);
        }

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

Adobe® Flex™ 2 Language Reference		모든 패키지 \| 모든 클래스 \| 언어 엘리먼트 \| 색인 \| 부록 \| 규칙 \| 프레임내에 표시 프레임 없음 버젼
Class URLRequest	property \| Methods \| 예

Package	flash.net
Class	public final class URLRequest
Inheritance	URLRequest Object