第九章 从 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
相关推荐
理想不理想v2 分钟前
vue经典前端面试题
前端·javascript·vue.js
不收藏找不到我3 分钟前
浏览器交互事件汇总
前端·交互
。puppy11 分钟前
HCIP--3实验- 链路聚合,VLAN间通讯,Super VLAN,MSTP,VRRPip配置,OSPF(静态路由,环回,缺省,空接口),NAT
运维·服务器
YBN娜17 分钟前
Vue实现登录功能
前端·javascript·vue.js
阳光开朗大男孩 = ̄ω ̄=17 分钟前
CSS——选择器、PxCook软件、盒子模型
前端·javascript·css
颇有几分姿色20 分钟前
深入理解 Linux 内存管理:free 命令详解
linux·运维·服务器
minDuck21 分钟前
ruoyi-vue集成tianai-captcha验证码
java·前端·vue.js
小政爱学习!42 分钟前
封装axios、环境变量、api解耦、解决跨域、全局组件注入
开发语言·前端·javascript
魏大帅。1 小时前
Axios 的 responseType 属性详解及 Blob 与 ArrayBuffer 解析
前端·javascript·ajax
花花鱼1 小时前
vue3 基于element-plus进行的一个可拖动改变导航与内容区域大小的简单方法
前端·javascript·elementui