서버로 전송되는 multipart/form-data 정보

AWSS3 모드는 아래 내용의 폼 데이터를 파일 업로드 시 사용하지 않는다.

HTTP 환경에서 POST로 전달되는 데이터를 폼 데이터라고 한다. 폼 데이터는 FORM 엘리먼트 안의 INPUT(text/radio/checkbox), SELECT, TEXTAREA와 같은 엘리먼트를 사용하여 서버로 데이터를 전송을 한다. 각 데이터는 이 엘리먼트가 갖는 "name" 속성 값을 구분자로 하여 구별을 한다.

<form action="..." method="post" enctype="multipart/form-data">
    <input type="text" name="username" value="Hong Gil Dong"/>
    <input type="file" name="attachment"/>
</form>

DEXTUploadX5도 서버로 파일을 업로드할 때, RFC 1867 규약을 따라 HTTP 프로토콜로 전송을 하기 때문에 폼 데이터 처럼, 서버로 전송되는 데이터를 이름으로 구분할 수 있다.

DEXTUploadX5 폼 데이터 설명

이름	설명
DEXTUploadX5_ControlId	dx5.create 메소드를 사용하여 만들어지는 컴포넌트의 DOM 아이디를 가리킨다. 업로드되는 파일의 어느 컴포넌트에 속하는지 알아보기 위한 용도로 사용된다.
DEXTUploadX5_UniqueId	항목의 고유 아이디를 나타낸다. 컴포넌트에 등록된 파일 또는 폴더는 고유 아이디를 자동으로 부여 받는다. 고유 아이디는 하나의 컴포넌트 내에서만 고유성을 갖는다. 여러 클라이언트 혹은 여러 컴포넌트에서 받은 고유 아이디는 서로 중복이 될 수 있다.
DEXTUploadX5_Folder	폴더(디렉터리) 경로 문자열이다. 업로드할 대상이 파일인 경우, 그 파일의 부모 폴더 경로를 나타낸다. 폴더 경로는 사용자 컴퓨터의 루트 위치에서 시작하는 것이 아니라, 선택된 루트 폴더부터 하위 폴더 경로만 나타낸다.
DEXTUploadX5_EXIFData	항목이 갖는 EXIF 데이터이다. 항목이 EXIF 데이터를 갖는 이미지 파일인 경우 setExtractingEXIF 함수를 사용하여 자동으로 추출되도록 설정되었다면, "이름=값" 형식으로 데이터를 구분자 문자열로 결합하여 서버로 전달된다. EXIF 데이터가 없다면 빈 값이며, 값이 있다면 "이름1[구분자]값1[구분자]이름2[구분자]값2[구분자]이름3[구분자]값3[구분자]" 형식으로 전달된다. 서버에서는 [구분자] 문자열을 가지고 분할을 해야 한다.
DEXTUploadX5_MetaData	항목이 갖는 메타 데이터이다. 컴포넌트에서 setMetaDataById, setMetaDataByIndex 함수를 사용하여 등록한 "이름=값" 형식의 데이터를 구분자 문자열로 결합하여 서버로 전달된다. 메타 데이터가 없다면 빈 값이며, 값이 있다면 "이름1[구분자]값1[구분자]이름2[구분자]값2[구분자]이름3[구분자]값3[구분자]" 형식으로 전달된다. 서버에서는 [구분자] 문자열을 가지고 분할을 해야 한다.
DEXTUploadX5_FileData	바이너리 파일 데이터이다. 업로드하는 대상이 파일이 아닌 폴더라면 0바이트 데이터(빈 파일이므로 파일 이름이 없다.)가 올라간다.

위의 폼 요소들은 항목당 1개씩 전달된다. 예를 들어 항목(파일, 폴더)이 10개면, 위의 폼 요소들도 10개씩 순서대로 서버에 전달될 것이다.