10.1.2 共通定義ファイルの設定項目

共通定義ファイルを使用して,システム共通の動作定義を設定します。共通定義ファイルのファイル名,保存ディレクトリ名,および設定項目について説明します。

<この項の構成>
(1) ファイル名
(2) 保存先ディレクトリ
(3) 設定項目
(4) 設定を変更する場合

(1) ファイル名

共通定義ファイルのファイル名を示します。

cjwconf.properties

(2) 保存先ディレクトリ

共通定義ファイルの保存先ディレクトリを示します。保存先ディレクトリは固定です。

<Application Serverのインストールディレクトリ>¥jaxws¥conf

(3) 設定項目

設定するキー名称と指定内容の一覧を次の表に示します。

表10-1 共通定義ファイルの設定項目

項番設定項目キー名称指定内容デフォルト値コンテキスト
1稼働ログの出力レベルcom.cosminexus.jaxws.logger.runtime.message.level稼働ログの出力レベルを指定します。
ERROR,WARN,INFO,DEBUG,NONEのどれかを指定します。各指定値に対応した出力内容については,「39.3.4 ログの重要度と出力条件」を参照してください。
INFO
2稼働ログの面数com.cosminexus.jaxws.logger.runtime.message.file_num稼働ログの面数を指定します。
数字(1~16)を指定します。
2
3稼働ログの容量com.cosminexus.jaxws.logger.runtime.message.file_size稼働ログの容量を指定します。
4096~16777216​の数字(単位:バイト)を指定します。
2097152​
4保守ログの出力com.cosminexus.jaxws.logger.runtime.maintenance.level保守ログを出力するかどうかを指定します。
ALLを指定した場合
保守ログが出力されます。
NONEを指定した場合
保守ログが出力されません。
ALL
5保守ログの面数com.cosminexus.jaxws.logger.runtime.maintenance.file_num保守ログの面数を指定します。
1~16の数字を指定します。
2
6保守ログの容量com.cosminexus.jaxws.logger.runtime.maintenance.file_size保守ログの容量を指定します。
4096~16777216​の数字(単位:バイト)を指定します。
16777216​
7例外ログの出力レベルcom.cosminexus.jaxws.logger.runtime.exception.level例外ログの出力レベルを指定します。ERROR,WARN,INFO,DEBUG,NONEのどれかを指定します。各指定値に対応した出力内容については,「39.3.4 ログの重要度と出力条件」を参照してください。INFO
8例外ログの面数com.cosminexus.jaxws.logger.runtime.exception.file_num例外ログの面数を指定します。1~16の数字を指定します。2
9例外ログの容量com.cosminexus.jaxws.logger.runtime.exception.file_size例外ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。16777216​
10通信ログの出力レベル
(Webサービスクライアント側)
com.cosminexus.jaxws.logger.runtime.transport.client_dumpWebサービスクライアント側での通信ログの出力レベルを指定します。
NONEを指定した場合
Webサービスクライアントでは通信ログが出力されません。
ALLを指定した場合
Webサービスクライアントで送受信したメッセージが常に通信ログに出力されます。
HEADERを指定した場合
Webサービスクライアントで受信したメッセージのHTTPヘッダが常に通信ログに出力されます。
ERROR_HEADERを指定した場合
SOAPFaultを受信した場合に,受信したメッセージのHTTPヘッダが通信ログに出力されます。
注意事項
ALLを指定した場合,送受信するメッセージの長さによってはjava.lang.OutOfMemoryError例外が発生することがあります。その場合はJVMのヒープサイズを調整してください。
ERROR_HEADER
11通信ログの出力レベル
(Webサービス側)
com.cosminexus.jaxws.logger.runtime.transport.server_dumpWebサービス側での通信ログの出力レベルを指定します。
NONEを指定した場合
Webサービス側では通信ログが出力されません。
ALLを指定した場合
Webサービス側で送受信したメッセージが常に通信ログに出力されます。
HEADERを指定した場合
Webサービス側で受信したメッセージのHTTPヘッダが常に通信ログに出力されます。
ERROR_HEADER
SOAPFaultを送信する場合に,受信したメッセージのHTTPヘッダが通信ログに出力されます。
なお,受信時のメッセージを出力する場合は,HTTPのリクエスト情報も出力されます。
注意事項
ALLを指定した場合,送受信するメッセージの長さによってはjava.lang.OutOfMemoryError例外が発生することがあります。その場合はJavaVMのヒープサイズを調整してください。
ERROR_HEADER
12通信ログの面数com.cosminexus.jaxws.logger.runtime.transport.file_num通信ログの面数を指定します。1~16の数字を指定します。2
13通信ログの容量com.cosminexus.jaxws.logger.runtime.transport.file_size通信ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。16777216​
14通信ログの文字エンコーディングcom.cosminexus.jaxws.logger.runtime.transport.encoding通信ログの文字エンコーディングを指定します。J2SE 6.0でサポートされている文字エンコーディングについては,J2SE 6.0のドキュメントを参照してください。
"DEFAULT"を指定した場合,通信ログの文字エンコーディングはデフォルトのプラットフォームエンコーディングとなります。
DEFAULT
15稼働ログの出力レベル(cjwsimport)com.cosminexus.jaxws.logger.cjwsimport.message.levelcjwsimportコマンドの稼働ログの出力レベルを指定します。ERROR,WARN,INFO,DEBUG,NONEのどれかを指定します。各指定値に対応した出力内容については,「39.3.4 ログの重要度と出力条件」を参照してください。INFO
16稼働ログの面数(cjwsimport)com.cosminexus.jaxws.logger.cjwsimport.message.file_numcjwsimportコマンドの稼働ログの面数を指定します。1~16の数字を指定します。2
17稼働ログの容量(cjwsimport)com.cosminexus.jaxws.logger.cjwsimport.message.file_sizecjwsimportコマンドの稼働ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。2097152​
18例外ログの出力レベル(cjwsimport)com.cosminexus.jaxws.logger.cjwsimport.exception.levelcjwsimportコマンドの例外ログの出力レベルを指定します。ERROR,WARN,INFO,DEBUG,NONEのどれかを指定します。各指定値に対応した出力内容については,「39.3.4 ログの重要度と出力条件」を参照してください。INFO
19例外ログの面数(cjwsimport)com.cosminexus.jaxws.logger.cjwsimport.exception.file_numcjwsimportコマンドの例外ログの面数を指定します。1~16の数字を指定します。2
20例外ログの容量(cjwsimport)com.cosminexus.jaxws.logger.cjwsimport.exception.file_sizecjwsimportコマンドの例外ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。16777216​
21保守ログの出力(cjwsimport)com.cosminexus.jaxws.logger.cjwsimport.maintenance.levelcjwsimportコマンドの保守ログを出力するかどうかを指定します。
ALLを指定した場合
保守ログが出力されます。
NONEを指定した場合
保守ログが出力されません。
ALL
22保守ログの面数(cjwsimport)com.cosminexus.jaxws.logger.cjwsimport.maintenance.file_numcjwsimportコマンドの保守ログの面数を指定します。1~16の数字を指定します。2
23保守ログの容量(cjwsimport)com.cosminexus.jaxws.logger.cjwsimport.maintenance.file_sizecjwsimportコマンドの保守ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。16777216​
24稼働ログの出力レベル(cjapt)com.cosminexus.jaxws.logger.apt.message.levelcjaptコマンドの稼働ログの出力レベルを指定します。ERROR,WARN,INFO,DEBUG,NONEのどれかを指定します。各指定値に対応した出力内容については,「39.3.4 ログの重要度と出力条件」を参照してください。INFO
25稼働ログの面数(cjapt)com.cosminexus.jaxws.logger.apt.message.file_numcjaptコマンドの稼働ログの面数を指定します。1~16の数字を指定します。2
26稼働ログの容量(cjapt)com.cosminexus.jaxws.logger.apt.message.file_sizecjaptコマンドの稼働ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。2097152​
27例外ログの出力レベル(cjapt)com.cosminexus.jaxws.logger.apt.exception.levelcjaptコマンドの例外ログの出力レベルを指定します。ERROR,WARN,INFO,DEBUG,NONEのどれかを指定します。各指定値に対応した出力内容については,「39.3.4 ログの重要度と出力条件」を参照してください。INFO
28例外ログの面数(cjapt)com.cosminexus.jaxws.logger.apt.exception.file_numcjaptコマンドの例外ログの面数を指定します。1~16の数字を指定します。2
29例外ログの容量(cjapt)com.cosminexus.jaxws.logger.apt.exception.file_sizecjaptコマンドの例外ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。16777216​
30保守ログの出力(cjapt)com.cosminexus.jaxws.logger.apt.maintenance.levelcjaptコマンドの保守ログを出力するかどうかを指定します。
ALLを指定した場合
保守ログが出力されます。
NONEを指定した場合
保守ログが出力されません。
ALL
31保守ログの面数(cjapt)com.cosminexus.jaxws.logger.apt.maintenance.file_numcjaptコマンドの保守ログの面数を指定します。1~16の数字を指定します。2
32保守ログの容量(cjapt)com.cosminexus.jaxws.logger.apt.maintenance.file_sizecjaptコマンドの保守ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。16777216​
33SOAPActionがない場合の動作オプションcom.cosminexus.jaxws.fault_omit_soapactionSOAPActionがない場合の動作オプションを指定します。
trueを指定した場合
SOAPActionヘッダがない場合,SOAPフォルトメッセージを返します。
falseを指定した場合
SOAPActionヘッダがない場合,SOAPActionヘッダの値が空文字として動作します。
true
34クライアントソケットの接続タイムアウト値com.cosminexus.jaxws.connect.timeoutクライアントソケットの接続タイムアウト値を指定します。
このプロパティで指定したタイムアウト値は,Webサービス呼び出し時と,Webサービス呼び出し前のjavax.xml.ws.Serviceクラス生成で発生するメタデータ(WSDL)取得時に適用されます。
0~2147483647​の数字(単位:ミリ秒)を指定します。0を指定した場合,タイムアウトされません。
OSのTCP接続に関連する設定を変更している場合,OSの設定値が優先されることがあります。
60000
35クライアントソケットの読み込みタイムアウト値com.cosminexus.jaxws.request.timeoutクライアントソケットの読み込みタイムアウト値を指定します。
このプロパティで指定したタイムアウト値は,Webサービス呼び出し時と,Webサービス呼び出し前のjavax.xml.ws.Serviceクラス生成で発生するメタデータ(WSDL)取得時に適用されます。
0~2147483647​の数字(単位:ミリ秒)を指定します。0を指定した場合,タイムアウトされません。
OSのTCP接続に関連する設定を変更している場合,OSの設定値が優先されることがあります。
300000
36ベーシック認証のユーザIDjavax.xml.ws.security.auth.usernameHTTP接続で使用するベーシック認証のユーザIDを指定します。
このプロパティで指定したユーザIDは,Webサービス呼び出し時と,Webサービス呼び出し前のjavax.xml.ws.Serviceクラス生成で発生するメタデータ(WSDL)取得時に適用されます。
なし
37ベーシック認証のパスワードjavax.xml.ws.security.auth.passwordHTTP接続で使用するベーシック認証のパスワードを指定します。
このプロパティで指定したパスワードは,Webサービス呼び出し時と,Webサービス呼び出し前のjavax.xml.ws.Serviceクラス生成で発生するメタデータ(WSDL)取得時に適用されます。
javax.xml.ws.security.auth.usernameを指定していない場合,有効になりません。
なし
38HTTPセッションの維持の有無javax.xml.ws.session.maintainHTTPセッションの維持の有無を指定します。HTTPセッションは同じポートオブジェクトを使用している範囲で維持されます。
trueの場合
セッションが維持されます。
falseの場合
セッションが維持されません。
false
39ハンドラチェイン設定ファイルの厳密な検証com.cosminexus.jaxws.validation.handlerchain.strictハンドラチェイン設定ファイルの検証を厳密に行うかどうかを指定します。ハンドラチェイン設定ファイルのjavaee:handler要素の子要素としてjavaee:handler-name要素が記述されていないとエラーになります。false
40HTTPリクエストに対するWSDLの発行com.cosminexus.jaxws.security.publish_wsdlWebサービスのURLに対して,クエリストリングが?wsdl,または?WSDLであるHTTP GETリクエストが送信された場合,そのWebサービスのWSDLを発行するかどうかを指定します。
trueを指定した場合
WSDLが発行されます。
falseを指定した場合
WSDLが発行されないで,405 Method Not Allowedが返されます。
true
41HTTPリクエストに対するWebサービスの情報表示com.cosminexus.jaxws.security.display_webservice_infoWebサービスに対して,GETによるHTTPリクエストが到着したとき,レスポンスとして,Webサービスの情報を表示するかどうかを指定します。
trueを指定した場合
そのリクエストURLに対応するWebサービスの情報が表示されます。
falseを指定した場合
405 Method Not Allowedが返されます。
false
42Webサービスで発生したJava例外の伝搬com.cosminexus.jaxws.fault.SOAPFaultBuilder.captureStackTraceWebサービスで発生したJava例外をWebサービスクライアントに伝搬するかどうかを指定します。
trueを指定した場合
例外が伝搬されます。
falseを指定した場合
例外が伝搬されません。
false
43ログの出力先ディレクトリcom.cosminexus.jaxws.tool.log.directorycjwsimportコマンド,cjaptコマンド,およびcjwsgenコマンドが出力するログの出力先ディレクトリを指定します。<Application Serverのインストールディレクトリ>/jaxws/logs
44プロキシサーバの認証ユーザIDcom.cosminexus.jaxws.http.proxyUserプロキシサーバの認証ユーザIDを指定します。Webサービスクライアントが,プロキシサーバを使用して外部のネットワークにあるWebサービスを呼び出す場合に,必要に応じて指定してください。
このプロパティで指定したユーザIDは,Webサービス呼び出し時と,Webサービス呼び出し前のjavax.xml.ws.Serviceクラス生成で発生するメタデータ(WSDL)取得時に適用されます。
なし
45プロキシサーバの認証ユーザIDに対応するパスワードcom.cosminexus.jaxws.http.proxyPasswordプロキシサーバの認証ユーザIDに対応するパスワードを指定します。Webサービスクライアントが,プロキシサーバを使用して外部のネットワークにあるWebサービスを呼び出す場合に,必要に応じて指定してください。
このプロパティで指定したパスワードは,Webサービス呼び出し時と,Webサービス呼び出し前のjavax.xml.ws.Serviceクラス生成で発生するメタデータ(WSDL)取得時に適用されます。
なし
46SSLプロトコルによる接続で使用するプロキシサーバの認証ユーザIDcom.cosminexus.jaxws.https.proxyUserSSLプロトコルによる接続で使用する,プロキシサーバの認証ユーザIDを指定します。Webサービスクライアントが,プロキシサーバを使用して外部のネットワークにあるWebサービスを呼び出す場合で,SSLプロトコルによる接続のときに,必要に応じて指定してください。
このプロパティで指定したユーザIDは,Webサービス呼び出し時と,Webサービス呼び出し前のjavax.xml.ws.Serviceクラス生成で発生するメタデータ(WSDL)取得時に適用されます。
なし
47SSLプロトコルによる接続で使用するプロキシサーバの認証ユーザIDに対応するパスワードcom.cosminexus.jaxws.https.proxyPasswordSSLプロトコルによる接続で使用する,プロキシサーバの認証ユーザIDに対応するパスワードを指定します。Webサービスクライアントが,プロキシサーバを使用して外部のネットワークにあるWebサービスを呼び出す場合で,SSLプロトコルによる接続のときに,必要に応じて指定してください。このプロパティで指定したユーザIDは,Webサービス呼び出し時と,Webサービス呼び出し前のjavax.xml.ws.Serviceクラス生成で発生するメタデータ(WSDL)取得時に適用されます。なし
48稼働ログの出力レベル(cjwsgen)com.cosminexus.jaxws.logger.cjwsgen.message.levelcjwsgenコマンドの稼働ログの出力レベルを指定します。ERROR,WARN,INFO,DEBUG,NONEのどれかを指定します。各指定値に対応した出力内容については,「39.3.4 ログの重要度と出力条件」を参照してください。INFO
49稼働ログの面数(cjwsgen)com.cosminexus.jaxws.logger.cjwsgen.message.file_numcjwsgenコマンドの稼働ログの面数を指定します。1~16の数字を指定します。2
50稼働ログの容量(cjwsgen)com.cosminexus.jaxws.logger.cjwsgen.message.file_sizecjwsgenコマンドの稼働ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。2097152​
51例外ログの出力レベル(cjwsgen)com.cosminexus.jaxws.logger.cjwsgen.exception.levelcjwsgenコマンドの例外ログの出力レベルを指定します。ERROR,WARN,INFO,DEBUG,NONEのどれかを指定します。各指定値に対応した出力内容については,「39.3.4 ログの重要度と出力条件」を参照してください。INFO
52例外ログの面数(cjwsgen)com.cosminexus.jaxws.logger.cjwsgen.exception.file_numcjwsgenコマンドの例外ログの面数を指定します。1~16の数字を指定します。2
53例外ログの容量(cjwsgen)com.cosminexus.jaxws.logger.cjwsgen.exception.file_sizecjwsgenコマンドの例外ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。16777216​
54保守ログの出力(cjwsgen)com.cosminexus.jaxws.logger.cjwsgen.maintenance.levelcjwsgenコマンドの保守ログを出力するかどうか指定します。
ALLを指定した場合
保守ログが出力されます。
NONEを指定した場合
保守ログが出力されません。
ALL
55保守ログの面数(cjwsgen)com.cosminexus.jaxws.logger.cjwsgen.maintenance.file_numcjwsgenコマンドの保守ログの面数を指定します。1~16の数字を指定します。2
56保守ログの容量(cjwsgen)com.cosminexus.jaxws.logger.cjwsgen.maintenance.file_sizecjwsgenコマンドの保守ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。16777216​
57soap12:binding要素のtransport属性の指定com.cosminexus.jaxws.publish_wsdl.soap12bindingSOAP1.2の場合に,クエリストリングが?wsdlまたは?WSDLであるHTTP GETリクエストで発行されたWSDLで,wsdl:binding要素の子要素であるsoap12:binding要素のtransport属性に,http://schemas.xmlsoap.org/soap/httpを設定するかどうかを指定します。
DEFAULT
soap12:binding/@transport属性値を
"http://www.w3.org/2003/05/soap/bindings/HTTP/"にします。
WSI_BP20_TRANSPORT
soap12:binding/@transport属性値を
"http://schemas.xmlsoap.org/soap/http"にします。
DEFAULT
58SSL接続におけるホスト名検証の有無com.cosminexus.xml.ws.client.http.HostnameVerificationPropertyWebサービスクライアントがSSLプロトコルによる接続を行う場合,次に示す検証を省略するかどうかを指定します。
検証内容:エンドポイントアドレスに含まれるホスト名と,証明書のホスト名が一致しているかどうか。
true
検証を省略します。
false
検証を省略しません。
このプロパティで指定したSSL接続におけるホスト名検証の有無は,Webサービス呼び出し時と,Webサービス呼び出し前のjavax.xml.ws.Serviceクラス生成で発生するメタデータ(WSDL)取得時に適用されます。
false
(凡例)
○:メッセージコンテキストとして設定できることを示します。
-:メッセージコンテキストとして設定できないことを示します。
注※
メッセージコンテキストへの指定が有効になるのはWebサービス呼び出し時だけで,Webサービス呼び出し前のjavax.xml.ws.Serviceクラス生成で発生するメタデータ(WSDL)取得時には適用されません。
メタデータ取得時にベーシック認証の情報,またはSSL接続におけるホスト名検証の有無を設定する場合は,共通定義ファイルまたはプロセス別の定義ファイルに記述するか,別途WSDLをローカルマシンにダウンロードして使用してください(ローカルマシンにあるWSDLを使用する場合は,メタデータ取得時にリモートマシンへの接続が発生しません)。WSDLから別途インポートされるWSDLがある場合は,インポートされるWSDLもローカルマシン上にダウンロードしてください。
また,このプロパティにメッセージコンテキストでtrueまたはfalseを設定する場合は,java.lang.String型の文字列で設定してください。java.lang.String型以外の文字列以外で設定した場合の動作は保証されません。詳細については,「19.2.5(2)(k) com.cosminexus.xml.ws.client.http.HostnameVerificationPropertyプロパティの設定方法」を参照してください。

(4) 設定を変更する場合

Webサービス側の設定を変更する場合
プロセス別の定義ファイルを使用していないすべてのJ2EEサーバを停止してから,共通定義ファイルの設定を変更してください。プロセス別の定義ファイルについては,「10.1.3 プロセス別の定義ファイルの設定」を参照してください。
ログ関連の設定を変更する場合,必要に応じてログを退避してから設定を変更してください。
Webサービスクライアント側の設定を変更する場合
すべてのJ2EEサーバ(WebサービスクライアントをJ2EEアプリケーションとした場合),またはすべてのJavaアプリケーションを停止してから,共通定義ファイルの設定を変更してください。
ログ関連の設定を変更する場合,必要に応じてログを退避してから設定を変更してください。