Gox语言中访问Web Service（SOAP）服务-GX44

本文链接：https://blog.csdn.net/weixin_41462458/article/details/107583317

Gox对Web Service（SOAP）服务进行访问也是非常容易的，基本只需要用到tk包即可进行基本的服务请求发送和服务反馈接收，以及简单的XML处理。

下面是一个实际应用中的例子，仅将实际网址做了变化。

// 准备发送到Web Service的XML请求体
// 其中用“TX_”和“_TX”包含的是准备替换的文本
// 这里用了简化处理，如果需要严谨的XML文本生成
// 可以使用github.com/beevik/etree包（用github_beevik_etree引用）
xmlT = `
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <Body>
        <CreateReceipt xmlns="urn:sap-com:document:sap:soap:functions:mc-style">
            <Path xmlns="">TX_Path_XT</Path>
            <Reserv1 xmlns="">TX_Reserv1_XT</Reserv1>
            <Reserv2 xmlns="">TX_Reserv2_XT</Reserv2>
            <Reserv3 xmlns="">TX_Reserv3_XT</Reserv3>
            <Vbeln xmlns="">TX_Vbeln_XT</Vbeln>
        <CreateReceipt>
    </Body>
</Envelope>
`

// 替换其中的文本内容为自己所需的值
// 注意要把文本值用tk.EncodeToXMLString函数编码一下
// 以防出现会对XML文本造成混淆的字符（例如“<”或“>”等）
bodyT = tk.Replace(xmlT, "TX_Path_XT", tk.EncodeToXMLString(urlT))
bodyT = tk.Replace(bodyT, "TX_Vbeln_XT", tk.EncodeToXMLString(v.customerOrderId))
bodyT = tk.Replace(bodyT, "TX_Reserv1_XT", tk.EncodeToXMLString(v.printSn))
bodyT = tk.Replace(bodyT, "TX_Reserv2_XT", tk.EncodeToXMLString(v.signDate))
bodyT = tk.Replace(bodyT, "TX_Reserv3_XT", tk.EncodeToXMLString(v.receiptUploadDate))

// 访问WebService接口
// 替换其中的URL为自己实际的SOAP服务地址和端口
// 其中请求头中加入了一个空的SOAPAction字段
// 这是因为某些旧的SOAP服务需要这个字段
rs, errT = tk.PostRequestX("http://your.webservice.com:8001/soap/create_receipt/801/create_receipt/create_receipt", tk.Trim(bodyT), "Content-Type:text/xml; charset=\"utf-8\"\nSOAPAction:", 15)

// 检查可能出现的错误
if errT != nil {
	tk.Pl("server response error: err: %v", errT)
	exit()
}

// 获取服务返回信息的某个xml字段
// 我们这个例子服务将返回类似“<xml><response><Flag>1</Flag></response></xml>”这样的响应
flagT, err = tk.GetNodeStringFromXML(rs, "Flag")

checkErrf("failed to get flag: %v", err)

if flagT != "" {
	pl("invalid flag: %v", flagT)
	exit()
}

代码中已有详尽的注释，整个过程可以描述成下面几步：1、封装请求的XML内容；2、发送SOAP请求到指定的网络地址和端口；3、接收服务器的相应信息；4、分析服务器返回的XML内容并作相应的处理。

tk.PostRequestX函数用于向任何支持HTTP协议的服务器发送POST请求，其参数中，第一个是网络地址和端口；第二个是POST的内容（以字符串方式传递）；第三个是附加的请求头（如果没有直接传空字符串即可），这里指定了Content-Type即内容类型是XML，并指定了一个空的字段SOAPAction，有些老的服务器需要这个字段才能正常工作（注意两个字段间要用换行符“\n”隔开）；最后一个参数是用于设定请求的超时时间，单位是秒。

tk.GetNodeStringFromXML函数则是一个快捷函数，用于从XML文档中获取一个节点的文本值，如果存在多个该名称的节点，该函数仅返回第一个。

注意：

Gox语言是脱胎于Go语言（Golang）的开源脚本语言，解释执行，但相比Go语言更贴近高级语言，语法硬性限制也少一些；是一门偏向快速应用的语言，也可以说是一个集成工具；
Gox语言主要优势有三点：
- 第一，Gox语言本身只有一个可执行文件，绿色免配置，下载即可使用，无需安装Go语言环境，无需编译，非常适合快速制作原型以及云服务器上的远程开发；
- 第二，Gox中可以直接使用绝大多数Go语言标准库中的对象和方法函数，也内置了很多常用、优秀的第三方库，充分发挥Go语言多年积累的资源优势；
- 第三，与很多其他主流语言不同，Gox语言着力解决了GUI图形界面编程的问题，内置了基于Giu（imgui）、LCL、Sciter的三套图形界面编程库，直接可以进行快捷高效的图形界面开发（LCL、Sciter只需分别下载一个动态链接库文件，执行和分发时附带上即可），特别适合编写演示原型系统。

作为脚本语言，Gox语言性能肯定不如Go语言这样的编译型语言快，但由于Gox语言与Go语言的紧密联系，Gox语言编写的脚本可以很容易的改写成Go语言代码，编译执行后就可以发挥Go语言的速度优势了。因此，Gox语言也比较适合做初期的Go语言调试，还有一个更直接的方式是使用Gotx（在Gox官网上也有下载），这是使用完全和Go语言一样语法的解释器，可以理解成集成了Go语言标准库和不少第三方库的解释执行的Go语言，一样也不需要搭建Go语言环境。Gotx与Gox的区别在于，Gotx仍然遵循Go语言的文法，代码相对复杂一些，限制也多一些，但改写回Go语言准备编译执行时，基本上没有成本。

Gox的官网在这里，也可以在浏览器搜索引擎中直接搜索“gox语言”，Github页面在这里，在这里可以看到很多Gox语言的学习指南和实际应用实例。