このセクションでは、RAML 定義から仮想アセットを作成する方法について説明します。

セクションの内容:

概要

Virtualize は、RAML 定義で発見されたエンドポイントに基づいて .pva を作成することができます。RAML ウィザードによって生成された各 .pva には、定義されたすべてのエンドポイントに対するメッセージ レスポンダーがあります。

RAML 0.8 および 1.0 がサポートされます。

この機能が特に役に立つのは、仮想化したいサービスがライブ記録で利用できないが、それを記述した定義ファイルにはアクセスできる場合です。

定義ファイルからアプリケーションの振る舞いを仮想化するには、主に 2 つのステップがあります。

1. 定義ファイルからメッセージ レスポンダーを作成する。
2. 作成したメッセージ レスポンダーをデプロイする。

定義ファイルからのメッセージ レスポンダーの作成

RAML 定義からメッセージ レスポンダーを自動的に作成するには、次の操作を行います。

1. 利用可能なプロジェクト/.pva/レスポンダー スイートのいずれかの作成ウィザードで REST > RAML オプションを選択します。
   • ウィザードへのアクセスの詳細については「プロジェクト、 仮想アセット、レスポンダー スイートの追加」を参照してください。
2. RAML ウィザード ページで、[RAML Definition] フィールドの RAML 定義を発見する絶対 URI を入力します。ローカル システム上のファイルを参照するには、ファイル URL を使用します (例: file:///c:/Users/user/API.raml)。
3. [終了] ボタンをクリックします。

Virtualize は、RAML 定義中のリソース/メソッド/ステータス コードごとに 1 個のメッセージ レスポンダーを作成して設定します。可能な場合、サンプル メッセージがレスポンスに含まれます。サービス定義にスキーマがある場合、レスポンスを作成して従うためにスキーマが使用されます。  

コントロールを使ってレスポンス メッセージを指定できます。作成されるツールのオプションをレビューおよびカスタマイズする方法については、「メッセージ レスポンダーの概要」を参照してください。

仮想アセットのデプロイ

.pva が VirtualAssets プロジェクトに直接作成される場合、仮想アセットは自動的にデプロイされます。そうでない場合、仮想アセットをデプロイする最も単純な方法は、VirtualAssets プロジェクトに .pva ファイルをコピーすることです。 

あるいは、[Virtualize サーバー] ビューの [ローカルマシン] ノードを右クリックし、[仮想アセットの追加] を選択します。デプロイしたい仮想アセットを含む .pva ファイルを指定して、[終了] をクリックします。ウィザードの入力を完了すると、 Virtualize は .pva ファイルを VirtualAssets プロジェクトに自動的にコピーします。

デプロイ手順とオプションの詳細については、「仮想アセットのデプロイ」を参照してください。

仮想アセットのカスタマイズ

メッセージ レスポンダーの振る舞いをカスタマイズする方法については、「メッセージ レスポンダーの概要」を参照してください。