PEXA Serviceについて

チュートリアル

テストツール

定義ファイル

基本プロセス

拡張プロセス

Condition

セッション

モデル

リファレンス

環境設定

目次

  1. はじめに
  2. ServiceClientの使用方法
  3. ServiceClientサービス設定プロパティファイルの全体構成
  4. servicesセクション
  5. ServiceClientサービス設定プロパティファイルのサンプル


はじめに

このドキュメントは、RESTFulWebサービスを介して、PEXAサービスフレームワークで使用するServiceClientサービス設定プロパティファイルについて解説する物です。

ServiceClientサービス設定プロパティファイルは、RESTFulWebサービスを介して、サービスの単体テストなどを行うためのServiceClientプログラムに読み込ませるパラメータファイルです。
呼び出したいサービスの名前と呼出パラメータを指定することで、連続して複数個のサービス呼出が行えます。

記述形式はPEXA独自のプロパティ形式となります。このプロパティ形式の書式については、リファレンスを参照して下さい。


ServiceClientの使用方法

本ServiceClientとは、RESTFulWebサービスを介して、PEXAのサービス実行エンジンを呼び出して任意のサービスを呼び出すことができるツールです。
サービス定義ファイルで記述された処理の単体テストを行う場合等に使用します。

以下に使用手順を記載します。

サービスクライアントバッチファイル起動パラメータの設定

RESTFulサービスクライアントバッチファイル起動パラメータは以下のようになります。
-srv サービス名
-pXXXX xxxx セッション名と値(文字列)
-f サービス設定プロパティファイルパス名
-sout リターン値JSONダンプ(標準出力)
-o リターン値ダンプを指定フィルの出力
-u URL http://localhost:8080/プロジェクト名
-l lang ロケール名(デフォルト“ja”)
-srvでサービス名が指定されている場合は、サービス設定プロパティファイル(-f)の内容は無視されます。
-srv,-fが指定されていないときは、標準入力からサービス設定プロパティファイルの内容がパイプで供給されるものとします。
例:

-u http://localhost:8080/pwtest
-srv SSR.PTest15
-pS1 AAAAA
-pS2 111111
-o xtemp/20181116001.txt
-sout


ServiceClientサービス設定プロパティファイルの記述

ServiceClientで呼び出したい対象のサービス名や呼出時のパラメータを記述するファイルを作成します。
中身はテキスト形式のファイルで、名前や拡張子は任意です。起動パラメータ-fでファイル名を指定します。

記述形式については後述します。


ServiceClientの実行

各プロジェクトのワークスペースにWindows上で実行するためのバッチファイルがあります。
RESTFulサービスクライアントは、PWRESTServiceClient.zipとして下記のURIに格納されています。
http://pexa.atrris.com/pwdemo/
これを解凍して各プロジェクトのフォルダーにコピーしてください。zipの先頭フォルダは”tool”になっています。
サービスクライアントの起動(Windows)は以下のように行います。

%PRJHOME%\tool\client\PWRESTServiceClient.bat
実行時には引数として、サービスクライアントバッチファイル起動パラメータを指定して下さい。

例:
PWRESTServiceClient.bat -f restsc/text01.txt
なお、このバッチファイルを使用した場合、接続先のJBossはServiceClientを実行したローカル環境で動作している物となります。



ServiceClientサービス設定プロパティファイルの全体構成

ServiceClientサービス設定プロパティファイルの全体構成について、以下に示します。
servicesセクションの中に、呼び出したいサービスの情報を列挙します。

それぞれのセクションの詳細については、以降で解説します。

;---------------------------------------------------------------
; Release-Date:     $Date:: 2010-11-16 13:45:58 #$
; Release-Version:  $Revision: 5636 $
; Author:           $Author: morishita $
; First-Created-On: 2007/04/16
; First-Created-By: Daisuke Morishita
;---------------------------------------------------------------
; サービスの呼出情報
;---------------------------------------------------------------
[services
	server	http://localhost:8080/pwtest
	lang	ja

    サービス呼出定義1
    ,
    サービス呼出定義2
    ,
    サービス呼出定義3
        :
        :
        :
]
キーserver 起動パラメータ-u相当 例:http://localhost:8080/pwtest
キーlang 起動パラメータ-l相当 例:ja


servicesセクション

書式 :

;---------------------------------------------------------------
; サービスの呼出情報
;---------------------------------------------------------------
[services
    (service名
        print属性(0|1)   
        sessionセクション(0|1)
    )
    ,
	     .
	     .
	     .	
]
	
記述注:
    属性        あらかじめ決められた値を選択する(true/falseなど)
    宣言部      値または、値のリストを設定する
    セクション  入れ子で他の属性、宣言部、セクションを保持する可能性がある
                (値又は、値のリストが設定される場合もある)

    (1):必須
    (0|1):オプション
    (1以上):一個以上必須
    (0以上):0個以上(オプション)

記述例 :
;---------------------------------------------------------------
; サービスの呼出情報
;---------------------------------------------------------------
[services
    (CreateAlert
        (session
            実行時刻    $実行時刻:&Today
        )
    )
    ,
    (CreateReminder
        (session
            実行時刻    $実行時刻:&Today
        )
    )
]

説明 :
このセクションは必須です。
servicesセクションは、サービスの呼出情報を記述するセクションです。

呼び出したいサービスの指定やパラメータ設定をここに記述します。

属性値 :
servicesセクションの属性値は以下の通り。

print属性

説明 :
非必須です。
サービス実行後にServiceSessionの内容を標準出力にダンプするか否かを指定する。
省略時は"false"出力するが指定されたと見なされる。

キー:print(固定|option)
形式:Key・固定値
区分:"true"/"false"
    true    出力する
    false   出力しない

記述例 :

print  true


sessionセクション

説明 :
非必須です。
Service実行前にServiceSessionに対する編集内容を記述する。
書式についてはこちらを参照して下さい。

キー:session(固定|オプション)
形式:マップ又は、順序付マップ

記述例 :

(CreateAlert
    (session
        実行時刻    $実行時刻:&Today
    )
)



ServiceClientサービス設定プロパティファイルのサンプル

;---------------------------------------------------------------
; Release-Date:     $Date:: 2010-11-16 13:45:58 #$
; Release-Version:  $Revision: 5636 $
; Author:           $Author: morishita $
; First-Created-On: 2007/04/16
; First-Created-By: Daisuke Morishita
;---------------------------------------------------------------
; サービスの呼出情報
;---------------------------------------------------------------
[services
    ;-----------------------------------------------------------
    ; アラート生成サービスの呼出
    ;-----------------------------------------------------------
    (CreateAlert
        (session
        )
    )
]


更新情報

  • 最終更新者 : $Author: tann $
  • 最終更新日時 : $Date:: 2019-01-28 15:30:00 #$
  • バージョン : $Revision: 5636 $



Copyright © 2006, Atrris Corporation