第九章 从 Web 客户端指定自定义传输

文章目录

  • [第九章 从 Web 客户端指定自定义传输](#第九章 从 Web 客户端指定自定义传输)
  • [从 Web 客户端指定自定义传输](#从 Web 客户端指定自定义传输)
  • 背景
  • [为 Web 客户端定义自定义传输](#为 Web 客户端定义自定义传输)

第九章 从 Web 客户端指定自定义传输

从 Web 客户端指定自定义传输

默认情况下,如果使用 Web 客户端,Web 客户端将使用 HTTPSOAP 消息传输到 Web 服务并接收响应。可以定义并使用自己的传输类。

背景

为了与其使用的 Web 服务进行通信, Web 客户端需要一个传输类。传输类包含与通信相关的参数、属性和方法。整体通信工作方式如下:

  1. 运行 Web 客户端代理方法时,Web 客户端实例会检查其 Transport 属性的值。

如果此属性为空,则 Web 客户端实例将使用自身作为传输类实例。可以将 Transport 属性设置为其他合适类的实例(如果已定义此类)。

  1. Web 客户端实例执行传输类的 DoSOAPRequest() 方法,并传递以下参数:

a. Web 客户端类的 OREF

b. 指定 SOAP 操作的字符串。

c. 包含以 UTF-8 编码的请求的流。

d. (通过引用)包含响应的流。

  1. Web 客户端实例检查结果的状态并采取相应行动。

对于 HTTP 传输,DoSOAPRequest() 方法包括以下逻辑:

  1. 创建请求对象(%Net.HttpRequest 的实例)并设置其属性。此处,该方法使用 Web 客户端实例的属性值,特别是 HttpRequestHeaderCharset 和其他与 HTTP 相关的属性。
  2. 遍历 SOAP 请求中的标头并初始化请求对象中的标头。
  3. 执行请求对象的Post()方法,这是一个适合HTTP传输的动作。
  4. 获取响应并返回。

重要提示:请勿直接使用 %SOAP.WebClientDoSOAPRequest() 方法。我们无法保证其行为或未来操作。上述摘要仅作为一般提示提供。

为 Web 客户端定义自定义传输

要使 Web 客户端能够使用自定义传输,请定义自定义传输类。然后,在创建 Web 客户端实例后,将其 Transport 属性设置为等于传输类的实例。

transport类别的要求如下:

  • 该类必须是可实例的(即非抽象的)。
  • 该类必须实现如下所述的 DoSOAPRequest() 方法。

DoSOAPRequest() 方法应将请求传输到 Web 服务并获取响应。此方法的签名必须如下:

复制代码
Method DoSOAPRequest(webClient,action,requestStream, responseStream) As %Status 
  • webClientWeb 客户端类的 OREF
  • action%String,它指定了 SOAP 操作。
  • requestStream 是包含以 UTF-8 编码的请求的流。
  • responseStreamDoSOAPRequest() 用于写入响应的参数中的 %FileBinaryStream 此流必须包含 ?xml 指令的编码属性指定的字符集中的数据。建议使用 UTF-8
相关推荐
GIS之路7 分钟前
GeoTools 结合 OpenLayers 实现空间查询
前端
陳有味_ChenUvi7 分钟前
使用 pnpm 优雅搭建 Monorepo 仓库
前端·npm·前端工程化
旷世奇才李先生10 分钟前
XML DOM 安装使用教程
xml·前端·chrome
程序员秘密基地17 分钟前
基于html,css,vue,vscode,vs2022,asp.net,aspnet,.net,c#,mysql数据库,在线健身,俱乐部管理系统
前端·vue.js·后端·mysql·asp.net
Mintopia19 分钟前
Three.js 画布纹理:像素世界的魔法编织术
前端·javascript·three.js
天天摸鱼的java工程师19 分钟前
当我成为面试官,我才知道当年那些面试官其实并不是在难为我,而是在考察我面对问题的拆解能力
前端·后端·面试
袁煦丞23 分钟前
泰拉瑞亚远程联机魔法:cpolar内网穿透实验室第617个成功挑战
前端·程序员·远程工作
玲小珑26 分钟前
Next.js 教程系列(十二)API Routes:构建轻量级后端服务
前端·next.js
JinSo32 分钟前
EasyEditor AI 聊天助手:让低代码开发更简单
前端·javascript·github
答案answer36 分钟前
three.js 实现几个炫酷的粒子特效(火焰,烟雾,烟花)
前端·three.js