本主题介绍如何从 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。

虚拟化定义文件中的应用程序行为中涉及两个主要步骤:

  1. 从该定义文件中创建消息响应器。
  2. 对那些消息响应器进行部署。

从定义文件中创建消息响应器

若要自动从 OpenAPI/Swagger 定义中创建消息响应器:

  1. 右键点击虚拟资产,并选择新建> 虚拟资产 (.pva) 文件... 
  2. 为文件指定名称,然后点击下一步
  3. 选择 REST> OpenAPI/Swagger 选项,然后点击下一步
  4. 在 OpenAPI/Swagger 向导页面,输入定义文件的绝对 URI,或者点击浏览来定位本地系统上的文件。
  5. 点击完成

然后,Virtualize 将为 OpenAPI/Swagger 定义中的每个资源/方法/状态代码配置一个消息响应器。响应中将包含一个实例消息(如果适用的话)。如果服务定义包含模式,则该模式是用来构建并约束此响应的。  

可以使用可用控件来指定响应消息。有关审查和自定义所创建工具中的选项的更多详情,请参阅 消息响应器概要

部署虚拟资产

如果直接在 VirtualAssets 项目中创建 .pva,则它将自动部署。否则,部署虚拟资产最简单的方式是将包含的 .pva 文件复制到 VirtualAssets 项目中。 

或者,可以右键点击 Virtualize 服务器视图的本地机器节点,选择添加虚拟资产,指定包括要部署的虚拟资产的 .pva 文件,然后点击完成。完成向导后,Virtualize 将自动复制 .pva 文件到 VirtualAssets 项目中。

有关部署过程和选项的详情说明,请参阅部署虚拟资产

自定义虚拟资产

有关如何自定义消息响应器行为的详情,请参阅消息响应器概要

  • No labels