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