イベントアドレスを呼び出す

説明

DEXTUploadX5 HDアプリケーションプログラムは、まずスタンドアロンプログラムであるため、ダウンロードするアイテムを登録する基本的な操作以外は、プログラムで生成されたイベントをブラウザに提供する通信機能を除外するように設計されています。代わりに、プログラムからアイテムがダウンロードされるたびに、サーバー上の特定のアドレスにGETリクエストを送信することが可能です。イベントアドレスは、アイテムごとに設定するメソッドを使用するため、アイテムごとに異なるリクエストを提供する可能性があります。

var dx = dx5.get("component-id");

// イベントアドレスは、eventUriStart、eventUriStop、eventUriEnd プロパティを使用して設定できます。
dx.addVirtualFile({ 
	... 
	name: "bridge_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レスポンスである場合、ファイルのダウンロードはそのまま続行されます。さらに、この例では、サーバーのイベント・アドレスにリクエストを送信するだけで、リクエストの結果を確認する方法を提供していません。リクエストがサーバーに正しく送信されていることを確認するには、サーバー側のコードでリクエストを記録するか、デバッグ・モードで確認する必要があります。

例