Cosminexus V9 BPM/ESB基盤 サービスプラットフォーム リファレンス
形式
[urecp-http.context-root=HTTP受付のコンテキストルート] [urecp-http.max-threads=HTTP受付の最大同時実行スレッド数] [urecp-http.exclusive-threads=HTTP受付の占有実行スレッド数] [urecp-http.queue-size=HTTP受付の実行待ちキューのサイズ] [urecp-http.pooled-instance.minimum=HTTP受付のプール内のインスタンスの最小数] [urecp-http.pooled-instance.maximum=HTTP受付のプール内のインスタンスの最大数] [urecp-http.ejb-transaction-timeout=HTTP受付のEJBトランザクションタイムアウト時間] [httprecp.switchover.pass-through.mode={true|false}] [httprecp.switchover.file-transfer.mode={true|false}] [httprecp.http.charset={Shift_JIS|UTF-8}] [httprecp.response.ignore-bodymsg={true|false}] [httprecp.response.header.filename=HTTPレスポンスヘッダ定義ファイルの名称] [httprecp.system-exception.status-code=システム例外時のステータスコード] [httprecp.response.generate.content-length={true|false}] [httprecp.file-trans.temp-file.partsize-threshold=一時ファイルを出力する閾値サイズ] [httprecp.file-trans.maxsize.part=受信できるファイルデータの1ファイル当たりの上限サイズ] [httprecp.file-trans.maxsize.request=受信できるHTTPリクエストボディの上限サイズ] [httprecp.work-dir.auto-delete={true|false}] [httprecp.response.download.disposition-type=HTTPレスポンスヘッダのContent-Dispositionヘッダに設定する値] [httprecp.pass-through.parameter-use={true|false}] [httprecp.request.switchover.json-transfer.mode={true|false}] [httprecp.response.switchover.json-transfer.mode={true|false}] |
機能
HTTP受付の動作情報を設定します。HTTP受付開始時にHTTP受付定義ファイルに設定した内容が有効になります。
HTTP受付定義ファイルは「cscurecphttp.properties」というファイル名で作成します。
ファイルの格納先
<サービスプラットフォームのインストールディレクトリ>\CSC\custom-reception\http\config\templates\cscurecphttp.properties
設定できるプロパティ
(1)HTTP受付関連
urecp-http.context-root=HTTP受付のコンテキストルート 〜<<HTTP受付の受付ID>>
HTTP受付のコンテキストルートを半角英数字および次に示す半角記号で指定します。
上記以外の文字を指定した場合,および次の場合はエラーとなります。
このプロパティを省略した場合,HTTP受付の受付IDが設定されます。
urecp-http.max-threads=HTTP受付の最大同時実行スレッド数 〜<数字>((1−1024))<<10>>
HTTP受付の最大同時実行スレッド数を指定します。HTTP受付の占有スレッド数(urecp-http.exclusive-threadsプロパティで指定)以上の値を指定する必要があります。
urecp-http.exclusive-threads=HTTP受付の占有実行スレッド数 〜<数字>((0−1024))<<0>>
HTTP受付の占有実行スレッド数を指定します。HTTP受付の最大同時実行スレッド数(urecp-http.max-threadsプロパティで指定)を超えない範囲で値を指定する必要があります。
urecp-http.queue-size=HTTP受付の実行待ちキューのサイズ 〜<数字>((0−2147483647))<<8192>>
HTTP受付の実行待ちキューのサイズを指定します。
urecp-http.pooled-instance.minimum=HTTP受付のプール内のインスタンスの最小数 〜<数字>((0または1−2147483647))<<0>>
HTTP受付のプール内のインスタンスの最小数を整数で指定します。0を指定した場合,制限はありません。
なお,このプロパティでは,urecp-http.pooled-instance.maximumプロパティの値(HTTP受付のプール内のインスタンスの最大数)以下の値を指定してください。指定した値が,urecp-http.pooled-instance.maximumプロパティで指定した値よりも大きい場合,運用コマンド実行時にエラーになります。
urecp-http.pooled-instance.maximum=HTTP受付のプール内のインスタンスの最大数 〜<数字>((0または1−2147483647))<<0>>
HTTP受付のプール内のインスタンスの最大数を整数で指定します。0を指定した場合,制限はありません。
なお,このプロパティでは,urecp-http.pooled-instance.minimumプロパティの値(HTTP受付のプール内のインスタンスの最小数)以上の値を指定してください。指定した値が,urecp-http.pooled-instance.minimumプロパティで指定した値よりも小さい場合,運用コマンド実行時にエラーになります。
urecp-http.ejb-transaction-timeout=HTTP受付のEJBトランザクションタイムアウト時間 〜<数字>((0または1−2147483647))<<0>>
HTTP受付のEJBトランザクションタイムアウト時間を秒単位で指定します。0を指定した場合,J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。
(2)受付設定関連
httprecp.switchover.pass-through.mode={true|false} 〜<<false>>
メッセージボディをビジネスプロセスに渡すときのボディ変数を生成するモードを指定します。大文字と小文字は区別されません。
httprecp.switchover.file-transfer.mode={true|false} 〜<<false>>
リクエスト受付時にHTTP受付が作業フォルダを作成するかどうかを設定します。大文字と小文字は区別されません。
このプロパティはマルチパート型以外のリクエストに対して有効です。マルチパート型のデータの場合は,必ず作業フォルダが作成されます。
httprecp.http.charset={Shift_JIS|UTF-8} 〜<<UTF-8>>
メッセージボディとクエリのエンコードに使用する文字コードを指定します。大文字と小文字は区別されません。
httprecp.response.ignore-bodymsg={true|false} 〜<<false>>
ビジネスプロセスから受信した応答電文(ボディ)をHTTP受付が無視するか(HTTPレスポンスに設定しない)どうかを設定します。大文字と小文字は区別されません。
httprecp.response.header.filename=HTTPレスポンスヘッダ定義ファイルの名称
HTTPレスポンスヘッダ定義ファイルの名称を指定します。大文字と小文字は区別されます。
httprecp.system-exception.status-code=システム例外時のステータスコード 〜<数字>((000−999))<<500>>
システム例外時のステータスコードを3桁の数字で指定します。
httprecp.response.generate.content-length={true|false} 〜<<true>>
HTTP受付でコンテンツ長を生成するかどうかを指定します。大文字と小文字は区別されません。
httprecp.file-trans.temp-file.partsize-threshold=一時ファイルを出力する閾値サイズ 〜<数字>((0または1−2147483647))<<0>>
マルチパート型のHTTPリクエストの場合に,HTTPリクエストを一時ファイルに出力するときの閾値となるサイズをバイト単位で指定します。
HTTP受付が受信したHTTPリクエストのサイズがこの値を超えた場合,受信したHTTPリクエストは一時ファイルに出力されます。0を指定した場合,一時ファイルは必ず出力されます。
httprecp.file-trans.maxsize.part=受信できるファイルデータの1ファイル当たりの上限サイズ 〜<数字>((0または1−2147483647))<<2147483647>>
HTTP受付で受信できるファイルデータの1ファイル当たりの上限サイズの値をバイト単位で指定します。
HTTP受付が受信したマルチパート型HTTPリクエストの各パートのうち,ファイル形式で扱うパートのサイズがこの値を超えた場合,システム例外が発生します。
httprecp.file-trans.maxsize.request=受信できるHTTPリクエストボディの上限サイズ 〜<数字>((0または1−2147483647))<<2147483647>>
HTTP受付で受信できるHTTPリクエストボディの上限サイズをバイト単位で指定します。
HTTP受付が受信したHTTPリクエストボディのサイズがこの値を超えた場合,システム例外が発生します。
httprecp.work-dir.auto-delete={true|false} 〜<<true>>
処理完了後に作業フォルダを自動的に削除するかどうかを指定します。大文字と小文字は区別されません。
false以外の値を指定した場合,またはキーや値を省略した場合は,trueと見なされます。ビジネスプロセスが非同期型の場合,このプロパティにはfalseを指定してください。
httprecp.response.download.disposition-type=HTTPレスポンスヘッダのContent-Dispositionヘッダに設定する値 〜<<attachment>>
HTTP受付からHTTPクライアントにデータを送信するときにHTTPレスポンスヘッダのContent-Dispositionヘッダに設定する値を指定します。大文字と小文字は区別されます。なお,指定した値が有効かどうかは検証されません。
このプロパティで設定したヘッダの値は,HTTPクライアントがダウンロードするファイルが1つの場合だけ利用されます。
httprecp.pass-through.parameter-use={true|false} 〜<<true>>
パススルーモードで,HTTPリクエストボディにmsgキーを使用するかどうかを指定します。大文字と小文字は区別されません。
このプロパティは,httprecp.switchover.pass-through.modeプロパティでtrueを指定した場合だけ有効となります。
(3)JSON-XML変換関連
httprecp.request.switchover.json-transfer.mode={true|false} 〜<<false>>
HTTP受付のリクエスト処理時にJSON-XML変換をするかどうかを指定します。
httprecp.response.switchover.json-transfer.mode={true|false} 〜<<false>>
HTTP受付のレスポンス処理時にJSON-XML変換をするかどうかを指定します。
記述例
記述例を次に示します。
urecp-http.max-threads=10 urecp-http.exclusive-threads=0 urecp-http.queue-size=8192 urecp-http.pooled-instance.minimum=0 urecp-http.pooled-instance.maximum=0 urecp-http.ejb-transaction-timeout=0 httprecp.switchover.pass-through.mode=false httprecp.switchover.file-transfer.mode=false httprecp.http.charset=UTF-8 httprecp.response.ignore-bodymsg=false httprecp.response.header.filename=cscurecphttp_header.properties httprecp.system-exception.status-code=500 httprecp.response.generate.content-length=true httprecp.request.switchover.json-transfer.mode=true httprecp.response.switchover.json-transfer.mode=true |
All Rights Reserved. Copyright (C) 2012, 2019, Hitachi, Ltd.