スタンドアロンクライアント
このドキュメントはスタンドアロンクライアントをコマンドラインからパラメータを指定して起動する方法について記述します。
スタンドアロンクライアントはNexaweb ApplicationをJava.Applicationとして実行することができます。
Command Line Syntax
スタンドアロンクライアントを実行するコマンドライン構文は以下のフォーマットになります:
java -classpath classname parameters
実際の最もシンプルなコマンドライン構文は以下のようになります:
java -classpath NexawebImages.jar;NexawebStandaloneClient.jar com.nexaweb.client.standalone.StandaloneClient -server http://server-name:8080 -initialPage index.xal -appcontext /AppContext
コマンドラインフォーマットの各引数には以下のように設定します:
- classpath: -classpath NexawebImages.jar;NexawebStandaloneClient.jar
- classname: com.nexaweb.client.standalone.StandaloneClient
- parameters: -server http://server-name:8080 -initialPage index.xal -appcontext /AppContext
Classpath
コマンドライン構文の classpath セクションはスタンドアロンクライアントを起動するために必要なクラスを含むセミコロン(;)によって分離された複数のJARファイルのリストを指定します。
必須となるクラスは以下のJARファイル(これらの JAR ファイルは Nexaweb Platformインストールフォルダ直下の bin フォルダ以下に配置されています)になります:
| Class | Description |
NexawebImages.jar | Standalone client images |
| NexawebStandaloneClient.jar | Standalone client classes |
さらに、上記に加えてアプリケーションで使用される全てのクラスファイルをJARファイルにして指定する必要があります
また、古いNXMLベースのNexaweb ApplicationもしくはNFC/XFCを使用しているアプリケーションをスタンドアロンクライアントで稼働させる場合は、以下のJARファイルも classpath に含める必要があります:
| Class | Description |
| nexaweb-nfc.jar | Nexaweb Foundation classes. Required for NXML applications only. |
Classname
以下のクラスを指定します。
- com.nexaweb.client.standalone.StandaloneClient
Parameters
コマンドライン構文の parameters セクションは、Nexawebのパラメーターをパラメータ名と設定値のペアリストとして指定する事ができます。
コマンドラインからスタンドアロンクライアントを起動させる場合、ブラウザ上で Java Appletとして起動させる場合と違ってnexaweb-client.xmlの設定内容を自動的に反映しません。
nexawe-client.xmlの設定内容をスタンドアロンクライアントで有効にするためには手動でコマンドラインのパラメータとして指定する必要があります。
以下の表は、スタンドアロンクライアントを起動させるために最低限必要となるパラメータです:
| Parameter | Description |
| -server http://servername:8080 | サーバー情報を指定します。 |
| -initialPage index.xal | アプリケーションの初期起動ページを指定します。 |
| -appcontext /TestApp | サーバー上のアプリケーションコンテキストを指定します。 |
また、任意で以下のスタンドアロンクライアント固有のパラメータを指定することができます。
| Parameter | Description |
| -width 800 | アプリケーション起動時のサイズに関する設定 |
| -height 600 | アプリケーション起動時のサイズに関する設定 |
| -x 240 | アプリケーション起動時の表示位置に関する設定 |
| -y 212 | アプリケーション起動時の表示位置に関する設定 |
| -maximized true | アプリケーション起動時のウインドウの最大化表示に関する設定 |
| -splash classpath://Nexaweb/stylesheets/nexaweb2004/images/messagedialog_warn.gif | スプラッシュ画面として表示される画像ファイルの設定 |
| -splashTime 5000 | スプラッシュ画面が表示される時間(ミリ秒単位)の設定 |
また、任意で以下のnexaweb-client.xmlの設定内容をパラメータとして指定することができます。
| Parameter |
| -adjust-row-height-enable false |
| -anti-alias-minimum-font-size 18 |
| -application-type XAL |
| -client-connection-timeout -1 |
| -debug-keys-enabled true |
| -default-style-sheet Nexaweb/stylesheets/nexaweb2004/xal-stylesheet.xml |
| -dialog-buffer-enable true |
| -display-wait-cursor-for-mco-calls false |
| -downscale-quality low |
| -enableHttpRequestMethodCompatible false |
| -ensurePreBugFixTableStateChangeBehaviorOnMouseDown false |
| -ensurePreFourDotTwoMacroCompatibility false |
| -ensurePreFourDotTwoMcoStringArgumentCompatibility false |
| -ensurePreFourDotTwoResolutionSyntaxCompatibility false |
| -ignore-scrollWheelEvent-on-disabled true |
| -keep-last-client-event false |
| -layered-pane-type swing-layered-pane |
| -log-configuration/consumers/consumer0 com.nexaweb.util.ConsoleLogConsumer |
| -log-configuration/consumers/consumer1 com.nexaweb.client.log.DialogLogConsumer |
| -log-configuration@default-log-level exception |
| -open-push-without-protocol true |
| -permitted-resize-cursor-width 6 |
| -persistent-connection-ping-interval 45000 |
| -persistent-connection-ping-latency-tolerance 2000 |
| -style-sheet-0 Nexaweb/stylesheets/nexaweb2004/stylesheet.xml |
| -synchronize-nexaweb-server-requests false |
| -systemcolor-configuration/systemColor*** #FAAC4E |
| -tab-to-radio-groups false |
| -tag-map-file-*** customtag.xml |
| -test-ids-generate-unique true |
| -test-ids-show-ancestors false |
| -tooltip-delay 500 |
| -tooltip-linebreak-enable true |
| -upscale-quality low |
| -use-http-request-header-for-session-id true |
| -useRootElementAsContextInsteadOfDocument false |
| -window-deactivation-policy release-focus |
| -windows-style-restore false |
さらに、アプリケーションがプラグインを使用している場合、プラグインのための指定を行う必要があります。
プラグインを使用している場合、プラグインのJARファイルは/WebContent/WEB-INF/client/pluginsディレクトリ以下に配置されます。
プラグインのJARファイルは全て classpath に指定する必要があります。
また、プラグインを利用するためには以下のパラメータを指定する必要があります。:
| Parameter | Description |
-plugin-key-0 nxplugin-PluginAccessibility | Name : -plugin-key-# 重複しない数値を0から記述します。複数のプラグインを指定する場合にキーの重複を避けるために必要です。 Value : |