| <resources> | アプリケーションの JAR ファイルやネイティブライブラリ (*.dll, lib*.so) を指定します |
| <jar> | 実行対象のアプリケーションやそのライブラリとなる JAR ファイルを指定します |
| <nativelib> | ネイティブライブラリを含む JAR ファイルを指定します |
| <j2se> | アプリケーションの実行に使用する Java 実行環境の定義を行います |
| <java> | アプリケーションの実行に使用する Java 実行環境の定義を行います |
| <property> | アプリケーション実行時のシステムプロパティとして使用される値を定義します |
| <extension> | 外部に定義したコンポーネント拡張 JNLP ファイルやインストーラ拡張 JNLP ファイルを参照します |
| <ext-download> | 拡張パートのダウンロードを定義します |
| <package> | アプリケーションが使用しているパッケージやクラスがどの JAR に含まれているかを JWS に指示します |
<resources>
SYNOPSIS
| os="対象OS名" |
| arch="対象アーキテクチャ" |
| locale="対象ロケール" |
| <jar> | - | 使用する JAR ファイルを指定します. |
| <nativelib> | - | 使用するネイティブライブラリ (*.dll や lib*.so) を指定します. |
| <java> | - | 実行に使用する JRE やその起動オプションなどを指定します. |
| <j2se> | - | 実行に使用する JRE やその起動オプションなどを指定します. |
| <property> | - | アプリケーション起動時に設定するシステムプロパティを指定します. |
| <extension> | - | アプリケーションが参照する拡張を指定します. |
| <package> | - | クラスやパッケージ名とそれらが含まれている JAR のパート名を関連付けます. |
説 明
アプリケーションの JAR ファイルやネイティブライブラリ (*.dll, lib*.so)
を指定します。os, arch, locale 属性を指定することで特定の実行環境に対して使用するリソースを指定することができます。
<jnlp> 属 性
内 容
使用例
<update check="always" policy="always" />
<jar>
SYNOPSIS
説 明
実行対象のアプリケーションやそのライブラリとなる JAR ファイルを指定します。この JAR ファイル内のクラスやリソースはアプリケーションから参照可能です。
<package> 属 性
この JAR ファイルをアプリケーション起動時に先行ダウンロードするか
(eager)、または必要に応じて遅延ダウンロードするか (lazy)
を指定します。eager を指定した場合、アプリケーションが起動する前にダウンロードが行われます。
JWS はどの JAR にどのクラスが含まれているかを知を知らないため、ロード済みの JAR に存在しないクラスが参照された場合は lazy の JAR
を順次ダウンロードして検索しようとします。遅延ダウンロードで必要な
JAR ファイルを適切にダウンロードさせるには <package> を使用してください。
<nativelib>
説 明
ネイティブライブラリを含む JAR ファイルを指定します。指定する JAR ファイルのルート直下には、それぞれの実行環境でネイティブライブラリとして使用できる名前が付けられた共有ライブラリ (*.dll や lib*.so) が含まれている必要があります。
JAR 内のネイティブライブラリはアプリケーションからロード可能な状態で起動しますが、暗黙的にロードされるわけではありません。通常の JNI
呼び出しと同様にアプリケーションから
System#loadLibrary()
などを呼び出す必要があります。
ネイティブライブラリの指定は通常 <resources> 要素の
os, arch 属性とあわせて使用します。
<resources> <package> 属 性
このライブラリをアプリケーション起動時に先行ダウンロードするか
(eager)、または必要に応じて遅延ダウンロードするか (lazy)
を指定します。eager を指定した場合、アプリケーションが起動する前にダウンロードが行われます。
<j2se>
SYNOPSIS
| version*="1.2|1.3|1.4|1.5|1.6|JREバージョン" |
| href="URI" |
| initial-heap-size="数値[補助単位]?" |
| max-heap-size="数値[補助単位]?" |
| java-vm-args="実行引数" |
| <resources> * | - | この Java 実行環境でアプリケーションを実行するときに必要な追加のリソースを指定します. |
説 明
アプリケーションの実行に使用する Java 実行環境の定義を行います。
Java SE 6 以降は Java 2 という名前が使用されなくなったためこの要素も
<java> に置き換えられました。ただし下位互換性のために残されています。クライアントの環境が Java 6 以降であると想定できるのであれば <java> を使用してください。
<resources> <java> 属 性
起動するアプリケーションがサポートしている Java 実行環境のバージョンです。
1.4+ のように特定のバージョン以上を示すことができます。また
1.4.1_02, 1.5.0-beta2 のようにより具体的なバージョンを指定することもできます。
クライアントの環境に適合するバージョンの JRE がインストールされていない場合、href 属性に基づいて JRE のインストールが行われます。
必要な JRE がインストールされていない場合にダウンロードを行う URI です。通常は "http://java.sun.com/products/autodl/j2se" を指定しておきますが、外部に接続していないネットワークでは別の URL を指定することもできます。
この URL には必要なバージョン付きのリクエストが行われます。
アプリケーション起動時の初期ヒープサイズを指定します。java
コマンドの -Xms と同様に 128m といった補助単位付きでの指定ができます。補助単位は大文字と小文字を区別しません。
アプリケーション実行中の最大ヒープサイズを指定します。java
コマンドの -Xmx と同様に 256m といった補助単位付きでの指定ができます。補助単位は大文字と小文字を区別しません。
内 容
<j2se> や
<java> は無視されます。
<java>
SYNOPSIS
| version*="1.2|1.3|1.4|1.5|1.6|JREバージョン" |
| href="URI" |
| initial-heap-size="数値[補助単位]?" |
| max-heap-size="数値[補助単位]?" |
| java-vm-args="実行引数" |
| <resources> * | - | . |
説 明
アプリケーションの実行に使用する Java 実行環境の定義を行います。
Java SE 6 以前の環境との下位互換性が必要であれば
<j2se> を使用してください。
定義内容は <j2se> と同じですので説明はそちらを参照してください。
<resources> <j2se> 属 性
内 容
<property>
説 明
アプリケーション実行時のシステムプロパティとして使用される値を定義します。この要素は JNLP 内で先頭から評価されるため、同一の名前に異なる値が定義されていた場合は最後の値が使用されます。
信用できないアプリケーションに対しては JWS ランチャーが安全とみなしたシステムプロパティのみしか指定することができません。
<resources> <extension>
SYNOPSIS
| version="バージョン" |
| name="名前" |
| href*="URI" |
| <ext-download> * | - | この拡張に所属するパートのダウンロードダウンロードを定義します. |
説 明
外部に定義したコンポーネント拡張 JNLP ファイルやインストーラ拡張 JNLP ファイルを参照します。
コンポーネント拡張 JNLP ファイルを示した場合、その JNLP ファイル内で定義されているリソースがこのアプリケーションからも使用されます。これはクラスライブラリや大きなリソースをアプリケーション間で共有する時に有用です。
インストーラ拡張 JNLP ファイルを示した場合、もしそのインストーラがまだ実行されていなければアプリケーションの起動に先立って実行されます。またインストーラが
ExtensionInstallerService
を使用して定義した JRE やネイティブライブラリがアプリケーションを実行するために使用されます。
属 性
内 容
<ext-download>
<package>
説 明
アプリケーションが使用しているパッケージやクラスがどの JAR に含まれているかを JWS に指示します。
JWS はどの JAR にどのクラスが含まれているかを知を知らないため、ロード済みの JAR に存在しないクラスが参照された場合は lazy の JAR
を順次ダウンロードして検索しようとします。<package> を使用することで該当する JAR のみを適切にダウンロードさせることができます。このため <package> 要素は遅延ダウンロードを指定した JAR ファイルに対してのみ意味を成します。
<jnlp> 属 性
使用例
biz.moyo.lab.SomeClass がパート名 mylib に関連付けられた
JAR ファイルに存在することを示します。
<package name="biz.moyo.lab.SomeClass" part="mylib" />
biz.moyo.lab 以下に存在する全てのクラス (サブパッケージも含む) が mylib に関連付けられた JAR ファイルに存在することを示します。
<package name="biz.moyo.lab.*" part="mylib"
recursive="true" />