萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# 動態 WebService 調用:反射調用與 SOAP 請求構建完整實現

動態調用核心價值

動態 WebService 調用無需預先生成代理類,通過解析 WSDL 或直接構建 SOAP 請求,實現運行時決定調用接口、參數、地址,適用於插件系統、聚合網關、測試工具等場景。

三種調用模式對比

1. HTTP GET 調用

public static XmlDocument QueryGetWebService(string url, string method, Hashtable pars) {
    string queryString = ParsToString(pars); // key1=val1&key2=val2
    HttpWebRequest request = (HttpWebRequest)WebRequest.Create($"{url}/{method}?{queryString}");
    request.Method = "GET";
    request.ContentType = "application/x-www-form-urlencoded";
    return ReadXmlResponse(request.GetResponse());
}

2. HTTP POST 表單調用

public static XmlDocument QueryPostWebService(string url, string method, Hashtable pars) {
    HttpWebRequest request = (HttpWebRequest)WebRequest.Create($"{url}/{method}");
    request.Method = "POST";
    request.ContentType = "application/x-www-form-urlencoded";
    byte[] data = EncodePars(pars);
    WriteRequestData(request, data);
    return ReadXmlResponse(request.GetResponse());
}

3. SOAP 協議調用(企業級標準)

private static Hashtable _namespaceCache = new Hashtable();

public static XmlDocument QuerySoapWebService(string url, string method, Hashtable pars) {
    string ns = _namespaceCache[url]?.ToString() ?? GetNamespace(url);
    _namespaceCache[url] = ns;
    return QuerySoapWebService(url, method, pars, ns);
}

private static XmlDocument QuerySoapWebService(string url, string method, Hashtable pars, string xmlNs) {
    HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
    request.Method = "POST";
    request.ContentType = "text/xml; charset=utf-8";
    request.Headers.Add("SOAPAction", $"\"{xmlNs.TrimEnd('/')}/{method}\"");
    
    byte[] soapData = EncodeParsToSoap(pars, xmlNs, method);
    WriteRequestData(request, soapData);
    
    XmlDocument doc = ReadXmlResponse(request.GetResponse());
    // 解析 SOAP 響應提取業務數據
    return ExtractSoapBody(doc);
}

關鍵輔助方法

參數編碼

private static byte[] EncodePars(Hashtable pars) {
    StringBuilder sb = new StringBuilder();
    foreach (DictionaryEntry de in pars) {
        if (sb.Length > 0) sb.Append("&");
        sb.AppendFormat("{0}={1}", 
            HttpUtility.UrlEncode(de.Key.ToString()), 
            HttpUtility.UrlEncode(de.Value?.ToString() ?? ""));
    }
    return Encoding.UTF8.GetBytes(sb.ToString());
}

private static byte[] EncodeParsToSoap(Hashtable pars, string ns, string method) {
    StringBuilder sb = new StringBuilder();
    sb.Append("");
    sb.Append("");
    sb.Append("");
    sb.AppendFormat("<{0} xmlns=\"{1}\">", method, ns);
    
    foreach (DictionaryEntry de in pars) {
        sb.AppendFormat("<{0}>{1}", de.Key, 
            HttpUtility.HtmlEncode(de.Value?.ToString() ?? ""));
    }
    
    sb.AppendFormat("", method);
    sb.Append("");
    return Encoding.UTF8.GetBytes(sb.ToString());
}

響應讀取與解析

private static XmlDocument ReadXmlResponse(WebResponse response) {
    using (Stream stream = response.GetResponseStream())
    using (StreamReader reader = new StreamReader(stream, Encoding.UTF8)) {
        XmlDocument doc = new XmlDocument();
        doc.LoadXml(reader.ReadToEnd());
        return doc;
    }
}

private static XmlDocument ExtractSoapBody(XmlDocument soapResponse) {
    XmlNamespaceManager nsmgr = new XmlNamespaceManager(soapResponse.NameTable);
    nsmgr.AddNamespace("soap", "https://schemas.xmlsoap.org/soap/envelope/");
    XmlNode body = soapResponse.SelectSingleNode("//soap:Body", nsmgr);
    
    XmlDocument result = new XmlDocument();
    if (body != null) {
        result.LoadXml(body.InnerXml);
    }
    return result;
}

命名空間獲取(解析 WSDL)

private static string GetNamespace(string url) {
    // 簡化版:請求 ?wsdl 解析 targetNamespace
    // 生產環境建議緩存 WSDL 解析結果
    HttpWebRequest req = (HttpWebRequest)WebRequest.Create(url + "?wsdl");
    using (var resp = req.GetResponse())
    using (var stream = resp.GetResponseStream()) {
        XmlDocument wsdl = new XmlDocument();
        wsdl.Load(stream);
        XmlNamespaceManager nsmgr = new XmlNamespaceManager(wsdl.NameTable);
        nsmgr.AddNamespace("wsdl", "https://schemas.xmlsoap.org/wsdl/");
        XmlNode def = wsdl.SelectSingleNode("//wsdl:definitions", nsmgr);
        return def?.Attributes["targetNamespace"]?.Value ?? "";
    }
}

使用示例

Hashtable args = new Hashtable();
args.Add("userId", "12345");
args.Add("includeDetails", true);

XmlDocument result = WebServiceCaller.QuerySoapWebService(
    "https://api.example.com/UserService.asmx", 
    "GetUserProfile", 
    args
);

// 解析業務數據
XmlNode userNode = result.SelectSingleNode("//User");
string name = userNode?.SelectSingleNode("Name")?.InnerText;

生產環境強化建議

  • 超時控制:request.Timeout = 30000; 防止掛死
  • 重試策略:指數退避重試瞬時故障
  • 證書驗證:HTTPS 環境配置 ServerCertificateValidationCallback
  • 連接池:ServicePointManager.DefaultConnectionLimit = 100;
  • 異步模式:使用 HttpClient + async/await 替代阻塞調用

動態調用雖靈活,但缺乏編譯時類型檢查,建議配合契約測試(如 Pact)保障接口兼容性。

copyright © 萬盛學電腦網 all rights reserved