가상 파일을 등록하는 예제입니다.
- 설명
-
가상 파일이란 사용자 로컬 PC에 존재하지 않으며, 실체가 없는 가상의 파일을 말합니다.
일반적으로 가상 파일은 이미 업로드한 파일에 대한 정보를 남기는 용도로 사용하곤 합니다. 즉 서버에 존재하는 파일이라는 표시로써 사용됩니다.
실제로 로컬에 존재하지 않는 파일이므로, 파일 업로드 대상이 아닙니다.
가상 파일을 등록하려면 addVirtualFile 함수를 사용하거나 addVirtualFileList 함수를 사용합니다.
가상 파일은 json 객체 형식으로 등록이 됩니다.
- vindex: 가상 파일을 구분 짓는 유일한 키로써, 어떤 형식이라도 상관이 없지만, 중복되지 않아야 합니다. (필수항목)
- name: 가상 파일의 이름입니다. (필수항목)
- size: 가상 파일의 크기이며 byte 단위를 사용합니다. (필수항목)
- lock: 잠금 상태가 true이면 파일을 삭제할 수 없습니다.
var dx = dx5.get(id); // 개별로 등록할 때 dx.addVirtualFile({ vindex: "IDX0001", name: "가상파일.txt", size: 12345 }); dx.addVirtualFile({ vindex: "IDX0002", name: "잠긴-가상파일.txt", size: 45678, lock: true }); dx.addVirtualFile({ vindex: "IDX0003", name: "코스모스.jpg", size: 195779 }); // 여러 개를 한 번에 등록할 때 dx.addVirtualFileList([ { vindex: "IDX0001", name: "가상파일.txt", size: 12345 }, { vindex: "IDX0002", name: "잠긴-가상파일.txt", size: 45678, lock: true }, { vindex: "IDX0003", name: "코스모스.jpg", size: 195779 } ]);
가상 파일은 onDX5Created 콜백 함수에서 등록하는 경우가 많으며,
등록함수인 addVirtualFile, addVirtualFileList는 비동기 방식으로 파일을 등록하기 때문에 두 함수 다음에 오는 코드가 먼저 실행될 수 있음을 주의하도록 합니다.
- 예제
-