개요

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

지원 환경

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

- filelist 속성에 설정된 한 개 이상의 파일과 postdatalist 속성에 설정한 데이터를 서버로 전송합니다.

- 파일 업로드 중에는 onprogress 이벤트가 발생하며, 발생주기는 브라우저에 따라 달라질 수 있습니다.


◆ Desktop WRE 제약

- Chrome, FireFox 브라우저는 실제 파일경로가 표시되지 않는 제약사항으로 파일정보 중 파일경로가 "fakepath" 로 표시됩니다.

생성자

FileUpTransfer( strName, objParent )

// Create Object  
var objFileUp = new nexacro.FileUpTransfer("FileUpTransfer00", this);  

// Add Object to Parent Form  
this.addChild( "FileUpTransfer00", objFileUp );

// Set Object 
objFileUp.url = "http://localhost/UploadServlet.jsp";
objFileUp.setEventHandler( "onsuccess", this.FileUpTransfer00_onsuccess, this);
objFileUp.addFile( "file00", objVFile00 );

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

속성

filelist

FileUpTransfer 에서 서버로 업로드할 파일의 정보를 Collection 형태로 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

FileUpTransfer.filelist

문법 설정

var objFile0 = this.FileUpTransfer00.filelist[0];
var objFile0 = this.FileUpTransfer00.filelist["id"];

참고

- filelist 속성은 "{ ID : VirtualFile }" 형태의 Collection 으로 addFile(), setFile() 메소드를 사용하여 설정할 수 있습니다.

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

활용 예제

• 선택한 파일 업로드하기

id

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

지원 환경

속성 타입

문법

FileUpTransfer.id

문법 설정

참고

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

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

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

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

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

name

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

지원 환경

속성 타입

문법

FileUpTransfer.name[= strName]

문법 설정

참고

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

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

postdatalist

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

지원 환경

속성 타입

문법

FileUpTransfer.postdatalist

문법 설정

this.FileUpTransfer00.postdatalist["Key"];

참고

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

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

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

url

FileUpTransfer 에서 업로드 한 파일을 수신할 서버페이지 정보를 설정하는 속성입니다.

지원 환경

속성 타입

문법

FileUpTransfer.url[= strURL]

문법 설정

this.FileUpTransfer00.url = "http://localhost/UploadServlet.jsp";

참고

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

- 파일 업로드의 결과를 onsuccess 이벤트의 "e.datasets" 속성으로 전달할 수 있습니다.
   "e.datasets" 속성은 XML 또는 SSV 형식의 DataSet 으로 구성되어야 합니다.

- 어플리케이션의 Domain 과 파일을 수신 할 서버페이지의 Domain 이 다를 경우 Cross Domain 문제로 에러가 발생할 수 있습니다.

메서드

addEvent

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

지원 환경

문법

FileUpTransfer.addEvent( strEventID )

파라미터

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

반환

참고

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

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

addEventHandler

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

지원 환경

문법

FileUpTransfer.addEventHandler( strEventID, objFunc, objTarget )

파라미터

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

반환

addEventHandlerLookup

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

지원 환경

문법

FileUpTransfer.addEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

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

반환

참고

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

addFile

filelist 속성의 마지막 위치에 파일정보를 추가하는 메소드입니다.

지원 환경

문법

FileUpTransfer.addFile( strID, objVFile )

파라미터

var nIdx = this.FileUpTransfer00.addFile( "file00", objVFile0 );

반환

참고

- filelist 속성은 "{ ID : VirtualFile }" 형태의 Collection 입니다.

- filelist 속성에 설정된 파일정보를 변경하려면 setFile() 메소드를 사용하여야 합니다.

활용 예제

• 선택한 파일 업로드하기

clearEventHandler

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

지원 환경

문법

FileUpTransfer.clearEventHandler( strEventID )

파라미터

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

반환

참고

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

clearFileList

filelist 속성에 설정된 파일정보를 모두 삭제하는 메소드입니다.

지원 환경

문법

FileUpTransfer.clearFileList()

파라미터

this.FileUpTransfer00.clearFileList();

참고

- filelist 속성은 "{ ID : VirtualFile }" 형태의 Collection 으로 addFile(), setFile() 메소드를 사용하여 설정할 수 있습니다.

clearPostDataList

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

지원 환경

문법

FileUpTransfer.clearPostDataList()

파라미터

this.FileUpTransfer00.clearPostDataList();

참고

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

destroy

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

지원 환경

문법

FileUpTransfer.destroy()

반환

참고

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

existFile

filelist 속성에서 인수로 전달된 VirtualFile 오브젝트와 일치하는 파일정보의 존재여부를 반환하는 메소드입니다.

지원 환경

문법

FileUpTransfer.existFile( objVFile )

파라미터

var bExist = this.FileUpTransfer00.existFile( objVFile0 );

반환

참고

- filelist 속성은 VirtualFile 오브젝트 배열입니다.

- 특정 파일정보의 일치여부를 판단하는 기준은 환경에 따라 달라집니다.
   > Nexacro Runtime Environment는 VirtualFile 오브젝트의 fullpath 속성값이 동일하여야 합니다.
   > Web Runtime Environment는 VirtualFile 오브젝트의 filename 과 filesize 속성값이 모두 동일하여야 합니다.

findEventHandler

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

지원 환경

문법

FileUpTransfer.findEventHandler( strEventID, objFunc, objTarget )

파라미터

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

var nIndex = this.FileUpTransfer00.findEventHandler( "onmove", this.FileUpTransfer00_onmove, this );

반환

참고

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

getEventHandler

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

지원 환경

문법

FileUpTransfer.getEventHandler( strEventID, nIdx )

파라미터

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

반환

getFileArrayByFileName

filelist 속성에서 지정한 파일명과 일치하는 파일정보를 VirtualFile 오브젝트 배열로 반환하는 메소드입니다.

지원 환경

문법

FileUpTransfer.getFileArrayByFileName( strFileName )

파라미터

var arrVFile = this.FileUpTransfer00.getFileArrayByFileName( "Test.txt" );

반환

참고

- filelist 속성은 "{ ID : VirtualFile }" 형태의 Collection 입니다.

getIndexArrayByFileName

filelist 속성에서 지정한 파일명과 일치하는 파일정보의 인덱스를 배열로 반환하는 메소드입니다.

지원 환경

문법

FileUpTransfer.getIndexArrayByFileName( strFileName )

파라미터

var arrIdx = this.FileUpTransfer00.getIndexArrayByFileName( "Test.txt" );

반환

참고

- filelist 속성은 "{ ID : VirtualFile }" 형태의 Collection 입니다.

getPostData

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

지원 환경

문법

FileUpTransfer.getPostData( strKey )

파라미터

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

반환

참고

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

insertEventHandler

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

지원 환경

문법

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

파라미터

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

var nIndex = this.FileUpTransfer00.insertEventHandler( "onmove", 0, this.FileUpTransfer00_onmove, this);

반환

참고

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

removeEvent

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

지원 환경

문법

FileUpTransfer.removeEvent( strEventID )

파라미터

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

반환

참고

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

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

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

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

removeEventHandler

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

지원 환경

문법

FileUpTransfer.removeEventHandler( strEventID, objFunc, objTarget )

파라미터

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

반환

참고

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

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

removeEventHandlerLookup

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

지원 환경

문법

FileUpTransfer.removeEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

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

반환

참고

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

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

removeFile

filelist 속성에 설정된 파일정보에서 인수로 전달된 VirtualFile 오브젝트와 일치하는 파일정보를 제거하는 메소드입니다.

지원 환경

문법

FileUpTransfer.removeFile( strID )

파라미터

var nIndex = this.FileUpTransfer00.removeFile( "file00" );

반환

참고

- filelist 속성은 "{ ID : VirtualFile }" 형태의 Collection 입니다.

- 파일정보가 제거되면 filelist 속성의 Collection 인덱스가 재조정됩니다.

removeFileByIndex

filelist 속성에 설정된 파일정보에서 인수로 전달된 인덱스의 파일정보를 제거하는 메소드입니다.

지원 환경

문법

FileUpTransfer.removeFileByIndex( nIndex )

파라미터

var nIndex = this.FileUpTransfer00.removeFileByIndex( 0 );

반환

참고

- filelist 속성은 "{ ID : VirtualFile }" 형태의 Collection 입니다.

- 파일정보가 제거되면 filelist 속성의 Collection 인덱스가 재조정됩니다.

removePostData

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

지원 환경

문법

FileUpTransfer.removePostData( strKey );

파라미터

this.FileUpTransfer00.removePostData( "Key0" );

참고

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

setEventHandler

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

지원 환경

문법

FileUpTransfer.setEventHandler( strEventID, objFunc, objTarget )

파라미터

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

반환

참고

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

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

setEventHandlerLookup

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

지원 환경

문법

FileUpTransfer.setEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

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

반환

참고

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

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

setFile

filelist 속성에서 인수로 전달된 인덱스의 파일정보를 변경하는 메소드입니다.

지원 환경

문법

FileUpTransfer.setFile( nIndex, objVFile )

파라미터

var bResult = this.FileUpTransfer00.setFile( 0, objVFile0 );

반환

참고

- filelist 속성은 "{ ID : VirtualFile }" 형태의 Collection 입니다.

- filelist 속성에 파일정보를 추가하려면 addFile() 메소드를 사용하여야 합니다.

setPostData

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

지원 환경

문법

FileUpTransfer.setPostData( strKey, varVal )

파라미터

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

참고

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

upload

filelist 속성에 설정한 파일들을 HTTP/HTTPS 프로토콜의 POST 방식으로 업로드 하는 메소드입니다.

지원 환경

문법

FileUpTransfer.upload( [strUrl] )

파라미터

this.FileUpTransfer00.upload( "http://localhost/UploadServlet.jsp" );

참고

- filelist 속성의 파일과 postdatalist 속성의 데이터를 HTTP/HTTPS 프로토콜을 사용하여 POST 방식으로 전송합니다.

- 파일 업로드의 결과에 대한 응답을 onsuccess 이벤트에서 FileUpTransferEventInfo 오브젝트의 datasets 속성으로 전달할 수 있습니다. 
  datasets 속성은 XML, SSV, JSON 형식의 Dataset 으로 구성되어야 합니다.

- 파일 업로드 중에는 onprogress 이벤트가 발생합니다.
   파일 업로드 완료 후 서버에서 보내온 결과에 따라 onsuccess 또는 onerror 이벤트가 발생합니다.

- 어플리케이션의 Domain 과 파일을 수신 할 서버페이지의 Domain 이 다를 경우 Cross Domain 문제로 에러가 발생할 수 있습니다.

활용 예제

• 선택한 파일 업로드하기

이벤트

onerror

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

지원 환경

문법

onerror(obj:nexacro.FileUpTransfer,e:nexacro.FileUpTransferErrorEventInfo);

파라미터

참고

- 서버와 통신이 성공한 이후 서버 측 코드에서 응답하는 에러코드, 메시지는 WRE, NRE 모두 같은 방식으로 처리합니다.
  서버에서 0 미만의 음수값이 결과코드로 반환되었을 때 실패로 처리됩니다.

◆ web runtime environment 제약
- WRE에서 일부 브라우저에서만 업로드의 실패, 취소 등의 상태를 부분적으로 확인할 수 있지만 정상적인 상태 정보를 보장할 수 없어 onerror 이벤트에서 HTTP Status Code 처리는 지원하지 않습니다.
  NRE는 파일 업로드 상태를 자체적으로 처리하며 해당 정보를 통해 HTTP Status Code에 대한 onerror 이벤트를 지원합니다.

onprogress

파일이 업로드 중일 때 일정간격으로 발생하는 이벤트입니다.

지원 환경

문법

onprogress(obj:nexacro.FileUpTransfer,e:nexacro.FileUpTransferProgressEventInfo);

파라미터

참고

- 이벤트가 발생하는 간격은 웹브라우저에 따라 달라질 수 있습니다.

onsuccess

파일 업로드가 완료된 후 성공코드값이 전달 되었을 때 발생하는 이벤트입니다.

지원 환경

문법

onsuccess(obj:nexacro.FileUpTransfer,e:nexacro.FileUpTransferEventInfo);

파라미터

참고

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

- 파일 업로드 결과에 대한 응답을 FileUpTransferEventInfo 오브젝트의 datasets 속성에 XML, SSV, JSON 형식의 Dataset으로 전달할 수 있습니다.
  XML, SSV, JSON 구조에 적합하지 않은 정보는 누락될 수 있습니다.