スタンドアロンクライアント

このドキュメントはスタンドアロンクライアントをコマンドラインからパラメータを指定して起動する方法について記述します。

スタンドアロンクライアントは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 :
- The prefix: nxplugin-
- プラグインJARファイル名(.JAR拡張子を除く)。PluginAccessibility