asp.net訪問WebService的各種方式

WebService的訪問形式主要有：SOAP調用、XMLHTTP POST、GET調用、MicroSoft.XMLDOMC調用、webbehavior.htc調用

我們知道的在C#后台本地調用Webservice最簡單、快捷的調用WebService的方法即通過鼠標手動添加web服務引用的方式。實際操作中我們會使用到另外一種方式，即通過HttpWebRequest構造請求。這種方式下以Post和Get兩種請求為主，另外還有通用方式調用。一共三種。下面我們來看實際操作的實現方法。

由於這三種方式在實現原理上是相似的。只是具體的方式不同（哈哈，我的表述不是很專業，能理解是怎么回事就行）。於是我們抽象出公共的基類:WebServiceCaller

/// <summary>
/// 訪問webservice基類
/// </summary>
public abstract class WebServiceCaller
{
    /// <summary>
    /// 請求WebService
    /// </summary>
    /// <param name="URL">WebService的路徑</param>
    /// <param name="MethodName">方法名</param>
    /// <param name="Pars">參數</param>
    /// <returns></returns>
    abstract public System.Xml.XmlDocument RequestWebService(ResquestParams rp);

    /// <summary>
    /// 設置憑證與超時時間
    /// </summary>
    /// <param name="request"></param>
    public static void SetWebRequest(HttpWebRequest request)
    {
        request.Credentials = CredentialCache.DefaultCredentials;
        request.Timeout = 10000;
    }

    /// <summary>
    /// 讀取響應輸出流
    /// </summary>
    /// <param name="response"></param>
    /// <returns></returns>
    public static XmlDocument ReadXmlResponse(WebResponse response)
    {
        StreamReader sr = new StreamReader(response.GetResponseStream(), Encoding.UTF8);
        String retXml = sr.ReadToEnd();
        sr.Close();
        XmlDocument doc = new XmlDocument();
        doc.LoadXml(retXml);
        return doc;
    }

    public static String ParsToString(Hashtable Pars)
    {
        StringBuilder sb = new StringBuilder();
        foreach (string k in Pars.Keys)
        {
            if (sb.Length > 0)
            {
                sb.Append("&");
            }
            sb.Append(HttpUtility.UrlEncode(k) + "=" + HttpUtility.UrlEncode(Pars[k].ToString()));
        }
        return sb.ToString();
    }
}

Post方式調用Webservice類的實現代碼:

/// <summary>
/// Post方式訪問
/// </summary>
public class WebServiceCallerByPost : WebServiceCaller
{
    public override XmlDocument RequestWebService(ResquestParams rp)
    {
        HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(rp.URL + "/" + rp.MethodName);
        request.Method = "POST";
        request.ContentType = "application/x-www-form-urlencoded";
        SetWebRequest(request);
        byte[] data = EncodePars(rp.Parames);
        WriteRequestData(request, data);
        return ReadXmlResponse(request.GetResponse());
    }

    /// <summary>
    /// 參數編碼
    /// </summary>
    /// <param name="Pars"></param>
    /// <returns></returns>
    private static byte[] EncodePars(Hashtable Pars)
    {
        return Encoding.UTF8.GetBytes(ParsToString(Pars));
    }

    /// <summary>
    /// 添加請求參數
    /// </summary>
    /// <param name="request"></param>
    /// <param name="data"></param>
    private static void WriteRequestData(HttpWebRequest request, byte[] data)
    {
        request.ContentLength = data.Length;
        System.IO.Stream writer = request.GetRequestStream();
        writer.Write(data, 0, data.Length);
        writer.Close();
    }

}

Get方式調用Webservice類的實現代碼:

/// <summary>
/// Get方式訪問
/// </summary>
public class WebServiceCallerByGet : WebServiceCaller
{
    public override XmlDocument RequestWebService(ResquestParams rp)
    {
        HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(rp.URL + "/" + rp.MethodName + "?" + ParsToString(rp.Parames));
        request.Method = "GET";
        request.ContentType = "application/x-www-form-urlencoded";
        SetWebRequest(request);
        return ReadXmlResponse(request.GetResponse());
    }
}

通用方式調用Webservice類的實現代碼:

/// <summary>
/// 通用方式調用webservice
/// </summary>
public class SoapWebService : WebServiceCaller
{

    public override XmlDocument RequestWebService(ResquestParams rp)
    {
        if (_xmlNamespaces.ContainsKey(rp.URL))
        {
            return QuerySoapWebService(rp.URL, rp.MethodName, rp.Parames, _xmlNamespaces[rp.URL].ToString());
        }
        else
        {
            return QuerySoapWebService(rp.URL, rp.MethodName, rp.Parames, GetNamespace(rp.URL));
        }
    }

    private static XmlDocument QuerySoapWebService(String URL, String MethodName, Hashtable Pars, string XmlNs)
    {
        _xmlNamespaces[URL] = XmlNs;//加入緩存，提高效率
        HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(URL);
        request.Method = "POST";
        request.ContentType = "text/xml; charset=utf-8";
        request.Headers.Add("SOAPAction", "\"" + XmlNs + (XmlNs.EndsWith("/") ? "" : "/") + MethodName + "\"");
        SetWebRequest(request);

        byte[] data = EncodeParsToSoap(Pars, XmlNs, MethodName);

        WriteRequestData(request, data);
        XmlDocument doc = new XmlDocument(), doc2 = new XmlDocument();
        doc = ReadXmlResponse(request.GetResponse());

        XmlNamespaceManager mgr = new XmlNamespaceManager(doc.NameTable);
        mgr.AddNamespace("soap", "http://schemas.xmlsoap.org/soap/envelope/");


        String RetXml = doc.SelectSingleNode("//soap:Body/*/*", mgr).InnerXml;

        doc2.LoadXml("<root>" + RetXml + "</root>");

        AddDelaration(doc2);

        return doc2;
    }

    private static string GetNamespace(String URL)
    {
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(URL + "?WSDL");
        SetWebRequest(request);
        WebResponse response = request.GetResponse();
        System.IO.StreamReader sr = new System.IO.StreamReader(response.GetResponseStream(), Encoding.UTF8);
        XmlDocument doc = new XmlDocument();
        doc.LoadXml(sr.ReadToEnd());
        sr.Close();
        return doc.SelectSingleNode("//@targetNamespace").Value;
    }

    private static byte[] EncodeParsToSoap(Hashtable Pars, String XmlNs, String MethodName)
    {
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\"></soap:Envelope>");
        AddDelaration(doc);
        //XmlElement soapBody = doc.createElement_x_x("soap", "Body", "http://schemas.xmlsoap.org/soap/envelope/");
        XmlElement soapBody = doc.CreateElement("soap", "Body", "http://schemas.xmlsoap.org/soap/envelope/");
        //XmlElement soapMethod = doc.createElement_x_x(MethodName);
        XmlElement soapMethod = doc.CreateElement(MethodName);
        soapMethod.SetAttribute("xmlns", XmlNs);
        foreach (string k in Pars.Keys)
        {
            //XmlElement soapPar = doc.createElement_x_x(k);
            XmlElement soapPar = doc.CreateElement(k);
            soapPar.InnerXml = ObjectToSoapXml(Pars[k]);
            soapMethod.AppendChild(soapPar);
        }
        soapBody.AppendChild(soapMethod);
        doc.DocumentElement.AppendChild(soapBody);
        return Encoding.UTF8.GetBytes(doc.OuterXml);
    }

    private static void WriteRequestData(HttpWebRequest request, byte[] data)
    {
        request.ContentLength = data.Length;
        System.IO.Stream writer = request.GetRequestStream();
        writer.Write(data, 0, data.Length);
        writer.Close();
    }

    private static void AddDelaration(XmlDocument doc)
    {
        XmlDeclaration decl = doc.CreateXmlDeclaration("1.0", "utf-8", null);
        doc.InsertBefore(decl, doc.DocumentElement);
    }

    private static string ObjectToSoapXml(object o)
    {
        XmlSerializer mySerializer = new XmlSerializer(o.GetType());
        MemoryStream ms = new MemoryStream();
        mySerializer.Serialize(ms, o);
        XmlDocument doc = new XmlDocument();
        doc.LoadXml(Encoding.UTF8.GetString(ms.ToArray()));
        if (doc.DocumentElement != null)
        {
            return doc.DocumentElement.InnerXml;
        }
        else
        {
            return o.ToString();
        }
    }

    private static Hashtable _xmlNamespaces = new Hashtable();//緩存xmlNamespace，避免重復調用GetNamespace

在編碼調用時可以考慮設計一個請求參數類

public class ResquestParams
{
    /// <summary>
    /// WebService地址
    /// </summary>
    public string URL { get; set; }
    /// <summary>
    /// web方法
    /// </summary>
    public string MethodName { get; set; }
    /// <summary>
    /// 方法參數
    /// </summary>
    public Hashtable Parames { get; set; }
}

另外我們在aspx前台頁面也會通過js代碼來調用Webservice。此處略帶"串燒"一下

$.post():

$(document).ready(function () {
    $("#btnRequest").click(function () {
        $.ajax({
            type: "post",
            contentType: "application/json",
            url: "http://localhost:5158/TestWebService.asmx/Add",
            data: "{m:12,n:2}", //注意區別於get方式的參數格式
            datatype: "json",
            error: function (x, e) {
                alert(x.responseText);
            },
            success: function (result) {
                alert(result.d);
            }
        });
    });
});

$.get():

$(document).ready(function () {
    $("#btnRequest").click(function () {
        $.ajax({
            type: "get",
            contentType: "application/json",
            url: "http://localhost:5158/TestWebService.asmx/Add",
            data: {'m':'12','n':'2'},
            datatype: "json",
            error: function (x, e) {
                alert(x.responseText);
            },
            success: function (result) {
                alert(result.d);
            }
        });
    });
});

注1：如果采用以上HTTP GET方式在后台訪問WebService總是報500異常的話，那么很可能是你需要在WebService所在的站點下的配置文件中加上如下配置：

<webServices> 
   <protocols> 
       <add name= "HttpPost " /> 
       <add name= "HttpGet " /> 
    </protocols> 
</webServices>

注2：如果以上通過ajax.get()方式訪問WebService時候提示這樣的錯誤：嘗試使用GET請求調用方法xx，但是不允許這樣做。那么就是所調用的方法不支持腳本通過GET方式調用，需要在所調用的方法加上[ScriptMethod(UseHttpGet=true)]就ok了。

這里僅僅介紹如何消費WebService，其實要完整地學習它，我們還要了解它的歷史沿革。好了就介紹到這兒。