サービスのステップ

シミュレーションファイルにサービスのステップを使用して、サービスのプロセスを定義してください。これで実行するシミュレーションを指定します。

これらが利用できるステッププロパティです：

ステッププロパティ

説明

例

バッファ

メッセージにバッファを使用して、値を保存します。このプロパティには、バッファを作成するために適用されるルールの一覧が含まれています。

例

connection

メッセージの送信または受信のための接続を指定してください。この操作を行うために、接続プロパティを使用します。

例

counter

次のステップに進む前に、指定されたメッセージを何回送信または受信するかを定義します。

5

説明

そのステップがどのような処理を行うかの説明です。

contract verification

direction

メッセージの送信または受信のステップを指定してください。メッセージを送信するには、値に「Out」と入力してください。メッセージを受信するには、値に「In」と入力してください。

値を空白のままにすると、方向が論理的（暗黙的）に導き出されます。最初のステップは「In」であり、次のステップは「Out」であると仮定されます。

Out

from

接続の名前を使用してメッセージを受信することで、接続を参照します。

これを使用するには、方向プロパティを「In」に設定する必要があります。

myConnection

挿入

値を挿入するためのルールの一覧です。

例

メッセージ

送信するメッセージを指定してください。この操作を行うには、メッセージのプロパティを使用します。

例

name

ステップの名前を指定してください。

step1

order

このプロパティは、メッセージが特定の順序で受信されるべきかどうかを定義します。

指定された順序を使用するにはSTRICTと入力し、任意の順序を受け入れるにはANYと入力してください。デフォルト値はSTRICTとなっています。

STRICT

resource

シミュレーションファイル内で、データ構造などのリソースを参照することができます。このリソースに対して何が起こるかを定義するために、リソースのステッププロパティと併せてルールを指定してください。

例

save

特定のファイルにメッセージペイロードやメッセージの他のプロパティを保存するためのルールの一覧です。ファイルのプロパティを使用して、ファイル名とファイル拡張子を設定してください。

例

to

この接続の名前を使用してメッセージを送信することで、接続を参照します。

これを使用するには、方向プロパティを「Out」に設定する必要があります。

myConnection

トリガー

サービスを開始するためのルールの一覧です。If all rules apply, APIシミュレーション starts the service.

例

use

事前にテンプレートとして設定したサービスを参照します。これにより、他のサービスのステップでこれらのサービスを再利用でき、モジュール化された保守可能な構成が可能となります。

OAuth template

確認する

メッセージ検証のためのルールの一覧です。If the verification fails, APIシミュレーション logs a warning.

例

例

これは値を挿入する方法の例です：

  • インバウンドステッププロパティのトリガーでは、任意の値を含むパスプロパティを持つメッセージを待機します。If an incoming message meets this condition, APIシミュレーション sends a response.

  • アウトバウンドステッププロパティの挿入は、「Hello world!」 という値を書き込みます。これはサービスのペイロードで行われます。

コピー 
schema: SimV1
name: default

services:
- name: Service01
  steps:
  - direction: In
    trigger:
    - uri: '*'   
  - direction: Out
    insert:
    - value: 'Hello world!'

この例は、メッセージのペイロードを保存する方法を示しています。

  • インバウンドステップには2つのプロパティが含まれています：

    1. パスプロパティの値として任意の値を含むメッセージを待機するトリガープロパティ。

    2. The save property to save the incoming message that meets this condition to a file named request.dat.

  • 受信メッセージが保存されると、アウトバウンドステップのプロパティの挿入によって、「Request saved successfully 」という値がサービスのペイロードに書き込まれます。

コピー 
schema: SimV1
name: default

services:
- name: Service01
  steps:
  - direction: In
    trigger:
    - uri: '*'
    save:
    - file: request.dat
  - direction: Out
    insert:
    - value: Request saved successfully

こちらは、仮想サービスがどのように見えるかの一例です。これは以下のように指定されています。

  • 仮想サービス名はService01で、これはリクエスト応答ペアです。

  • インバウンドステップトリガーは、任意の値を含むパスプロパティを持つメッセージを待機します。If an incoming message meets this condition, APIシミュレーション sends a response.

  • アウトバウンドプロパティメッセージは、Hello world!という値を送信します。接続ポート54545のサービスへ。

コピー 
schema: SimV1
name: default

services:

- name: Service01
  steps:
  - direction: In
    trigger:
    - uri: '*'      
  - direction: Out
    message:
      payload: Hello world!

connections:

- port: 54545

これは、メッセージのルールの確認方法の1例です：

  • インバウンドステップには2つのプロパティが含まれています：

    1. パスプロパティの値として任意の値を含むメッセージを待機するトリガープロパティ。

    2. パスプロパティの値が /test/content であるかどうかを確認する確認プロパティ。

  • アウトバウンドステッププロパティの挿入により、サービスのペイロードにokという値が書き込まれます。

コピー 
schema: SimV1
name: default

services:
- name: Service01
  steps:
  - direction: In
    trigger:
    - uri: '*'
    verify:
    - uri: /test/content
  - direction: Out
    message:
      payload: ok