付録F.1　HTTP受付の設定例（標準モードの場合）

(a)　要求電文（ボディ）フォーマットの作成

受付時のHTTP受付のボディ割当変数に設定する電文フォーマットを作成します。電文フォーマットはテンプレートを編集して作成します。

編集するファイルは「urecp_http_body_detail_request.xsd」です。

注　urecp_http_body_request.xsdは編集しないでください。

この設定例では，次のように時速を表す要素と時間を表す要素（斜体の個所）を追加します。

• urecp_http_body_detail_request.xsd

  <?xml version="1.0" encoding="UTF-8" ?>
  <xsd:schema elementFormDefault="qualified"
    targetNamespace="http://www.hitachi.co.jp/soft/xml/cosminexus/csc/reception/http/request"
    xmlns:hrc="http://www.hitachi.co.jp/soft/xml/cosminexus/csc/reception/http/request"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <xsd:complexType name="http-body-requestType">
        <xsd:sequence>
          <!-- User Customize -->
          <xsd:element name="kilometers_per_hour" type=" xsd:positiveInteger "/>
          <xsd:element name="hours" type=" xsd:positiveInteger "/>
        </xsd:sequence>
      </xsd:complexType>
    </xsd:schema>

なお，この例ではHTTP受付ヘッダ割当変数は使用しません。

(b)　応答電文（ボディ）フォーマットの作成

応答時のHTTP受付のボディ割当変数に設定する電文フォーマットを作成します。

距離を返す処理を記述した次の電文フォーマットを作成し，コピーしたフォルダ内に保存してください。ファイル名は「urecp_http_body_response.xsd」です。なお，応答電文（ボディ）フォーマットのテンプレートファイルはありません。

• urecp_http_body_response.xsd

  <?xml version="1.0" encoding="UTF-8" ?>
  <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <xsd:element name="HTTPResponseBody ">
      <xsd:complexType>
        <xsd:sequence>
          <xsd:element name="distance" type=" xsd:positiveInteger "/>
        </xsd:sequence>
      </xsd:complexType>
    </xsd:element>
  </xsd:schema>

(a)　ユーザ定義受付定義画面（基本）の設定

設定する内容を次に示します。

(b)　HTTPレスポンスヘッダ定義ファイルの編集

HTTPレスポンスヘッダ定義ファイルの編集手順を次に示します。なお，この設定例ではビジネスプロセス中でヘッダ割当変数を使用しないため，プロパティの説明は省略します。

1. ユーザ定義受付定義画面（詳細）の［独自定義ファイル］で「cscurecphttp_header.properties」を選択し，［編集］ボタンをクリックします。

   独自定義ファイルを編集するためのエディタが起動します。

2. HTTPレスポンスヘッダ定義ファイルの内容を次のように修正します。

   Connection=close
   extension-header=extension-header1

   注　「extension-header」は，任意に指定できる拡張ヘッダを想定して設定しています。

3. Eclipseのメニューから［ファイル］−［保存］を選択します。

   HTTPレスポンスヘッダ定義ファイルが保存されます。

(c)　HTTP受付定義ファイルの編集

HTTP受付定義ファイルの編集手順を次に示します。

1. ユーザ定義受付定義画面（詳細）の［独自定義ファイル］で「cscurecphttp.properties」を選択し，［編集］ボタンをクリックします。

   独自定義ファイルを編集するためのエディタが起動します。

2. HTTP受付定義ファイルの内容を次のように修正します。

   #urecp-http.context-root=
   #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.http.charset=UTF-8
   httprecp.response.header.filename=cscurecphttp_header.properties
   #httprecp.system-exception.status-code=500
   #httprecp.response.generate.content-length=true

   この例ではコンテキストルート（urecp-http.context-root）を省略しているため， HTTP受付の受付IDがデフォルト値として使用されます。

3. Eclipseのメニューから［ファイル］−［保存］を選択します。

   HTTP受付定義ファイルが保存されます。

(a)　ビジネスプロセスの作成

この例では，HTTP受付に渡された要求電文を，データ変換アクティビティを使用してデータ変換し，応答電文を生成するビジネスプロセスを作成します。

次の図に示すようにアクティビティを配置・連結してください。

アクティビティを配置・連結する方法については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「5.4　アクティビティの配置と連結」を参照してください。

(b)　変数の定義

ビジネスプロセスで使用する変数を定義します。

定義する変数を次に示します。

なお，この設定例では相関セットを使用しません。

変数の定義は［電文フォーマットの取込］ダイアログで実施します。それぞれの変数の定義手順を次に示します。

1. ビジネスプロセス定義画面のキャンバス上の［変数・相関セット］アイコンをダブルクリックします。

   ［変数・相関セット一覧］ダイアログが表示されます。

   

2. ［変数名］に「request_body」または「response_body」を入力します。

3. ［種別］ドロップダウンリストから「XML」を選択します。

4. ［電文フォーマット］の［取込］ボタンをクリックします。

   ［電文フォーマットの取込］ダイアログが表示されます。

5. 次に示すとおりに各変数を設定します。

   

   • request_body

     分類	項目	設定値
     サービス/受付	サービス名	−
     	受付名	HTTPReception
     取込対象	オペレーション名	calculateDistance
     	電文種別	要求電文(ボディ)
     	フォルト名	−
     −	電文フォーマット	request_body

   • response_body

     分類	項目	設定値
     サービス/受付	サービス名	−
     	受付名	HTTPReception
     取込対象	オペレーション名	calculateDistance
     	電文種別	応答電文(ボディ)
     	フォルト名	−
     −	電文フォーマット	response_body

     （凡例）

     −：設定しません。または，該当する分類はありません。

6. ［OK］ボタンをクリックし，［変数・相関セット一覧］ダイアログで［追加］ボタンをクリックします。

   定義した変数が追加されます。

(c)　データ変換の定義

データ変換では，数値演算ファンクション「calc1」で要求電文に格納された2つのパラメタの積を求め，その値を応答電文にマッピングします。

データ変換の定義手順を次に示します。

1. ビジネスプロセス定義画面上のデータ変換アクティビティをダブルクリックします。

   ［データ変換アクティビティ］ダイアログが表示されます。

2. ［変換元変数］に「request_body」を指定します。

3. ［変換先変数］に「response_body」を指定します。

4. ［データ変換定義］に任意の名称を指定します。

   

5. ［OK］ボタンをクリックします。

6. データ変換アクティビティをダブルクリックします。

   ［ルート要素選択］ダイアログが表示されます。

7. ［OK］ボタンをクリックします。

   データ変換定義画面が表示されます。

8. パレットから数値演算ファンクション（calc）を選択して，マッピングビューアに配置します。

9. マッピング線を図のように設定します。

   

10. 数値演算ファンクションをダブルクリックします。

    ［数値演算］ダイアログが表示されます。

11. ［演算］で実行したい演算（この例では「*」）を選択します。

    

12. ［OK］ボタンをクリックします。

    データ変換の定義が完了しました。

(d)　受付アクティビティ・応答アクティビティの設定

アクティビティの設定手順を次に示します。

●受付アクティビティの設定例

1. ビジネスプロセス定義画面上の受付アクティビティをダブルクリックします。

   ［受付アクティビティ］ダイアログが表示されます。

2. 次のように設定します。

   

   項目	設定値
   アクティビティ名	受付
   オペレーション名	calculateDistance
   ボディ割当変数	request_body
   ヘッダ割当変数	−
   割当相関セット群	−
   通信モデル	同期
   インスタンス生成	Yes

   （凡例）

   −：設定しません。

3. ［OK］ボタンをクリックします。

●応答アクティビティの設定例

1. ビジネスプロセス定義画面上の応答アクティビティをダブルクリックします。

   ［応答アクティビティ］ダイアログが表示されます。

2. 次のように設定します。

   

   項目	設定値
   アクティビティ名	応答
   オペレーション名	calculateDistance
   ボディ割当変数	response_body
   ヘッダ割当変数	−
   割当相関セット群	−
   フォルト名	−

   （凡例）

   −：設定しません。

3. ［OK］ボタンをクリックします。

(a)　準備手順

1. Eclipseのメニューから，［ファイル］−［すべて保管］を選択し，定義したHCSCコンポーネントを保管します。

2. Windowsの［スタート］メニューから，［Cosminexus］−［テストサーバ起動］を選択します。

3. ツリービューのサービス定義一覧で右クリックして，［複数サービスをサーバに配備して開始］を選択します。

4. サービス選択ページで配備および開始するサービスを選択します。

5. ［Finish］ボタンをクリックします。

   処理中であることを知らせるメッセージが表示されたあと，結果を知らせるメッセージが表示されます。

6. ［OK］ボタンをクリックします。

   ビジネスプロセスとHTTP受付を含むリポジトリが実行環境に配備されます。

(b)　HTTP受付の呼び出し

Webブラウザを起動してアドレス指定部分に次のURLを指定してアクセスします。必要に応じてクエリストリングの指定値は変更してください。

http://localhost/rcp1/calculateDistance?kilometers_per_hour=80&hours=25

実行結果が次のようにWebブラウザに表示されます。