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