개요

서버로부터 파일을 다운로드하기 위한 Invisible 오브젝트입니다.

지원 환경

- HTTP/HTTPS 프로토콜의 POST 방식을 사용하여 서버의 파일을 지정된 경로로 다운로드합니다.

- onsuccess, onerror 이벤트는 웹브라우저 환경에서는 발생하지 않습니다.

생성자

FileDownTransfer( strName, objParent )

// Create Object  
var objFileDown = new nexacro.FileDownTransfer( "FileDownTransfer00", this );  

// Add Object to Parent Form  
this.addChild( "FileDownTransfer00", objFileDown );

// Set Object 
objFileDown.url = "http://localhost/Test.txt";
objFileDown.setEventHandler( "onsuccess", this.FileDownTransfer00_onsuccess, this);

// Remove Object form Parent
var objFileDown = this.removeChild( "FileDownTransfer00" );
 
// Destroy Object
objFileDown.destroy();
objFileDown = null;

속성

downloadfilename

파일 다운로드 시 표시되는 FileDialog 에 기본으로 표시될 파일명을 설정합니다.

지원 환경

속성 타입

문법

FileDownTransfer.downloadfilename[= strFileName]

문법 설정

this.FileDownTransfer00.downloadfilename = "Test.txt";

참고

- Windows NRE 환경만 지원하는 속성입니다.

- download() 메소드에서 strTargetpath 파라미터를 설정했을 경우 다운로드를 위한 FileDialog 는 표시되지 않습니다.

id

FileDownTransfer의 고유 식별자를 설정하는 속성입니다.

지원 환경

속성 타입

문법

FileDownTransfer.id

문법 설정

참고

-  addChild나 insertChild 메소드를 사용하여 컴포넌트를 등록할때 parent 가 자식컴포넌트를 구별하기 위한 고유한 key값입니다.

- 속성명이나 메소드명과 같은 예약어를 id 속성값으로 설정할 경우 오류가 발생할 수 있습니다.

- 컴포넌트의 속성은 아니지만 편의를 위하여 넥사크로 스튜디오에서 설정할 수 있는 기능이 제공됩니다.

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

name

FileDownTransfer 의 이름을 설정하는 속성입니다.

지원 환경

속성 타입

문법

FileDownTransfer.name[= strName]

문법 설정

참고

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

postdatalist

파일을 다운로드할 때 서버로 전송할 데이터를 Collection 형태로 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

FileDownTransfer.postdatalist

문법 설정

this.FileDownTransfer00.postdatalist["Key"];

참고

- 서버로 데이터 전송 시 HTTP/HTTPS 프로토콜을 사용하여 POST 방식으로 전송합니다.

- postdatalist 속성은 "{ Key : Value }" 형태의 Collection 으로 setPostData() 메소드를 사용하여 설정할 수 있습니다.

- postdatalist 속성은 Collection 접근방식을 사용할 수 잇습니다.
   postdatalist[0], postdatalist["strKey"], postdatalist.length 등의 방법을 사용합니다.

url

FileDownTransfer 에서 다운로드 받을 파일의 서버경로와 파일명을 설정하는 속성입니다.

지원 환경

속성 타입

문법

FileDownTransfer.url[= strURL]

문법 설정

this.FileDownTransfer00.urll = "http://localhost/Test.txt";

참고

- download() 메소드 실행 시 다운로드 경로 파라미터를 설정하지 않으면 url 속성에 설정된 값이 적용됩니다.
   download() 메소드 실행 시 다운로드 경로 파라미터를 설정하면 url 속성에 설정된 값은 무시됩니다.


◆ web runtime environment 제약

- Image, PDF 와 같은 특정 컨텐츠는 다운로드 시 웹브라우저가 파일을 수신하여 오픈 할 수 있습니다.
   웹브라우저의 파일 수신을 막으려면 url 속성에 다운로드를 위한 모듈경로를 설정하고 
   실제 파일정보는 PostData 에 설정하여 다운로드 모듈에서 파일을 전송하는 방법을 사용하여야 합니다.

메서드

addEvent

FileDownTransfer 에 특정 이벤트를 선언하여 추가하는 메소드입니다.

지원 환경

문법

FileDownTransfer.addEvent( strEventID )

파라미터

var bResult = this.FileDownTransfer00.addEvent( "onmove" );

반환

참고

- Composite Component 와 같은 사용자 컴포넌트에 특정 이벤트를 추가할 때 사용하는 메소드입니다.

- FileDownTransfer 에서 특정 이벤트를 제거하려면 removeEvent() 메소드를 사용하여야 합니다.

addEventHandler

FileDownTransfer 의 특정 이벤트에 핸들러 함수를 추가하는 메소드입니다.

지원 환경

문법

FileDownTransfer.addEventHandler( strEventID, objFunc, objTarget )

파라미터

this.FileDownTransfer00_onmove = function( obj:nexacro.FileDownTransfer,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.FileDownTransfer00.addEventHandler( "onmove", this.FileDownTransfer00_onmove, this);

반환

addEventHandlerLookup

함수를 검색하여 FileDownTransfer 의 특정 이벤트에 핸들러 함수로 추가하는 메소드입니다.

지원 환경

문법

FileDownTransfer.addEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

this.FileDownTransfer00_onmove = function( obj:nexacro.FileDownTransfer,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.FileDownTransfer00.addEventHandlerLookup( "onmove", "FileDownTransfer00_onmove", this);

반환

참고

- strFunc 이름의 함수를 objTarget 영역부터 상위로 올라가며 검색합니다.
  검색된 함수가 있다면 이벤트에 핸들러 함수로 추가합니다.

clearEventHandler

특정 이벤트에 등록된 핸들러 함수를 모두 제거하는 메소드입니다.

지원 환경

문법

FileDownTransfer.clearEventHandler( strEventID )

파라미터

var nCnt = this.FileDownTransfer00.clearEventHandler( "onmove" );

반환

참고

- 특정 핸들러 함수만 제거하려면 removeEventHandler() 메소드를 사용하여야 합니다.

clearPostDataList

postdatalist 속성에 설정된 데이터를 모두 삭제하는 메소드입니다.

지원 환경

문법

FileDownTransfer.clearPostDataList()

파라미터

this.FileDownTransfer00.clearPostDataList();

참고

- postdatalist 속성은 "{ Key : Value }" 형태의 Collection 으로 setPostData() 메소드를 사용하여 설정할 수 있습니다.

destroy

스크립트에서 동적으로 생성한 FileDownTransfer 을(를) 삭제하는 메소드입니다.

지원 환경

문법

FileDownTransfer.destroy()

반환

참고

- 동적으로 생성한 FileDownTransfer 을(를) 완전히 삭제하기 위해서는 destroy() 메소드를 호출해야 합니다.

download

서버에서 HTTP/HTTPS 프로토콜의 POST 방식으로 특정 파일을 다운로드 하는 메소드입니다.

지원 환경

문법

FileDownTransfer.download( [strUrl [, strTargetpath]] )

파라미터

this.FileDownTransfer00.download( );
this.FileDownTransfer00.download( "http://localdhost/Test.txt" );
this.FileDownTransfer00.download( "http://localdhost/Test.txt", "C:\\Users\\nexacro\\Down_Test.txt" );

참고

- 서버에 다운로드 요청 시 postdatalist 속성에 설정된 데이터를 HTTP/HTTPS 프로토콜을 사용하여 POST 방식으로 전송합니다.


◆ web runtime environment 제약

- Image, PDF 와 같은 특정 컨텐츠는 다운로드 시 웹브라우저가 파일을 수신하여 오픈 할 수 있습니다.
   웹브라우저의 파일 수신을 막으려면 strUrl 파라미터에 다운로드를 위한 모듈경로를 설정하고 
   실제 파일정보는 PostData 에 설정하여 다운로드 모듈에서 파일을 전송하는 방법을 사용하여야 합니다.

findEventHandler

FileDownTransfer 의 특정 이벤트에서 핸들러 함수를 찾아 인덱스를 반환하는 메소드입니다.

지원 환경

문법

FileDownTransfer.findEventHandler( strEventID, objFunc, objTarget )

파라미터

this.FileDownTransfer00_onmove = function( obj:nexacro.FileDownTransfer,  e:nexacro.MoveEventInfo ) { //수행할 스크립트 };

var nIndex = this.FileDownTransfer00.findEventHandler( "onmove", this.FileDownTransfer00_onmove, this );

반환

참고

- 핸들러 함수의 인덱스는 0 부터 시작합니다.

getEventHandler

FileDownTransfer 의 특정 이벤트에서 지정된 인덱스에 해당하는 핸들러 함수를 반환하는 메소드입니다.

지원 환경

문법

FileDownTransfer.getEventHandler( strEventID, nIdx )

파라미터

var objFunc = FileDownTransfer00.getEventHandler( "onmove", 0 );

반환

getPostData

postdatalist 속성에 설정된 데이터에서 특정 Key 값에 해당하는 데이터를 반환하는 메소드입니다.

지원 환경

문법

FileDownTransfer.getPostData( strKey )

파라미터

var varVal = this.FileDownTransfer00.getPostData( "key0" );

반환

참고

- postdatalist 속성은 "{ Key : Value }" 형태의 Collection 입니다.

insertEventHandler

FileDownTransfer 의 특정 이벤트에 핸들러 함수를 지정한 위치에 삽입하는 메소드입니다.

지원 환경

문법

FileDownTransfer.insertEventHandler( strEventID, nIndex, objFunc, objTarget )

파라미터

this.FileDownTransfer00_onmove = function( obj:nexacro.FileDownTransfer,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };

var nIndex = this.FileDownTransfer00.insertEventHandler( "onmove", 0, this.FileDownTransfer00_onmove, this);

반환

참고

- 첫번째 핸들러 함수의 인덱스는 0 입니다.

removeEvent

FileDownTransfer 에 선언된 특정 이벤트를 삭제하는 메소드입니다.

지원 환경

문법

FileDownTransfer.removeEvent( strEventID )

파라미터

var bResult = this.FileDownTransfer00.removeEvent( "onmove" );

반환

참고

- Composite Component 와 같은 사용자 컴포넌트에서 특정 이벤트를 삭제할 때 사용하는 메소드입니다.

- 이벤트에 핸들러 함수가 정의되어 있을 경우 이벤트를 삭제할 수 없습니다.

- FileDownTransfer 에 특정 이벤트를 추가하려면 addEvent() 메소드를 사용하여야 합니다.

- FileDownTransfer 에 기본으로 선언되어 있는 이벤트 삭제 시 오동작 할 수 있으므로 주의하여야 합니다.

removeEventHandler

FileDownTransfer 의 특정 이벤트에서 핸들러 함수를 제거하는 메소드입니다.

지원 환경

문법

FileDownTransfer.removeEventHandler( strEventID, objFunc, objTarget )

파라미터

this.FileDownTransfer00_onmove = function( obj:nexacro.FileDownTransfer,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.FileDownTransfer00.removeEventHandler( "onmove", this.FileDownTransfer00_onmove, this);

반환

참고

- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 0 번부터 재조정됩니다.

- 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.

removeEventHandlerLookup

FileDownTransfer 의 특정 이벤트에서 검색된 함수와 동일한 핸들러 함수를 제거하는 메소드입니다.

지원 환경

문법

FileDownTransfer.removeEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

this.FileDownTransfer00_onmove = function( obj:nexacro.FileDownTransfer,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.FileDownTransfer00.removeEventHandlerLookup( "onmove", "FileDownTransfer00_onmove", this);

반환

참고

- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 0 번부터 재조정됩니다.

- 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.

removePostData

postdatalist 속성에 설정된 데이터에서 특정 Key 값에 해당하는 데이터를 제거하는 메소드입니다.

지원 환경

문법

FileDownTransfer.removePostData( strKey );

파라미터

this.FileDownTransfer00.removePostData( "Key0" );

참고

- postdatalist 속성은 "{ Key : Value }" 형태의 Collection 입니다.

setEventHandler

FileDownTransfer 의 특정 이벤트에서 첫번째 핸들러 함수를 변경하는 메소드입니다.

지원 환경

문법

FileDownTransfer.setEventHandler( strEventID, objFunc, objTarget )

파라미터

this.FileDownTransfer00_onmove = function( obj:nexacro.FileDownTransfer,  e:nexacro.MoveEventInfo ) { //수행할 스크립트 };
var nIndex = this.FileDownTransfer00.setEventHandler( "onmove", this.FileDownTransfer00_onmove, this );

반환

참고

- 인덱스가 0 번인 핸들러 함수를 새로운 함수로 대체합니다.

- 인덱스가 0 번인 핸들러 함수가 없다면 0 번 인덱스에 새로운 함수를 핸들러 함수로 추가합니다.

setEventHandlerLookup

FileDownTransfer 의 특정 이벤트에서 첫번째 핸들러 함수를 검색된 함수로 변경하는 메소드입니다.

지원 환경

문법

FileDownTransfer.setEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

this.FileDownTransfer00_onmove = function( obj:nexacro.FileDownTransfer,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.FileDownTransfer00.setEventHandlerLookup( "onmove", "FileDownTransfer00_onmove", this);

반환

참고

- 인덱스가 0 번인 핸들러 함수를 검색된 함수로 대체합니다.

- 인덱스가 0 번인 핸들러 함수가 없다면 0 번 인덱스에 검색된 함수를 핸들러 함수로 추가합니다.

setPostData

파일 다운로드 요청 시 서버로 전송할 데이터를 postdatalist 속성에 추가하는 메소드입니다.

지원 환경

문법

FileDownTransfer.setPostData( strKey, varVal )

파라미터

this.FileDownlTransfer00.setPostData( "Key0", "PostData00" );

참고

- postdatalist 속성은 "{ Key : Value }" 형태의 Collection 입니다.

이벤트

onerror

파일 다운로드에 실패하거나 에러코드가 반환 되었을 때 발생하는 이벤트입니다.

지원 환경

문법

onerror(obj:nexacro.FileDownTransfer,e:nexacro.FileDownTransferErrorEventInfo);

파라미터

참고

- 서버에서 0 미만의 음수값이 결과코드로 반환되었을 때 실패로 처리됩니다.

◆ web runtime environment 제약
- web runtime environment 는 지원하지 않는 이벤트입니다.
- WRE에서는 파일 다운로드의 성공 또는 실패, 취소 등의 상태를 확인할 수 없어 onerror, onsuccess 이벤트를 지원하지 않습니다.
  개발 단계에서 필요하다면 WRE에서는 개발자도구(콘솔, 네트워크)를 통해 파일 다운로드 상태를 확인할 수 있습니다.
  NRE는 파일 다운로드 상태를 자체적으로 처리하며 해당 정보를 통해 onerror, onsuccess 이벤트를 지원합니다.
- 파일 다운로드 동작은 서버 측 코드 없이 직접 다운로드할 파일 URL을 지정해서 다운로드를 시도할 수 있기 때문에 WRE에서는 서버 측 코드에서 응답하는 에러코드, 메시지를 처리하지 않도록 구현됐습니다.

onsuccess

파일 다운로드가 완료된 후 성공코드가 반환 되었을 때 발생하는 이벤트입니다.

지원 환경

문법

onsuccess(obj:nexacro.FileDownTransfer,e:nexacro.FileDownTransferEventInfo);

파라미터

참고

- 서버에서 0 이상의 결과코드가 반환되었을 때 성공으로 처리됩니다.

- web runtime environment 는 지원하지 않는 이벤트입니다.