このページは サポート対象外ドキュメント です。 サポート対象外ドキュメントについて を了承の上ご利用ください。

JavaWebStart 差分ダウンロード

Sunより提供されている JNLP 開発者向けパック に含まれている jardiff ツール、jnlp-servlet.jar ファイル を使用することにより、 JavaWebStartにて 差分ダウンロード を始め、JNLP ファイルへのコードベース URL の自動インストール、JNLP ファイルのタイムスタンプの明示的な指定、 など、各種機能が使用できるようになります。
このドキュメントでは、差分ダウンロード を目的とした設定方法についてのドキュメントになります。
なお、JNLP 開発者向けパック に含まれるバージョンなどにより、指定方法などが異なる場合があります。
また、弊社製品の機能ではないため、サポート対象外とさせていただいています。
予めご了承ください。

必要なもの

セットアップ例(Tomcat の場合)

ここでは Webtribe をセットアップしたディレクトリを ${WEBTRIBE_HOME} という名称で表記しています。

例として Tomcat に webtribe というディレクトリを作成して実行している場合は
c:\jakarta-tomcat-4.1\webapps\webrribe
/opt/jakarta-tomcat-4.1/webapps/webtribe

ここに記述しているものとは別の方法でも差分ダウンロードを実現することは可能です。
差分ダウンロードについては、上記 URL からダウンロードした javaws-1_0_1-dev.zip に含まれる、 downloadservletguide_ja.html に記述されています。

  1. 差分ダウンロード用サーブレットをプロジェクトディレクトリにコピー。
    javaws-1_0_1-dev.zip を解凍します。
    次のファイルを ${WEBTRIBE_HOME}/WEB-INF/lib にコピーします。
    • jnlp-servlet.jar
    • jardiff.jar
  2. 差分ダウンロード用 JAR ファイルディレクトリ作成。
    ${WEBTRIBE_HOME}/lib/ver ディレクトリを作成します。 
    ${WEBTRIBE_HOME}
      |
      +-- lib (バージョン管理しない JAR ファイルを配置)
      | |
      | +-- ver (バージョン管理対象とする JAR ファイルを配置)
      +-- WEB-INF
  3. web.xml 編集。
    ${WEBTRIBE_HOME}/WEB-INF/web.xml に次の記述を加えます。
  4. JNLP ファイル編集。
    ${WEBTRIBE_HOME}/RunClient.jnlp を次のように編集します。 ダウンロード用サーブレット(JnlpDownloadServlet)が $$codebase を JNLP ファイルが存在する codebase に、$$name を JNLP ファイル名に変換してクライアントに返します。
    ※ この作業は必須ではありません。 (JnlpDownloadServlet を使った場合に有効になる機能で、WEB サーバホストや、ポート番号、 WEB アプリケーションディレクトリに依存しない JNLP ファイルの記述が可能になります。)
  5. 次のファイルをバージョンダウンロードの対象になるように設定します。
    • user_rule.jar
    • camc.jar
    • pmc_desktop.jar
    1. バージョンダウンロード用 JAR ファイルを格納するディレクトリを作成します。
      • ${WEBTRIBE_HOME}/lib/ver/user_rule
      • ${WEBTRIBE_HOME}/lib/ver/camc
      • ${WEBTRIBE_HOME}/lib/ver/pmc_desktop
      ${WEBTRIBE_HOME}
      |
      +-- lib
      |  |
      |  +-- ver
      |       |
      |       +-- user_rule
      |       +-- camc
      |       +-- pmc_desktop
      |
      +-- WEB-INF
    2. 各 JAR ファイルを下記名称でバージョン 1.0 としてコピーします。
      • user_rule.jar
        ${WEBTRIBE_HOME}/lib/ver/user_rule/user_rule__V1.0.jar
      • camc.jar
        ${WEBTRIBE_HOME}/lib/ver/camc/camc__V1.0.jar
      • pmc_desktop.jar
        ${WEBTRIBE_HOME}/lib/ver/pmc_desktop./pmc_desktop__V1.0.jar
    3. version.xml を作成します。
      ${WEBTRIBE_HOME}/lib/ver/version.xml を次の内容で記述します。
  6. バージョンダウンロード用 JAR ファイルを参照するよう、JNLP ファイルの resource 記述を変更。

以上で、設定は終わりです。
設定を有効にするためには、JnlpDownloadServlet がリロードされるようにします。
(version.xml のタイムスタンプを更新、Tomcat の再起動、Tomcat の管理コンソールからの指示、等。)

JAR ファイルの更新

JAR ファイルに含まれるモジュール、ファイルに更新があった場合の作業は、次の手順になります。
(例) user_rule.jar を更新し、version 1.1 として登録する場合。

  1. 作成した user_rule.jar を ${WEBTRIBE_HOME}/lib/ver/user_rule に user_rule__V.1.1.jar という名称でコピーします。
  2. ${WEBTRIBE_HOME}/lib/ver/version.xml に user_rule__V.1.1.jar の内容を登録します。
  3. ${WEBTRIBE_HOME}/RunClient.jnlp のバージョンの記述を編集し、user_rule.jar は version 1.1 を使うようにします。

以上で設定は終わりです。

補足、注意点

Valid XHTML 1.1