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”) の戻り値。 |