WebAPI发布

提示

阅读此章请请先阅读[项目发布]章节以了解相关内容;

以下示例展示通过项目发布将 PB 插件发布到服务器端,生成 WebAPI 供客户端调用

一、项目管理

点击【发布新项目】来打开发布项目编辑界面

二、选择类型

项目类型选择：【PB 插件】

三、项目名称

输入新的项目名称，外部调用该 PB 插件时就以此名称作为唯一标识。如下示例当通过 WebAPI 外部调用时，method 设置就为 [PBPlugin].functiion

三、扩展属性

• 名称

输入 Application Name,即 开发 PB 插件时的 Application Name，如下图所示：

• 版本

选择 PBVM 的版本，即开发 PB 插件时所用的 PB 的版本

• 身份验证

选择适合的身份验证级别,详见【项目发布】-【身份验证】中的解释

• 子路径

V2020.1.1.1 版本之后 WebAPI 支持 URL 子路径直接访问，详见:【URL 访问】

• 默认页面 目前 WebAPI 尚未启用，之后可用来作为 API 的说明文档

• 会话模式

  • 独立会话模式:每次请求都会启动新的 PB 会话，调用完成后关闭会话。

  • 共享会话模式:多次请求可以共享一个会话，调用完成后会话不会关闭，如果数据库连接没有 Disconnect,则每次请求都可使用，达到长连接的效果。

四、安装文件

选择 PBD 及运行需要的相关文件到项目目录中。

重要

一些发布后不需要再次覆盖的文件，比如数据文件或者配置 ini 文件，文件属性里【替换已经存在的文件】选择\【从不】

服务器端 PB 运行库

运行服务器端插件需要 PB 的 DLL，可以通过如下几种方式设定：

1. 将需要的 DLL 放在 VdnServer\Share 目录中，所有项目都可以共享(推荐)

2. 在任意目录中存放，然后将该目录设置在系统的环境变量 Path 中，然后重启 VDN 即可

3. 在发布插件时安装文件中包含 PB 的这些 DLL

4. 放在系统目录中，例如 System32 等（不推荐）

五、发布

点击【发布】按钮进行发布，项目将被发布在 VDN 服务器目录 VDNSserver\Project\Extern\项目名称 中