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

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

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

スタンドアロンクライアントはNexaweb ApplicationをJava.Applicationとして実行することができます。

Command Line Syntax

スタンドアロンクライアントを実行するコマンドライン構文は以下のフォーマットになります:

java-classpathclassnameparameters

実際の最もシンプルなコマンドライン構文は以下のようになります:

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