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

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

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

(1) ファイル名

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

cjrconf.properties

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

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

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

(3) 設定項目

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

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

項番設定項目キー名称指定内容デフォルト値
1稼働ログの出力レベルcom.cosminexus.jaxrs.logger.runtime.message.level稼働ログの出力レベルを指定します。
ERROR,WARN,INFO,DEBUG,NONEのどれかを指定します。各指定値に対応した出力内容については,「39.3.4 ログの重要度と出力条件」を参照してください。
INFO
2稼働ログの面数com.cosminexus.jaxrs.logger.runtime.message.file_num稼働ログの面数を指定します。
数字(1~16)を指定します。
2
3稼働ログの容量com.cosminexus.jaxrs.logger.runtime.message.file_size稼働ログの容量を指定します。
4096~16777216​の数字(単位:バイト)を指定します。
2097152​
4保守ログの出力com.cosminexus.jaxrs.logger.runtime.maintenance.level保守ログを出力するかどうかを指定します。
ALLを指定した場合
保守ログが出力されます。
NONEを指定した場合
保守ログが出力されません。
ALL
5保守ログの面数com.cosminexus.jaxrs.logger.runtime.maintenance.file_num保守ログの面数を指定します。
1~16の数字を指定します。
2
6保守ログの容量com.cosminexus.jaxrs.logger.runtime.maintenance.file_size保守ログの容量を指定します。
4096~16777216​の数字(単位:バイト)を指定します。
16777216​
7例外ログの出力レベルcom.cosminexus.jaxrs.logger.runtime.exception.level例外ログの出力レベルを指定します。ERROR,WARN,INFO,DEBUG,NONEのどれかを指定します。各指定値に対応した出力内容については,「39.3.4 ログの重要度と出力条件」を参照してください。INFO
8例外ログの面数com.cosminexus.jaxrs.logger.runtime.exception.file_num例外ログの面数を指定します。1~16の数字を指定します。2
9例外ログの容量com.cosminexus.jaxrs.logger.runtime.exception.file_size例外ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。16777216​
10通信ログの出力
レベル(Webリソース側)※1
com.cosminexus.jaxrs.logger.runtime.transport.server.levelWebリソース側での通信ログの出力レベルを指定します。※2
NONEを指定した場合
通信ログが出力されません。
ALLを指定した場合
送受信したHTTPヘッダとエンティティボディの両方が常に通信ログに出力されます。
HEADERを指定した場合
送受信したメッセージのHTTPヘッダが常に通信ログに出力されます。
NONE
11通信ログの出力
レベル(Webリソースクライアント側)
com.cosminexus.jaxrs.logger.runtime.transport.client.levelWebリソースクライアント側での通信ログの出力レベルを指定します。※2
NONEを指定した場合
通信ログが出力されません。
ALLを指定した場合
送受信したHTTPヘッダとエンティティボディの両方が常に通信ログに出力されます。
HEADERを指定した場合
送受信したメッセージのHTTPヘッダが常に通信ログに出力されます。
NONE
12通信ログの面数com.cosminexus.jaxrs.logger.runtime.transport.file_num通信ログの面数を指定します。1~16の数字で指定します。2
13通信ログの容量com.cosminexus.jaxrs.logger.runtime.transport.file_size通信ログの容量を指定します。4096~16777216​の数字(単位:バイト)を指定します。16777216​
14通信ログの文字エンコーディングcom.cosminexus.jaxrs.logger.runtime.transport.encoding通信ログの文字エンコーディングを指定します。J2SE 6.0でサポートされているエンコーディングについては,J2SE 6.0のドキュメントを確認してください。
DEFAULTを指定した場合,通信ログのエンコーディングはデフォルトのプラットフォームエンコーディングとなります。
DEFAULT
15WADLの発行の抑止※1com.sun.jersey.config.feature.DisableWADLWADLの発行を抑止するかどうかを指定します。※2
trueを指定した場合
WADLの発行を抑止します。
falseを指定した場合
WADLの発行を抑止しません。
false
16JSON POJOマッピングの有効化※1,※3com.sun.jersey.api.json.POJOMappingFeatureJSON POJOマッピングを有効にするかどうかを指定します。※2
trueを指定した場合
JSON POJOマッピングを有効にします。
falseを指定した場合
JSON POJOマッピングを有効にしません。
false
17自動リダイレクト※3com.sun.jersey.client.property.followRedirectsHTTPリダイレクト(HTTPステータスコードが300番台の要求)に自動的に従うべきかどうかを設定します。
trueを指定した場合
HTTPリダイレクトに自動的に従います。
falseを指定した場合
HTTPリダイレクトに自動的には従いません。
この項目を指定したときの動作は,Java SEのHttpURLConnectionクラスのsetInstanceFollowRedirectsメソッドで引数にこの項目の設定値を指定して呼び出した場合と同じになります。※2
true
18クライアントソケットの接続タイムアウト値※3com.sun.jersey.client.property.connectTimeoutクライアントソケットの接続タイムアウト値を指定します。
このプロパティで指定したタイムアウト値は,Webリソース呼び出し時に適用されます。
0~2147483647​の数字(単位:ミリ秒)を指定します。0を指定した場合,タイムアウトされません。
OSのTCP接続に関連する設定を変更している場合,OSの設定値が優先されることがあります。
0
19クライアントソケットの読み込みタイムアウト値※3com.sun.jersey.client.property.readTimeoutクライアントソケットの読み込みタイムアウト値を指定します。
このプロパティで指定したタイムアウト値は,Webリソース呼び出し時に適用されます。
0~2147483647​の数字(単位:ミリ秒)を指定します。0を指定した場合,タイムアウトされません。
OSのTCP接続に関連する設定を変更している場合,OSの設定値が優先されることがあります。
0
20チャンク転送エンコーディング※3com.sun.jersey.client.property.chunkedEncodingSizeチャンク転送エンコーディングを使用するかどうかを,0~2147483647​の数字(単位:ミリ秒)で指定します。0を指定した場合,デフォルト値が適用されます。
この項目を指定したときの動作は,Java SEのHttpURLConnectionクラスのsetChunkedStreamingModeメソッドで引数にこの項目の設定値を指定して呼び出した場合と同じになります。
4096
21例外発生時のレスポンスエンティティのバッファリング※3com.sun.jersey.client.property.bufferResponseEntityOnExceptionUniformInterfaceExceptionが発生した場合,HTTPレスポンスにエンティティがあれば,自動的にバッファリングし,ストリームを閉じるかどうかを指定します。※2
trueを指定した場合
HTTPレスポンスのエンティティを自動的にバッファリングし,ストリームを閉じます。
falseを指定した場合
HTTPレスポンスのエンティティのストリームは自動的には閉じられません。
true
注※1
Webリソース側では,プロパティに指定した値より,サーブレット初期化パラメタに指定した値が優先されます。
注※2
プロパティの値は大文字と小文字とが区別されません。無効な値が指定されている場合は,デフォルト値と見なされます。
注※3
クライアント側では,プロパティに指定した値より,クライアントAPIで指定した値が優先されます。

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

プロセス別の定義ファイルを使用していないすべてのJ2EEサーバを停止してから,共通定義ファイルの設定を変更してください。プロセス別の定義ファイルについては,「10.1.3 プロセス別の定義ファイルの設定」を参照してください。

ログ関連の設定を変更する場合,必要に応じてログを退避してから設定を変更してください。