Java Web Start のアプリケーション・クライアント・ランチャー
Java™ Web Start のアプリケーション・クライアント・ランチャーは、Java クラス com.ibm.websphere.client.installer.ClientLauncher です。 このクラスには、Java Web Start がアプリケーション・クライアント・コンテナーを始動する際や、アプリケーション・クライアントの main() メソッドを呼び出す際に呼び出す main() メソッドが含まれています。 このメソッドには、コマンド行からアプリケーション・クライアントを始動する、lauchClient コマンド行ツールと同様の機能があります。
com.ibm.websphere.client.launcher.ClientLauncher クラスは、<app_client_root>/lib/webstart ディレクトリーにある WebSphereClientLauncher.jar ファイルにパッケージ化されています。
ランチャー・ツールは、以下のプロパティーが定義されている必要があります。
- com.ibm.websphere.client.launcher.main
- 実行されるクライアントがシン・クライアントである場合、 このプロパティーを指定する必要があります。 アプリケーションのメイン・エントリー・ポイントがあるクラスを指定します。 これは、シン・アプリケーション・クライアントのメイン・クラス名です。 これが設定されている場合、ランチャーは、クライアント・コンテナーを開始しないで、代わりに、アプリケーションの main メソッドを直接呼び出します。 ただし、com.ibm.websphere.client.launcher.ear も設定されている場合、それは無視されます。
- com.ibm.websphere.client.launcher.ear
- 実行するクライアントが Java Platform, Enterprise Edition (Java EE) クライアントである場合、 このプロパティーを指定する必要があります。 実行される EAR ファイルの名前を指定します。 指定する必要があるプロパティーは 2 つのうちの 1 つのみですが、このプロパティーは com.ibm.websphere.client.launcher.main よりも優先されます。
com.ibm.websphere.client.launcher.ear が設定されている場合、JWS のアプリケーション・クライアント・ランチャーは、lauchClient コマンド行ツールがサポートする、ほとんどすべての -CC 引数をサポートします。 ただし、com.ibm.websphere.client.launcher.main のみが設定されている場合、ランチャーは -CCD 引数のみをサポートします。 次の表に、launchClient コマンド行ツールと JWS のアプリケーション・クライアント・ランチャーでサポートされる -CC 引数の比較を示します。
| -CC 引数 | launchClient | JWS のアプリケーション・クライアント・ランチャー |
|---|---|---|
| -CCverbose | はい | はい |
| -CCjar | はい | はい |
| -CCclasspath | はい | 該当なし |
| -CCadminConnectorHost | はい | はい |
| -CCadminConnectorPort | はい | はい |
| -CCadminConnectorType | はい | はい |
| -CCadminConnectorUser | はい | はい |
| -CCaltDD | はい | はい |
| -CCBootstrapHost | はい | はい |
| -CCBootstrapPort | はい | はい |
| -CCproviderURL | はい | はい |
| -CCinitonly | はい | 該当なし |
| -CCtrace | はい | はい |
| -CCtracefile | はい | はい |
| -CCsecurityManager | はい | 該当なし |
| -CCsecurityMgrClass | はい | 該当なし |
| -CCsecurityMgrPolicy | はい | 該当なし |
| -CCD | はい | はい |
| -CCexitVM | はい | はい |
| -CCdumpJavaNameSpace | はい | はい |
| -CCsoapConnectorPort | はい | はい |
| -CCtraceMode | はい | はい |
| -CCclassLoaderMode | はい | はい |
-CCD 引数のマクロ展開は、JWS のアプリケーション・クライアント・ランチャーによってサポートされます。
ランチャーは、特定のマクロ鍵 (${…} で囲まれた) を実行時の計算値に自動的に置き換えます。
例えば、アプリケーション・クライアント JNLP のマニフェスト・ファイル内の -CCD 引数でマクロ鍵が使用される場合などです。
<argument>-CCDcom.ibm.ssl.keyStore= ${WAS_ROOT}/etc/key.p12</argument>
これは、JWS キャッシュのインストール・ルート・ロケーションに展開され、引数は次のようになります。-CCDcom.ibm.ssl.keyStore=/home/tiu/.java/deployment/cache/javaws/ext/E1134532441112/etc/key12.p12次の表に、現在サポートされており、ランチャーによって置換される 3 つのマクロ鍵を示します。
| マクロ鍵 | 値 |
|---|---|
| ${WAS_ROOT} | アプリケーション・クライアント・コンテナーおよび JWS のランタイム・インストーラーによって使用される、JWS キャッシュ内のインストール・ルート・ロケーション。 |
| ${JAVA_HOME} | Java ホームのロケーション。 System.getProperty(“java.home”) の戻り値。 |
| ${USER_HOME} | ユーザー・ホームのロケーション。 System.getProperty(“user.home”) の戻り値。 |
参照トピック