다운로드 이벤트 주소 호출

설명

DEXTUploadX5 HD 응용프로그램은 단독으로 실행하는 프로그램이기 때문에, 다운로드할 항목을 등록하는 기본적인 동작 외에, 프로그램에서 발생하는 이벤트를 브라우저에 제공하는 통신 기능은 제외된 상태로 설계됐다. 대신에 프로그램에서 항목을 다운로드할 때마다 서버의 특정 주소로 GET 요청을 보낼 수 있도록 설정이 가능하다.

이벤트 주소는 항목마다 설정을 하는 방법을 사용하기 때문에 항목마다 다른 요청을 제공할 수도 있으며, 호출이 하고 싶지 않다면 해당 속성을 정의하지 않거나 빈 문자열로 설정한다.

var dx = dx5.get("컴포넌트 아이디");

// eventUriStart, eventUriStop, eventUriEnd 속성을 사용하여 이벤트 주소를 설정할 수 있다.
dx.addVirtualFile({ 
	... 
	name: "서강대교_509147.jpg", 
	url: "...",
	eventUriStart: "http://.../hdevent-start.do?vindex=...&...",
	eventUriStop: "http://.../hdevent-stop.do?vindex=...&...",
	eventUriEnd: "http://.../hdevent-end.do?vindex=...&..."
});

각 속성의 차이는 다음과 같다.

• eventUriStart: 항목을 다운로드하기 전에 해당 주소가 호출된다.
• eventUriStop: 다운로드하는 과정에 사용자가 직접 취소를 하면 호출된다.오류로 중단된 경우에는 호출되지 않는다.
• eventUriEnd: 항목의 다운로드가 완료되면 호출된다.

이벤트 주소로 보내어진 요청이 오류가 발생하더라도 다음 동작에 영향을 주지 않는다. 만약 eventUriStart 주소를 호출한 결과가 404 응답이라고 하더라도 파일 다운로드는 그대로 진행한다. 더불어 예제에서는 서버의 이벤트 주소로 요청만을 보낼 뿐, 요청 결과를 확인할 방법을 따로 제공하지는 않는다. 서버로 올바르게 요청이 가는지 확인하려면 서버 측 코드에서 요청 내용을 기록하거나, 디버그 모드로 살펴보아야 한다.

예제