URLFilePromise

패키지	air.desktop
클래스	public class URLFilePromise
상속	URLFilePromise EventDispatcher Object
구현	IFilePromise

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

URLFilePromise 클래스를 사용하면 URL에서 액세스할 수 있는 리소스를 하나의 파일 프로미스로 AIR 응용 프로그램 외부로 드래그할 수 있습니다.

URLFilePromise 클래스는 URLStream 및 URLRequest 객체를 데이터 소스로 사용하여 IFilePromise 인터페이스를 구현합니다. 구현이 완료되면 HTTP나 URLStream 클래스가 지원하는 다른 프로토콜을 사용하여 검색할 수 있는 파일을 드래그 앤 드롭할 수 있습니다.

URL 파일 프로미스를 만들려면

하나 이상의 URLFilePromise 객체를 만들고 초기화합니다.
URLFilePromise 객체를 배열에 추가합니다.
ClipboardFormat, FILE_PROMISE_LIST를 사용하여 새 Clipboard 객체에 배열을 추가합니다.
사용자 동작에 대한 응답으로 NativeDragManager startDrag() 메서드를 호출하여 파일 프로미스 배열이 포함된 Clipboard 객체에 전달합니다.

사용자가 드래그 작업을 완료하면 런타임이 각 파일 프로미스의 데이터를 다운로드합니다. URLFilePromise 객체의 request 속성으로 지정된 URL에서 데이터에 액세스하여 relativePath 속성에 지정된 파일에 저장합니다. 파일은 저장 위치의 상대 경로에 저장됩니다. 따라서 상대 경로가 foo/bar.txt이고 파일 프로미스가 home이라는 디렉토리에 저장된 경우 파일 위치는 home/foo/bar.txt가 됩니다. 오류가 발생할 경우 파일은 만들어지지 않습니다.

URLStream 클래스를 통해 액세스할 수 없는 데이터 소스를 지원하려면 IFilePromise 인터페이스를 구현합니다.

참고: AIR 런타임은 IFilePromise 메서드, open(), close(), reportError()를 자동으로 호출합니다. 이러한 메서드는 응용 프로그램 논리에서 호출하지 않아야 합니다. 마찬가지로 이 URLFilePromise 객체가 전달한 open, progress, complete, close 이벤트가 기본적으로 디버깅 목적으로 제공됩니다. 응용 프로그램이 이러한 이벤트에 응답할 필요는 없습니다.

이 클래스는 aircore.swc 파일에 포함되어 있습니다. Adobe^® Flash^™ Builder에서는 Adobe^® AIR^™ 프로젝트를 만들 때 이 클래스를 자동으로 로드합니다. 또한 Adobe^® Flex^™ SDK에는 Flex SDK를 사용하는 경우 응용 프로그램을 컴파일할 때 포함시켜야 하는 aircore.swc 파일이 포함되어 있습니다.

Adobe^® Flash^® Professional(CS4 이상)에서 air.desktop 패키지를 사용하려면

[파일] > [제작 설정] 명령을 선택합니다.
Flash 패널에서 ActionScript 3.0의 [설정] 버튼을 클릭합니다. [라이브러리 경로]를 선택합니다.
[SWC 파일 찾아보기] 버튼을 클릭합니다. Adobe Flash Professional 설치 폴더에서 Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc 파일을 찾아봅니다.
[확인] 버튼을 클릭합니다.
ActionScript 3.0 코드에 다음 import 문을 추가합니다. import air.desktop.*;

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		isAsync : Boolean [읽기 전용] 리소스 데이터를 비동기적으로 사용할 수 있는지 여부를 나타냅니다.	URLFilePromise
		relativePath : String 만들어진 파일의 경로 및 파일 이름입니다(드롭 대상 기준).	URLFilePromise
		request : URLRequest 드래그 앤 드롭 작업의 결과로 복사할 리소스를 식별하는 URLRequest입니다.	URLFilePromise

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		URLFilePromise() URLFilePromise 객체를 만듭니다.	URLFilePromise
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.	EventDispatcher
		close():void AIR 런타임이 드래그 앤 드롭 작업 중 적절한 시기에 데이터 소스를 닫을 수 있도록 허용합니다.	URLFilePromise
		dispatchEvent(event:Event):Boolean 이벤트를 이벤트 흐름으로 전달합니다.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		open():IDataInput AIR 런타임이 드래그 앤 드롭 작업 중 적절한 시기에 데이터 소스를 열 수 있도록 허용합니다.	URLFilePromise
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher 객체에서 리스너를 제거합니다.	EventDispatcher
		reportError(e:ErrorEvent):void AIR 런타임이 드래그 앤 드롭 작업 중 발생하는 오류를 보고할 수 있도록 허용합니다.	URLFilePromise
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object
		willTrigger(type:String):Boolean 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher

이벤트

이벤트에 대한 자세한 내용을 보려면 클릭하십시오.

상속되는 이벤트 숨기기

상속되는 이벤트 표시

	요약	정의 주체
activate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.	EventDispatcher
complete	파일에 대한 데이터가 완전히 다운로드되었을 때 전달됩니다.	URLFilePromise
deactivate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.	EventDispatcher
httpResponseStatus	응답 헤더를 보고하기 위해 HTTP 요청에 대해 전달됩니다.	URLFilePromise
httpStatus	요청 상태 코드를 보고하기 위해 HTTP 요청에 대해 전달됩니다.	URLFilePromise
ioError	IOError로 인해 파일이 다운로드되지 않을 때 전달됩니다.	URLFilePromise
open	기본 URLStream 연결이 열릴 때 전달됩니다.	URLFilePromise
progress	기본 URLStream에서 데이터 블록을 읽을 수 있을 때 전달됩니다.	URLFilePromise
securityError	보안 오류로 인해 파일이 다운로드되지 않을 때 전달됩니다.	URLFilePromise

속성 세부 정보

isAsync

속성

isAsync:Boolean [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

리소스 데이터를 비동기적으로 사용할 수 있는지 여부를 나타냅니다.

URL 스트림은 원래 비동기적이므로 URLFilePrmise 객체의 isAsync 속성은 항상 true입니다.

구현
public function get isAsync():Boolean

relativePath

속성

relativePath:String

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

만들어진 파일의 경로 및 파일 이름입니다(드롭 대상 기준).

경로는 하위 디렉토리를 포함할 수 있으며 하위 디렉토리는 드롭 위치를 기반으로 확인됩니다. 필요한 경우 하위 디렉토리가 만들어집니다. 하위 디렉토리를 포함할 때 File.separator 상수를 사용하여 현재 운영 체제에 대한 올바른 경로 분리 기호 문자를 삽입합니다. ..(마침표 두 개) 바로 가기를 사용하여 부모 디렉토리로 이동하는 것은 허용되지 않습니다.

파일 이름은 원격 리소스의 파일 이름과 동일하지 않아도 됩니다.

구현
public function get relativePath():String
public function set relativePath(value:String):void

request

속성

request:URLRequest

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

드래그 앤 드롭 작업의 결과로 복사할 리소스를 식별하는 URLRequest입니다.

구현
public function get request():URLRequest
public function set request(value:URLRequest):void

생성자 세부 정보

()

생성자

public function URLFilePromise()

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

URLFilePromise 객체를 만듭니다.

이 URLFilePromise 객체를 사용하기 전에 request 및 relativePath 속성을 설정해야 합니다.

메서드 세부 정보

close

()

메서드

public function close():void

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

AIR 런타임이 드래그 앤 드롭 작업 중 적절한 시기에 데이터 소스를 닫을 수 있도록 허용합니다.

응용 프로그램 논리에서 이 함수를 호출하지 마십시오.

open

()

메서드

public function open():IDataInput

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

AIR 런타임이 드래그 앤 드롭 작업 중 적절한 시기에 데이터 소스를 열 수 있도록 허용합니다.

응용 프로그램 논리에서 이 함수를 호출하지 마십시오.

반환값

IDataInput

reportError

()

메서드

public function reportError(e:ErrorEvent):void

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

AIR 런타임이 드래그 앤 드롭 작업 중 발생하는 오류를 보고할 수 있도록 허용합니다.

URLFilePromise 객체가 보고된 모든 오류 이벤트를 다시 전달합니다. 응용 프로그램 논리에서 이 함수를 호출하지 마십시오.

매개 변수

e:ErrorEvent

이벤트 세부 정보

complete

이벤트

이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.COMPLETE

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

파일에 대한 데이터가 완전히 다운로드되었을 때 전달됩니다.

참고: AIR 런타임은 이 이벤트를 사용하여 비동기 데이터 검색 프로세스를 관리합니다. 일반적으로 응용 프로그램이 이 이벤트에 대한 응답으로 어떠한 액션을 취할 필요는 없습니다.

Event.COMPLETE 상수는 complete 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`target`	로드가 완료된 네트워크 객체입니다.

httpResponseStatus

이벤트

이벤트 객체 유형: flash.events.HTTPStatusEvent
속성 HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

응답 헤더를 보고하기 위해 HTTP 요청에 대해 전달됩니다.

httpStatus 이벤트와는 달리, httpResponseStatus 이벤트는 응답 데이터 이전에 전달됩니다. 또한 httpResponseStatus 이벤트에는 responseHeaders 및 responseURL 속성(httpStatus 이벤트에 대해 정의되어 있지 않음) 값이 포함되어 있습니다. httpResponseStatus 이벤트(있는 경우)는 complete 또는 error 이벤트 발생 전에 추가로 전송됩니다.

HTTPStatusEvent.HTTP_RESPONSE_STATUS 상수는 httpResponseStatus 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`responseURL`	응답이 반환된 URL입니다.
`responseHeaders`	URLRequestHeader 객체의 배열로 응답이 반환된 응답 헤더입니다.
`status`	서버에 의해 반환된 HTTP 상태 코드입니다.
`redirected`	응답이 리디렉션의 결과인지 여부입니다.
`target`	HTTP 상태 코드를 수신하는 네트워크 객체입니다.

httpStatus

이벤트

이벤트 객체 유형: flash.events.HTTPStatusEvent
속성 HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

요청 상태 코드를 보고하기 위해 HTTP 요청에 대해 전달됩니다.

HTTPStatusEvent.HTTP_STATUS 상수는 httpStatus 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`status`	서버에 의해 반환된 HTTP 상태 코드입니다.
`target`	HTTP 상태 코드를 수신하는 네트워크 객체입니다.

ioError

이벤트

이벤트 객체 유형: flash.events.IOErrorEvent
속성 IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

IOError로 인해 파일이 다운로드되지 않을 때 전달됩니다.

ioError 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`errorID`	특정 오류와 연결된 참조 번호입니다(AIR만 해당).
`target`	입력/출력 오류가 발생한 네트워크 객체입니다.
`text`	오류 메시지로 표시될 텍스트입니다.

open

이벤트

이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.OPEN

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

기본 URLStream 연결이 열릴 때 전달됩니다.

Event.OPEN 상수는 open 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`target`	연결을 설정한 네트워크 객체입니다.

progress

이벤트

이벤트 객체 유형: flash.events.ProgressEvent
속성 ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

기본 URLStream에서 데이터 블록을 읽을 수 있을 때 전달됩니다.

progress 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`bubbles`	`false`
`bytesLoaded`	리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다.
`bytesTotal`	로드 프로세스가 완료되면 최종적으로 로드될 총 바이트 수 또는 항목 수입니다.
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`target`	진행률을 보고하는 객체입니다.

securityError

이벤트

이벤트 객체 유형: flash.events.SecurityErrorEvent
속성 SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

보안 오류로 인해 파일이 다운로드되지 않을 때 전달됩니다.

SecurityErrorEvent.SECURITY_ERROR 상수는 securityError 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`target`	보안 오류를 보고하는 네트워크 객체입니다.
`text`	오류 메시지로 표시될 텍스트입니다.

법적 고지 사항 | 온라인 개인 정보 보호 정책

URLFilePromise - AS3

패키지x

언어 요소

부록

패키지 air.desktop

isAsync

relativePath

request

URLFilePromise

close

open

reportError

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError