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

説明

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レスポンスの場合、ファイルのダウンロードはそのまま続行されます。さらに、この例ではサーバーのイベントアドレスにリクエストを送るだけで、リクエストの結果を確認する方法を提供していません。リクエストが正しくサーバーに送られることを確認するには、サーバー側のコードでリクエストを記録するか、デバッグモードで見る必要があります。

例