本主题介绍如何从 RAML 定义中创建虚拟资产。
章节目录:
概要
Virtualize 会根据 RAML 说明中找到的端点自动创建一个 .pva 文件。每个通过 RAML 向导生成的 .pva 文件都将包含所有已定义端口的消息响应器。
支持 RAML 0.8 和 1.0。
如果要虚拟化的服务不可用于实时录制,而您拥有访问描述它的定义文件的权限,则这一点尤其有用。
虚拟化定义文件中的应用程序行为中涉及两个主要步骤:
- 从该定义文件中创建消息响应器。
- 对那些消息响应器进行部署。
从定义文件中创建消息响应器
若要自动从 RAML 定义中创建消息响应器:
- 在一个可用的 project/.pva/Responder 套件创建向导中选择 REST> RAML 选项。
- 有关访问该向导的详情,请参阅添加项目、虚拟资产和响应器套件。
- 在 RAML 向导页面,在 RAML 定义字段中输入可以找到 RAML 定义的绝对 URI。若要引用本地系统上的文件,请使用文件 URL(如 file:///c:/Users/user/API.raml)。
- 点击完成。
Virtualize 将创建一个为 RAML 定义中的每个资源/方法/状态代码配置一个消息响应器。响应中将包含一个实例消息(如果适用的话)。如果服务定义包含模式,则该模式是用来构建并约束此响应的。
可以使用可用控件来指定响应消息。有关审查和自定义所创建工具中的选项的更多详情,请参阅消息响应器概要。
部署虚拟资产
如果直接在 VirtualAssets 项目中创建 .pva,则它将自动部署。否则,部署虚拟资产最简单的方式是将包含的 .pva 文件复制到 VirtualAssets 项目中。
或者,可以右键点击 Virtualize 服务器视图的本地机器节点,选择添加虚拟资产,指定包括要部署的虚拟资产的 .pva 文件,然后点击完成。完成向导后,Virtualize 将自动复制 .pva 文件到 VirtualAssets 项目中。
有关部署过程和选项的详情说明,请参阅部署虚拟资产。
自定义虚拟资产
有关如何自定义信息响应器行为的详情,请参阅消息响应器概要。