| 패키지 | air.desktop |
| 클래스 | public class URLFilePromise |
| 상속 | URLFilePromise  EventDispatcher Object |
| 구현 | IFilePromise |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 2.0 |
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.*;
관련 API 요소
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| isAsync : Boolean [읽기 전용]
리소스 데이터를 비동기적으로 사용할 수 있는지 여부를 나타냅니다. | URLFilePromise | ||
| relativePath : String
만들어진 파일의 경로 및 파일 이름입니다(드롭 대상 기준). | URLFilePromise | ||
| request : URLRequest
드래그 앤 드롭 작업의 결과로 복사할 리소스를 식별하는 URLRequest입니다. | URLFilePromise | ||
| 메서드 | 정의 주체 | ||
|---|---|---|---|
URLFilePromise 객체를 만듭니다. | URLFilePromise | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | |
AIR 런타임이 드래그 앤 드롭 작업 중 적절한 시기에 데이터 소스를 닫을 수 있도록 허용합니다. | URLFilePromise | ||
|
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | |
|
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
AIR 런타임이 드래그 앤 드롭 작업 중 적절한 시기에 데이터 소스를 열 수 있도록 허용합니다. | URLFilePromise | ||
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | |
AIR 런타임이 드래그 앤 드롭 작업 중 발생하는 오류를 보고할 수 있도록 허용합니다. | URLFilePromise | ||
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
|
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
| 이벤트 | 요약 | 정의 주체 | ||
|---|---|---|---|---|
| [브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다. | EventDispatcher | ||
| 파일에 대한 데이터가 완전히 다운로드되었을 때 전달됩니다. | URLFilePromise | |||
| [브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다. | EventDispatcher | ||
| 응답 헤더를 보고하기 위해 HTTP 요청에 대해 전달됩니다. | URLFilePromise | |||
| 요청 상태 코드를 보고하기 위해 HTTP 요청에 대해 전달됩니다. | URLFilePromise | |||
| IOError로 인해 파일이 다운로드되지 않을 때 전달됩니다. | URLFilePromise | |||
| 기본 URLStream 연결이 열릴 때 전달됩니다. | URLFilePromise | |||
| 기본 URLStream에서 데이터 블록을 읽을 수 있을 때 전달됩니다. | URLFilePromise | |||
| 보안 오류로 인해 파일이 다운로드되지 않을 때 전달됩니다. | URLFilePromise | |||
isAsync | 속성 |
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 URLFilePromise | () | 생성자 |
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 연결이 열릴 때 전달됩니다.
참고: AIR 런타임은 이 이벤트를 사용하여 비동기 데이터 검색 프로세스를 관리합니다. 일반적으로 응용 프로그램이 이 이벤트에 대한 응답으로 어떠한 액션을 취할 필요는 없습니다.
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에서 데이터 블록을 읽을 수 있을 때 전달됩니다.
참고: AIR 런타임은 이 이벤트를 사용하여 비동기 데이터 검색 프로세스를 관리합니다. 일반적으로 응용 프로그램이 이 이벤트에 대한 응답으로 어떠한 액션을 취할 필요는 없습니다.
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 | 오류 메시지로 표시될 텍스트입니다. |
Tue Jun 12 2018, 03:17 PM Z