このセクションでは、RAML 定義から仮想アセットを作成する方法について説明します。
セクションの内容:
概要
Virtualize は、RAML 定義で発見されたエンドポイントに基づいて .pva を作成することができます。RAML ウィザードによって生成された各 .pva には、定義されたすべてのエンドポイントに対するメッセージ レスポンダーがあります。
RAML 0.8 および 1.0 がサポートされます。
この機能が特に役に立つのは、仮想化したいサービスがライブ記録で利用できないが、それを記述した定義ファイルにはアクセスできる場合です。
定義ファイルからアプリケーションの振る舞いを仮想化するには、主に 2 つのステップがあります。
- 定義ファイルからメッセージ レスポンダーを作成する。
- 作成したメッセージ レスポンダーをデプロイする。
定義ファイルからのメッセージ レスポンダーの作成
RAML 定義からメッセージ レスポンダーを自動的に作成するには、次の操作を行います。
- 利用可能なプロジェクト/.pva/レスポンダー スイートのいずれかの作成ウィザードで REST > RAML オプションを選択します。
- ウィザードへのアクセスの詳細については「プロジェクト、 仮想アセット、レスポンダー スイートの追加」を参照してください。
- RAML ウィザード ページで、[RAML Definition] フィールドの RAML 定義を発見する絶対 URI を入力します。ローカル システム上のファイルを参照するには、ファイル URL を使用します (例: file:///c:/Users/user/API.raml)。
- [終了] ボタンをクリックします。
Virtualize は、RAML 定義中のリソース/メソッド/ステータス コードごとに 1 個のメッセージ レスポンダーを作成して設定します。可能な場合、サンプル メッセージがレスポンスに含まれます。サービス定義にスキーマがある場合、レスポンスを作成して従うためにスキーマが使用されます。
コントロールを使ってレスポンス メッセージを指定できます。作成されるツールのオプションをレビューおよびカスタマイズする方法については、「メッセージ レスポンダーの概要」を参照してください。
仮想アセットのデプロイ
.pva が VirtualAssets プロジェクトに直接作成される場合、仮想アセットは自動的にデプロイされます。そうでない場合、仮想アセットをデプロイする最も単純な方法は、VirtualAssets プロジェクトに .pva ファイルをコピーすることです。
あるいは、[Virtualize サーバー] ビューの [ローカルマシン] ノードを右クリックし、[仮想アセットの追加] を選択します。デプロイしたい仮想アセットを含む .pva ファイルを指定して、[終了] をクリックします。ウィザードの入力を完了すると、 Virtualize は .pva ファイルを VirtualAssets プロジェクトに自動的にコピーします。
デプロイ手順とオプションの詳細については、「仮想アセットのデプロイ」を参照してください。
仮想アセットのカスタマイズ
メッセージ レスポンダーの振る舞いをカスタマイズする方法については、「メッセージ レスポンダーの概要」を参照してください。
