是否有任何包在 Go 上支持SOAP/WSDL ?
5 回答
Go 中不支持 WSDL。其他语言的支持要么是静态的,要么是动态的:要么是从 WSDL 预先生成的结构,要么是使用哈希表动态完成的。
但是,您可以手动对 SOAP 请求进行编码和解码。我发现标准encoding/xml
包对于 SOAP 来说是不够的。不同的服务器有很多怪癖,并且限制encoding/xml
使得很难生成这些服务器满意的请求。
例如,有些服务器需要xsi:type="xsd:string"
对每个字符串进行标记。为了正确执行此操作,您的结构需要如下所示encoding/xml
:
type MethodCall struct {
One XSI
Two XSI
}
type XSI struct {
Type string `xml:"xsi:type,attr"`
Vaue string `xml:",chardata"`
}
你像这样构造它:
MethodCall{
XSI{"xsd:string", "One"},
XSI{"xsd:string", "Two"},
}
这给了你:
<MethodCall>
<One xsi:type="xsd:string">One</One>
<Two xsi:type="xsd:string">Two</Two>
</MethodCall>
现在这可能没问题。它当然可以完成工作。但是,如果您需要的不仅仅是一个string
? encoding/xml
目前不支持interface{}
。
如您所见,这变得很复杂。如果您有一个要集成的 SOAP API,这可能不会太糟糕。如果你有几个,每个都有自己的怪癖怎么办?
如果你能做到这一点不是很好吗?
type MethodCall struct {
One string
Two string
}
然后说encoding/xml
:“此服务器需要 xsi 类型”。
为了解决这个问题,我创建了github.com/webconnex/xmlutil。这是一项正在进行的工作。它没有encoding/xml
编码器/解码器的所有功能,但它具有 SOAP 所需的功能。
这是一个工作示例:
package main
import (
"bytes"
"encoding/xml"
"fmt"
"github.com/webconnex/xmlutil"
"log"
//"net/http"
)
type Envelope struct {
Body `xml:"soap:"`
}
type Body struct {
Msg interface{}
}
type MethodCall struct {
One string
Two string
}
type MethodCallResponse struct {
Three string
}
func main() {
x := xmlutil.NewXmlUtil()
x.RegisterNamespace("http://www.w3.org/2001/XMLSchema-instance", "xsi")
x.RegisterNamespace("http://www.w3.org/2001/XMLSchema", "xsd")
x.RegisterNamespace("http://www.w3.org/2003/05/soap-envelope", "soap")
x.RegisterTypeMore(Envelope{}, xml.Name{"http://www.w3.org/2003/05/soap-envelope", ""},
[]xml.Attr{
xml.Attr{xml.Name{"xmlns", "xsi"}, "http://www.w3.org/2001/XMLSchema-instance"},
xml.Attr{xml.Name{"xmlns", "xsd"}, "http://www.w3.org/2001/XMLSchema"},
xml.Attr{xml.Name{"xmlns", "soap"}, "http://www.w3.org/2003/05/soap-envelope"},
})
x.RegisterTypeMore("", xml.Name{}, []xml.Attr{
xml.Attr{xml.Name{"http://www.w3.org/2001/XMLSchema-instance", "type"}, "xsd:string"},
})
buf := new(bytes.Buffer)
buf.WriteString(`<?xml version="1.0" encoding="utf-8"?>`)
buf.WriteByte('\n')
enc := x.NewEncoder(buf)
env := &Envelope{Body{MethodCall{
One: "one",
Two: "two",
}}}
if err := enc.Encode(env); err != nil {
log.Fatal(err)
}
// Print request
bs := buf.Bytes()
bs = bytes.Replace(bs, []byte{'>', '<'}, []byte{'>', '\n', '<'}, -1)
fmt.Printf("%s\n\n", bs)
/*
// Send response, SOAP 1.2, fill in url, namespace, and action
var r *http.Response
if r, err = http.Post(url, "application/soap+xml; charset=utf-8; action="+namespace+"/"+action, buf); err != nil {
return
}
dec := x.NewDecoder(r.Body)
*/
// Decode response
dec := x.NewDecoder(bytes.NewBufferString(`<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope>
<soap:Body>
<MethodCallResponse>
<Three>three</Three>
</MethodCallResponse>
</soap:Body>
</soap:Envelope>`))
find := []xml.Name{
xml.Name{"", "MethodCallResponse"},
xml.Name{"http://www.w3.org/2003/05/soap-envelope", "Fault"},
}
var start *xml.StartElement
var err error
if start, err = dec.Find(find); err != nil {
log.Fatal(err)
}
if start.Name.Local == "Fault" {
log.Fatal("Fault!") // Here you can decode a Soap Fault
}
var resp MethodCallResponse
if err := dec.DecodeElement(&resp, start); err != nil {
log.Fatal(err)
}
fmt.Printf("%#v\n\n", resp)
}
在上面的示例中,我使用该Find
方法来获取响应对象或故障。这不是绝对必要的。你也可以这样做:
x.RegisterType(MethodCallResponse{})
...
// Decode response
dec := x.NewDecoder(bytes.NewBufferString(`<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope>
<soap:Body>
<MethodCallResponse>
<Three>three</Three>
</MethodCallResponse>
</soap:Body>
</soap:Envelope>`))
var start *xml.StartElement
var resp Envelope
if err := dec.DecodeElement(&resp, start); err != nil {
log.Fatal(err)
}
fmt.Printf("%#v\n\n", resp)
当您的数据如下所示时,您会发现该Find
方法很有用:
<soap:Envelope>
<soap:Body>
<MethodResponse>
<MethodResult>
<diffgr:diffgram>
<NewDataSet>
<Table1 diffgr:id="Table1" msdata:rowOrder="0" diffgr:hasChanges="inserted">
<Three>three</Three>
</Table1>
</NewDataSet>
</diffgr:diffgram>
</MethodResult>
</MethodResponse>
</soap:Body>
</soap:Envelope>
这是一个 DiffGram,是 Microsoft .NET 的一部分。您可以使用该Find
方法到达Table1
. Decode
andDecodeElement
方法也适用于切片。所以你可以传入一个[]MethodCallResponse
ifNewDataSet
碰巧包含多个结果。
我同意 Zippower 的观点,即 SOAP 确实很烂。但不幸的是,很多企业都在使用 SOAP,有时你不得不使用这些 API。使用 xmlutil 包,我希望使用它可以减轻一些痛苦。
没有。
SOAP 很烂,但我必须实现一个使用 SOAP 的已定义协议的服务器,所以我net/http
用encoding/xml
. 几分钟后,我已经用 Go 送达了我的第一个信封。
还有wsdl-go。
但是我没有用过,所以我真的不能说。