가상파일을 등록

설명

가상 파일이란 사용자 로컬 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 }
]);

등록함수인 addVirtualFile, addVirtualFileList는 비동기 방식으로 파일을 등록하기 때문에 두 함수 다음에 오는 코드가 먼저 실행될 수 있음을 주의한다.

설명

예제