WebService开发（一） 如何使用Soap头

平时写Web Service时经常会对Service的访问进行安全控制，方法很多，这里介绍一下如何用Soap头来进行控制的一例。

第一步:引用需要用到的名称空间

using System; using System.Xml; using System.Xml.Serialization; using System.Web.Services; using System.Web.Services.Protocols;　

 

第二步:建立自定义的SoapHeader类MySoapHeader

public class MySoapHeader : SoapHeader { 　　　 string _name; 　　　 string _passWord; 　　　 public string Name 　　　 { 　　　　　　　 get { return _name; } 　　　　　　　 set { _name = value; } 　　　 } 　　　 public string PassWord 　　　 { 　　　　　　　 get { return _passWord; } 　　　　　　　 set { _passWord = value; } 　　　 } }

第三步:建立WebSerivce

      MyService类有一个MySoapHeader类型的字段公共header,在客户调用CheckHeader之前需要给header付一个新实例，服务器端检验这个实例的成员信息。失败我们抛出一个oapHeaderException，这个异常的新实例，这里调用两个参数的构造函数。第一个参数是自定义的异常原因，第二个参数我们用SoapException.ClientFaultCode表示客户的调用格式不正确或缺少必要的信息。

[WebService(Namespace = "http://DavidFan.cnblogs.com")] public class MyService : System.Web.Services.WebService { 　　　 public MySoapHeader header; 　　　 [SoapHeader("header", Direction = SoapHeaderDirection.In)] 　　　 public string CheckHeader() 　　　 { 　　　　　　　 if (header == null) 　　　　　　　 { 　　　　　　　　　　　 throw new SoapHeaderException("认证失败", SoapException.ClientFaultCode); 　　　　　　　 } 　　　　　　　 else 　　　　　　　 { 　　　　　　　　　　　 if (header.Name != "admin" || header.PassWord != "admin") 　　　　　　　　　　　 { 　　　　　　　　　　　　　　　 throw new SoapHeaderException("认证失败", SoapException.ClientFaultCode); 　　　　　　　　　　　 } 　　　　　　　 } 　　　　　　　 //业务逻辑. 　　　　　　　 return "Something done"; 　　　 } }

第四步:客户端进行调用,这里的MySoapHeader，和MyService类即为WSDL工具生成代理类,对应服务端的上两个类。

      我们首先new 一个MySoapHeader的新实例,然后付个Myservice的新实例的header字段,最后调用CheckHeader这个服务器的方法，CheckHeader方法的header!=null，接着进行Name和PassWord的验证。

　　客户端try-catch块内首先捕获SoapHeaderException(如果有的话)。然后捕获Exception。好了整个过程只需这几步。

public class ServiceClient { 　　　 protected void ClientMethod(string name, string passWord) 　　　 { 　　　　　　　 MySoapHeader h = new MySoapHeader(); 　　　　　　　 h.Name = name; 　　　　　　　 h.PassWord = passWord; 　　　　　　　 MyService service = new MyService(); 　　　　　　　 service.header = h; 　　　　　　　 try 　　　　　　　 { 　　　　　　　　　　　 string retval = service.CheckHeader(); 　　　　　　　　　　　 Console.WriteLine("Return:" + retval); 　　　　　　　 } 　　　　　　　 catch (SoapHeaderException soapEx) 　　　　　　　 { 　　　　　　　　　　　 Console.WriteLine("Soap Header Exception:" + soapEx.Message); 　　　　　　　 } 　　　　　　　 catch (Exception ex) 　　　　　　　 { 　　　　　　　　　　　 Console.WriteLine("Exception:" + ex.Message); 　　　　　　　 } 　　　 } }