Interstage Application Server/Interstage Web Server J2EE ユーザーズガイド

19.3.2 設定項目

　以下に設定項目を示します。

No.	設定項目	key名	省略可否	IJServer上で有効かどうか
1	Webサービスクライアントログファイルパス	com.fujitsu.interstage.isws.log.file.path	省略可	無効(注)
2	Webサービスクライアントログファイルの最大サイズ	com.fujitsu.interstage.isws.log.file.maxfilesize	省略可	無効(注)
3	Webサービスクライアントログファイルの最大世代数	com.fujitsu.interstage.isws.log.file.maxbackupindex	省略可	無効(注)
4	Webサービスクライアントで使用するSSL定義	com.fujitsu.interstage.isws.client.ssl.configname	省略可	有効
5	添付ファイルの一時ファイル作成場所	com.fujitsu.interstage.isws.attachment.tmpdir	省略可	有効
6	添付ファイル受信時に一時ファイルを生成せずメモリのみで扱うサイズの上限	com.fujitsu.interstage.isws.attachment.memory.cachesize	省略可	有効
7	レスポンス返却時の、Webサービスアプリケーションで受信した添付ファイルデータ削除(資源解放)	com.fujitsu.interstage.isws.attachment.tempfile.keepmode	省略可	有効
8	WSDLでtext/plainに指定された添付ファイルのデフォルト文字コード	com.fujitsu.interstage.isws.attachment.plaintext.charset	省略可	有効
9	非ascii文字の送信形式	com.fujitsu.interstage.isws.utf8encoder.notascii.charref	省略可	有効
10	ディレクトリサービスによる認証の有効化	com.fujitsu.interstage.isws.enable.directory.authentication	省略可	有効

　注) IJServer上ではWebサービスクライアントログファイルに関する設定は無効です。

　Webサービス設定ファイルは、Javaのプロパティファイルの仕様にしたがって記述してください。

例) 日本語などの ISO 8859-1 文字エンコーディングで直接表現できない文字はUnicodeエスケープを使用して記載する。

■Webサービスクライアントログファイルパス

com.fujitsu.interstage.isws.log.file.path

指定可能な値:
　出力ファイルパス(カレントディレクトリからの相対パス、またはフルパスで指定)
省略値:
　標準エラーに出力します。

使用例:
カレントディレクトリのlog.txtに出力

com.fujitsu.interstage.isws.log.file.path=log.txt

C:\tmp\log.txtに出力

com.fujitsu.interstage.isws.log.file.path=C:\\tmp\\log.txt

/tmp/log.txtに出力

com.fujitsu.interstage.isws.log.file.path=/tmp/log.txt

• Webサービスクライアントログファイルパスはプロセスごとに異なるファイルを指定してください。詳細は“Webサービスクライアントログファイル”を参照してください。
• ファイル出力先のディレクトリを用意する必要があります。
• 本項目で指定されたパスにアクセス権がない場合、あるいはディレクトリがない場合、標準エラーにエラーメッセージを出力し、処理を続行します。エラーメッセージ出力後のWebサービスクライアントログファイルおよび標準出力へのログ出力はおこないません。

■Webサービスクライアントログファイルの最大サイズ

com.fujitsu.interstage.isws.log.file.maxfilesize

指定可能な値:
　1〜2048(単位はMB)
省略値:
　10

使用例:
Webサービスクライアントログファイルの最大サイズを1024MB(1GB)とします。

com.fujitsu.interstage.isws.log.file.maxfilesize=1024

• 本項目はcom.fujitsu.interstage.isws.log.fileが指定されたときのみ有効です。
• 有効でない値を設定した場合、警告メッセージを標準エラー出力し、省略値の10を採用します。

■Webサービスクライアントログファイルの最大世代数

com.fujitsu.interstage.isws.log.file.maxbackupindex

指定可能な値:
　1〜100
省略値:
　5

使用例:
Webサービスクライアントログファイルの最大世代数を10とします。

com.fujitsu.interstage.isws.log.file.maxbackupindex=10

• 本項目はcom.fujitsu.interstage.isws.log.fileが指定されたときのみ有効です。
• 有効でない値を設定した場合、警告メッセージを標準エラー出力し、省略値の5を採用します。

■Webサービスクライアントで使用するSSL定義

com.fujitsu.interstage.isws.client.ssl.configname

指定可能な値:
　Interstage証明書環境に定義されたSSL定義名
省略値:
　なし

使用例:
WebサービスクライアントのSSL通信に、定義名“WSClientSSL”のSSL定義を使用します。

com.fujitsu.interstage.isws.client.ssl.configname=WSClientSSL

■添付ファイルの一時ファイル作成場所

com.fujitsu.interstage.isws.attachment.tmpdir

説明:
　一定以上のサイズの添付ファイルを受信する際、メモリ節約のため、内部的に一時ファイルが作成されます。また、添付ファイルに関するAPIを使用した場合も、一時ファイルが作成される場合があります。

指定可能な値:
　ディレクトリの絶対パス
　(ローカルシステムでJavaVMプロセスに書き込み権限があり十分な容量があること)
省略値:
　IJServer上で動作するアプリケーションの場合: JavaVMのカレント(システムプロパティ:user.dir)
　IJServer外で動作するアプリケーションの場合: JavaVMのTEMPフォルダ(システムプロパティ:java.io.tmpdir)
　これらのシステムプロパティの値がパスとして不正な場合、添付ファイルの受信に失敗します。

使用例:

D:\tmp\wsdataにプロセスごとにディレクトリが作成され、配下に一時ファイルが作成されます

com.fujitsu.interstage.isws.attachment.tmpdir=D:\\tmp\\wsdata

/var/tmp/wsdataにプロセスごとにディレクトリが作成され、配下に一時ファイルが作成されます

com.fujitsu.interstage.isws.attachment.tmpdir=/var/tmp/wsdata

• 作成場所には、呼量と添付ファイルのサイズ上限値に応じて十分なディスク容量を確保して下さい。
• サイズが大きいまたは大量の添付データを受信する場合は、容量が不足しても他に処理に影響を与えないよう、作成場所は独立したドライブまたはパーティションなどを用意する事を推奨します。
• Javaプロセスが異常終了した場合、作成場所に一時ファイルが残ることがあります。その場合は、手動で削除して下さい(Webサービスアプリケーションについては、IJServerで作成場所をカスタマイズしていない場合、カレントディレクトリがワークユニット機能管理下であれば(デフォルト)、一定回数再起動後に自動的に削除されます)。
• 作成場所は、Javaプロセスで書き込み可能なディレクトリである必要があります。またローカルシステム内のディレクトリである必要があります(リモートの共有ディレクトリなどは使用できません)。
• 指定したディレクトリ配下に“_iswsatttmp*”ディレクトリが作成され、一時ファイルが格納されます。“_iswsatttmp*”ディレクトリ配下に一時ファイル以外のファイルを格納しないでください。

■添付ファイル受信時に一時ファイルを生成せずメモリのみで扱うサイズの上限

com.fujitsu.interstage.isws.attachment.memory.cachesize

指定可能な値:
　0〜2147483647までの整数(Kバイト単位)。
　負の値が指定された場合は0、それ以外の不正な値が指定された場合は、省略値となります。
省略値:
　16(Kバイト)

使用例:
64Kバイトまでの添付ファイルは一時ファイルを生成せずメモリのみで扱います。

com.fujitsu.interstage.isws.attachment.memory.cachesize=64

■レスポンス返却時の、Webサービスアプリケーションで受信した添付ファイルデータ削除(資源解放)

com.fujitsu.interstage.isws.attachment.tempfile.keepmode

説明:
　Webサービスアプリケーションが、Webサービスクライアントから受信した添付ファイルデータをレスポンス返却後も保持するかどうかを指定します。

指定可能な値:
　trueまたはfalse(大文字と小文字は区別しません)。
　true以外の値が指定された場合はfalseになります。

　false(または省略値)を指定した場合、WebサービスアプリケーションがWebサービスクライアントから受信したDataHandlerオブジェクトと、そのデータ内容であるDataSourceオブジェクトは、レスポンス返却時に削除(資源解放)されることがあります。その場合、これらのオブジェクトは利用できなくなります。
　trueを選択した場合、レスポンス返却後も添付ファイルデータのオブジェクトは保持されます。

省略値:
　false

使用例:
レスポンス返却後も添付ファイルデータのオブジェクトを解放しません。

com.fujitsu.interstage.isws.attachment.tempfile.keepmode=true

• この項目をtrueに設定すると、添付ファイルデータのオブジェクトがGCによって回収されるまでは、一時ファイルは削除されません。そのため、一時ファイル作成場所に十分なディスク容量を確保するとともに、アプリケーションでは添付ファイルデータのオブジェクトの参照を不要に保持しないでください。
• DataSourceオブジェクトが解放される前に、DataHandlerオブジェクトのgetInputStreamメソッドで読み出したデータは、資源解放の対象とはなりません。アプリケーションで任意に利用及び解放が可能です。
• Webサービスクライアントでは、DataSourceオブジェクトの削除(資源解放)は、GCに任されます。

■WSDLでtext/plainに指定された添付ファイルのデフォルト文字コード

com.fujitsu.interstage.isws.attachment.plaintext.charset

説明:
　WSDL中のmime:content要素でtype属性がtext/plainとなっている添付ファイルについて、どの文字コードで送信するか、および、受信時にも文字コードが不明な場合にどの文字コードで受信するかを指定します。

指定可能な値:
　US-ASCII
　ISO-8859-1
　UTF-16
　など使用するJDKでサポートしている文字コード
省略値:
　UTF-8

使用例:
ISO-8859-1で送信し、受信時に文字コードが不明な場合はISO-8859-1として解釈します。

com.fujitsu.interstage.isws.attachment.plaintext.charset=ISO-8859-1

■非ascii文字の送信形式

com.fujitsu.interstage.isws.utf8encoder.notascii.charref

説明:
　SOAP通信における文字列データ中の非ascii文字を、そのままの文字で送信するか、XMLの文字参照形式に変換してascii文字を用いて送信するかを指定します。
　XML規約に従っている限り、受信側でこの変更によるデータの違いは発生しません。通常は本設定項目を変更する必要はありません。

指定可能な値:
　trueまたはfalse(大文字と小文字は区別しません)。
　true以外の値が指定された場合はfalseになります。
省略値:
　false

使用例:
通信における文字列データ中の非ascii文字をXMLの文字参照形式に変換してascii文字を用いて送信します。

com.fujitsu.interstage.isws.utf8encoder.notascii.charref=true

• 本設定項目をtrueに指定した場合、JIS X 0213:2004においてJIS X 0208から追加された文字の一部など、Unicodeの基本多言語面以外に割り当てられた文字(Javaのchar型においてサロゲートペアによって表現される文字)は正しく送信できません。
• 本設定項目は、添付ファイル型の添付ファイルデータ内の文字列データの送信形式には影響しません。

■ディレクトリサービスによる認証の有効化

com.fujitsu.interstage.isws.enable.directory.authentication

説明:
　JNDIを使用してServiceをlookupするWebサービスクライアントアプリケーションが、ディレクトリサービスが認証した情報を使用してHTTPリクエストの送信を行うかを指定します。本項目にtrueが設定された場合は、“HTTP接続に関する設定”の“Webサービスのユーザ名/パスワードを設定する方法”による設定のかわりに以下をBasic認証のユーザ名/パスワードとして使用します。

• J2EEアプリケーションクライアントの場合:
  JNDI環境プロパティに設定され、JNDIサービスプロバイダで認証されたユーザ名/パスワードを使用します。
• IJServer上のアプリケーションの場合:
  Webアプリケーションで認証されたユーザ名/パスワードを使用します。

指定可能な値:
　trueまたはfalse(大文字と小文字は区別しません)。
　true以外の値が指定された場合はfalseになります。
省略値:
　false

使用例:
ディレクリサービスが認証したユーザID/パスワードを使用します。

com.fujitsu.interstage.isws.enable.directory.authentication=true

• ServiceFactoryを使用してServiceオブジェクトを取得する場合は本設定項目は有効になりません。