Cosminexus V9 BPM/ESB基盤 サービスプラットフォーム リファレンス

[目次][用語][索引][前へ][次へ]

HTTPアダプタ実行環境プロパティファイル

形式

 
[adphttp.request.method={GET|HEAD|POST|OPTIONS|PUT|DELETE}]
[adphttp.request.uri-scheme-authority=URIのスキームとオーソリティ]
[adphttp.request.uri-path=URIのパス]
[adphttp.request.uri-query.<追番>=URIのクエリ]
 
[adphttp.request.header.authorization.type={none|raw}]
[adphttp.request.header.authorization=認証情報]
 
[adphttp.request.header.content-type.charset=Content-Typeヘッダの文字コード]
[adphttp.request.header.content-type=Content-Typeヘッダのメディアタイプ]
 
[adphttp.request.header.userdef.<追番>=リクエストヘッダ]
 
[adphttp.request.part.message.binding={none|raw|form-data}]
 
[adphttp.request.part.file.<追番>.input-folder-name=共通フォルダ定義名]
[adphttp.request.part.file.<追番>.local-file-name=読み込み対象のファイル名]
 
[adphttp.request.output-folder-name=共通フォルダ定義名]
[adphttp.request.output-sub-folder=ファイル出力先のサブフォルダ名]
 
[adphttp.config.trace.path=ログの出力先ディレクトリ]
[adphttp.config.messagelog.level={0|10|20}]
[adphttp.config.methodtrace.level={1|2|3|4|5}]
[adphttp.config.methodtrace.filenum=メソッドトレースファイルの面数]
[adphttp.config.methodtrace.filesize=メソッドトレースファイルのファイルサイズ]
[adphttp.config.exptrace.filenum=例外ログファイルの面数]
[adphttp.config.exptrace.filesize=例外ログファイルのファイルサイズ]
 
[adphttp.config.password-auth-inf-filepath=パスワード認証情報定義ファイルのパス]
 
[adphttp.config.publickey-auth-inf-filepath=公開鍵認証情報定義ファイルのパス]
 

機能

HTTPアダプタごとの構成情報を設定します。

要求電文(ヘッダ),HTTPアダプタ実行環境プロパティファイル,HTTPアダプタ実行環境共通プロパティファイルで同じ要素を指定した場合の優先順位については,マニュアル「サービスプラットフォーム 解説」の「2.14.12 要求電文(ヘッダ)とHTTPアダプタ実行環境(共通)プロパティファイルのパラメタの対応関係」を参照してください。

HTTPアダプタ実行環境プロパティファイルは次の手順で作成してください。

  1. 次のテンプレートファイルを基に,HTTPアダプタ実行環境プロパティファイルを定義します。
     
    <サービスプラットフォームのインストールディレクトリ>\CSC\custom-adapter\HTTP\config\templates\serviceid.properties
     
  2. 編集後のHTTPアダプタ実行環境プロパティファイルのファイル名を「<サービスID>.properties」という名称に変更し,次のディレクトリに格納してください。
     
    <サービスプラットフォームのインストールディレクトリ>\CSC\custom-adapter\HTTP\config
     

設定できるプロパティ

(1) リクエストライン

adphttp.request.method={GET|HEAD|POST|OPTIONS|PUT|DELETE}

リクエストのHTTPメソッド名を指定します。

GET,HEAD,POST,OPTIONS,PUT,DELETE以外のメソッド名を指定した場合は,動作を保証しません。

adphttp.request.uri-scheme-authority=URIのスキームとオーソリティ

URIのスキームとオーソリティを「<スキーム>://<オーソリティ>」の形式で指定します。

adphttp.request.uri-path=URIのパス

URIのパス部分を指定します。URIのパスがルートパス("/")の場合は指定を省略できます。

adphttp.request.uri-query.<追番>=URIのクエリ

URIのクエリ部分を「<キー>=<値>」の形式で1つずつ指定します。

<追番>には1〜1024の数字を指定できます。

 

(2) WWW認証

adphttp.request.header.authorization.type={none|raw} 〜<<none>>

WWW認証の認証タイプを指定します。大文字と小文字は区別されません。

このプロパティを指定した場合は,必ずadphttp.request.header.authorizationプロパティに認証情報を指定してください。

adphttp.request.header.authorization=認証情報

WWW認証の認証情報を次のように指定します。

 

(3) HTTPヘッダのContent-Typeヘッダ

adphttp.request.header.content-type.charset=Content-Typeヘッダの文字コード

HTTPリクエストヘッダのContent-Typeヘッダの文字コードを指定します。

要求電文(ボディ)のバインド方法にform-dataを指定した場合,ここで指定した文字コードにフォームデータを変換してからHTTPリクエストが送信されます。指定できる文字コードはJavaVMが使用できる文字コードに限ります。

要求電文(ボディ)のバインド方法にrawを指定した場合,要求電文(ボディ)の文字コードに合わせて文字コードを指定してください。

adphttp.request.header.content-typeプロパティを指定しなかった場合,このプロパティの指定は無視されます。キーだけ指定して値を指定しない場合はエラーになります。

adphttp.request.header.content-type=Content-Typeヘッダのメディアタイプ

HTTPリクエストヘッダのContent-Typeヘッダのメディアタイプを「*/*」の形式で指定します。キーだけ指定して値を指定しない場合はエラーになります。

 

(4) HTTPヘッダの任意指定

adphttp.request.header.userdef.<追番>=リクエストヘッダ

任意のリクエストヘッダ(1つのヘッダ)を「<フィールド名>:<フィールド値>」の形式で指定します。<追番>には1〜1024の数字を指定できます。

このプロパティは拡張ヘッダの設定を推奨します。標準ヘッダを定義した場合の動作は保証しません。また,特殊なHTTPヘッダは指定しても無視されます。詳細については,マニュアル「サービスプラットフォーム 解説」の「2.14.3 HTTPリクエストと要求電文の関係」の,HTTPリクエストヘッダに関する記述を参照してください。

設定した値は,最初の「:」を区切り文字として<フィールド名>と<フィールド値>に分割してHTTPヘッダに設定されます。<フィールド名>と<フィールド値>に余分な空白文字が含まれていても除去されません。

<フィールド名>と<フィールド値>には改行文字を指定しないでください。改行文字が含まれる場合,エラーになります。

 

(5) 要求電文(ボディ)

adphttp.request.part.message.binding={none|raw|form-data} 〜<<none>>

要求電文(ボディ)のHTTPリクエストボディへのバインド方法を指定します。大文字と小文字は区別されません。

 

(6) 入力ファイル

adphttp.request.part.file.<追番>.input-folder-name=共通フォルダ定義名

読み込み対象のファイルが格納された共通フォルダの定義名を指定します。<追番>には「1」しか指定できません。

指定した共通フォルダ定義名が不正な場合は,エラーになります。キーだけ指定して値を指定しない場合はエラーになります。共通フォルダを使用しない場合は指定を省略できます。

このプロパティを指定した場合は,必ずadphttp.request.part.file.<追番>.local-file-nameプロパティに読み込み対象のファイル名を指定してください。

adphttp.request.part.file.<追番>.local-file-name=読み込み対象のファイル名

読み込み対象のファイルの名称を指定します。<追番>には「1」しか指定できません。

階層構造や上位のパスを指定した場合はエラーになります。サブフォルダを使用する場合は,共通フォルダルートからファイル名までの相対パスで設定してください。キーだけ指定して値を指定しない場合はエラーになります。

このプロパティを指定した場合は,必ずadphttp.request.part.file.<追番>.input-folder-nameプロパティに共通フォルダ定義名を指定してください。

シンボリックリンク以外のファイルを指定してください。

 

(7) 出力ファイル

adphttp.request.output-folder-name=共通フォルダ定義名

書き込み対象のファイルを格納する共通フォルダの定義名を指定します。

指定した共通フォルダ定義名が不正な場合は,エラーになります。キーだけ指定して値を指定しない場合はエラーになります。

共通フォルダを使用しない場合は指定を省略できます。

adphttp.request.output-sub-folder=ファイル出力先のサブフォルダ名

HTTPレスポンス時にダウンロードファイルを出力するサブフォルダを指定します。

adphttp.request.output-folder-nameプロパティで共通フォルダを指定し,かつサブフォルダを使用する場合に,書き込み対象のファイルを出力するサブフォルダを指定します。

共通フォルダルートからサブフォルダまでの相対パスを設定してください。相対パスの先頭および末尾のファイル区切り文字(/)は省略できます。

指定したサブフォルダが存在しない場合は,実行時にフォルダを作成します。

共通フォルダルートより上位のパスを指定した場合はエラーになります。

adphttp.request.output-folder-nameプロパティで共通フォルダ定義名が定義されていない場合,指定値は無視されます。

 

(8) ロギング

adphttp.config.trace.path=ログの出力先ディレクトリ 〜<<<J2EEサーバ用オプション定義ファイル(usrconf.properties)のejb.server.log.directoryキーで指定したログ出力ディレクトリ>\CSCADP\ADPHTTP\maintenance\<サービスID>>>

メンテナンスログおよび例外ログの出力先ディレクトリのパスを絶対パスで指定します。指定したフォルダが存在しない場合はHTTPアダプタ起動時にフォルダを作成します。

adphttp.config.messagelog.level={0|10|20} 〜<<10>>

メッセージログの出力レベルを指定します。出力情報と出力レベルを次の表に示します。

出力情報 出力内容 出力レベル
0 10 20
エラー情報 例外または障害の発生原因
警告情報 発生した問題など
インフォメーション 電文や引数の内容
HTTPアダプタの状態の変更(起動時や終了時)
イベントの通知

(凡例)
○:出力されます。
△:重要なログメッセージだけ出力されます。

adphttp.config.methodtrace.level={1|2|3|4|5} 〜<<3>>

メンテナンスログの出力レベルを指定します。出力情報と出力レベルを次の表に示します。

出力情報 出力レベル
1 2 3 4 5
エラー情報(例外発生原因)
主要な外部モジュールのインターフェースの入口/出口情報(クラス名,メソッド名,引数,戻り値) ×
外部モジュールのインターフェースの入口/出口情報(クラス名,メソッド名,引数,戻り値) × ×
主要なコンポーネント内インターフェースの入口/出口情報(クラス名,メソッド名,引数,戻り値) × × ×
コンポーネント内インターフェースの入口/出口情報(クラス名,メソッド名,引数,戻り値)や,デバッグ情報(処理の分岐などの情報) × × × ×

(凡例)
○:出力されます。
×:出力されません。

adphttp.config.methodtrace.filenum=メソッドトレースファイルの面数 〜<数字>((1−16)) <<8>>

メンテナンスログの面数を指定します。

adphttp.config.methodtrace.filesize=メソッドトレースファイルのファイルサイズ 〜<数字>((4096−2147483647)) <<2097152>>

メンテナンスログの1面当たりの最大ファイルサイズをバイト単位で指定します。

adphttp.config.exptrace.filenum=例外ログファイルの面数 〜<数字>((1−16)) <<8>>

例外ログの面数を指定します。

adphttp.config.exptrace.filesize=例外ログファイルのファイルサイズ 〜<数字>((4096−2147483647)) <<2097152>>

例外ログの1面当たりの最大ファイルサイズをバイト単位で指定します。

 

(9) パスワード認証情報定義ファイル

adphttp.config.password-auth-inf-filepath=パスワード認証情報定義ファイルのパス

パスワード認証のユーザ情報をcsauseraddコマンドで登録している場合,パスワード認証情報定義ファイルのファイル名を絶対パスで指定します。csauseraddコマンドの実行時に-fオプションで指定したパスワード認証情報定義ファイルのパスを指定してください。

指定するファイルには,HCSCサーバの管理者のアクセス権限が必要です。

指定したファイルが存在しない場合は,サービスアダプタの開始時にエラーとなります。

 

(10) 公開鍵認証情報定義ファイル

adphttp.config.publickey-auth-inf-filepath=公開鍵認証情報定義ファイルのパス

公開鍵認証の秘密鍵情報をcsakeyaddコマンドで登録している場合,公開鍵認証情報定義ファイルのファイル名を絶対パスで指定します。csakeyaddコマンドの実行時に-fオプションで指定した公開鍵認証情報定義ファイルのパスを指定してください。

指定するファイルには,HCSCサーバの管理者のアクセス権限が必要です。

指定したファイルが存在しない場合は,サービスアダプタの開始時にエラーとなります。

記述例

記述例を次に示します。

 
adphttp.request.method=GET
adphttp.request.uri-scheme-authority=http://localhost:80
adphttp.request.uri-path=trans/EN2JP/something
adphttp.request.uri-query.1=name=id
adphttp.request.header.authorization.type=none
adphttp.request.header.authorization=
adphttp.request.header.content-type.charset=utf-8
adphttp.request.header.content-type=application/msword
adphttp.request.header.userdef.1=cache-control:no-cache
adphttp.request.part.message.binding=none
adphttp.config.messagelog.level=10
adphttp.config.methodtrace.level=3
adphttp.config.methodtrace.filenum=8
adphttp.config.methodtrace.filesize=2097152
adphttp.config.exptrace.filenum=8
adphttp.config.exptrace.filesize=2097152
 

注意事項