Web Service学习笔记：WEB SERVICES异常

当WEB SERVICES引发一个不在内部处理的异常时,异常将被传送到ASP.NET,来决定如何处理.
通常有两种:


1)将异常发往HTTP客户端,ASP.NET将向客户端返回一条HTTP INTERNAL SERVER ERROR(内部错误,错误代码是500)消息,客户端根据消息进行处理.


2)将异常发往SOAP客户端

如果客户端使用SOAP协议,ASP.NET则先将其作为SOAP错误,然后传回客户端.使用SOAP代理的客户端收到一个SOAP错误时,其响应方式与前一种差不多,不同的是SOAP代理引发的是SYSTEM.WEB.SERVICES.PROTOCOLS.SOAPEXCEPTION.,并将SOAPEXCEPTION.CODE的值设置为SOAP错误的FAULTCODE字段(默认是服务器错误)的值,将SOAPEXCEPTION.MESSAGE属性设置为FAULTSTRIN字段(默认是表示捕获异常的堆栈跟踪的字符串)的值.

但这种方法的缺点是无论WEB SERVICES抛出何种异常,客户端都是抛出SOAPEXCEPTION.解决的方法就不允许ASP.NET自动处理未被捕获的客户端绑定异常,WEB SERVICES必须捕获所有应用程序异常,并明确抛一个SOAPEXCEPTIONASP.NET捕获时将正确地使用SOAPEXCEPTION的CODE和MESSAGE属性来填充SOA的错误的FAULTCODE和FAULTSTRING元素,这样,你就可以返回自定义错误代码,这些代码向客户端提供了有意义的错误信息,然后,客户端就可以捕获SOAPEXCEPTION,并用SOAPEXCEPTION.CODE属性提供的错误代码来执行适当的处理.不过这还是有缺陷,那就是客户端的开发人员必须知道怎么样处理这些代码,所以必须将这些信息放进系统文档.

自定义的错误代码

 

 

public sealed class e1 : ApplicationException
{
public e1(string message):base(message)
{
//描述该错误的信息,不做任何事,依赖于基类
// TODO: Add constructor logic here
//
}
}
public sealed class e2 : ApplicationException
{
public e2(string message):base(message)
{
//描述该错误的信息,不做任何事,依赖于基类
// TODO: Add constructor logic here
//
}
}

 

 

需要注意的是,SOAPEXCEPTION.CODE属性并非一个字符串,而是SYSTEM.XML.XMLQUALIFIEDNAME的一个实例,因此必须实例化它.如下:

 

 

using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Xml;
using System;
[WebServiceBinding(ConformanceClaims=WsiClaims.BP10,EmitConformanceClaims = true)]
public class Service : System.Web.Services.WebService 
{
XmlQualifiedName xname;
[WebMethod]
public int causeexception(int num)
{
int n;
try
{
n=num;
if (n == 1)
{
throw new e1("erroe e1 happen");
}
if (n == 2)
{
throw new e2("erroe e2 happen");
}
}
catch(ApplicationException ex)
{
throw GetException(ex);
}

return n;

}
private SoapException GetException(ApplicationException exx)
{

if (exx is e1)
{
xname = new XmlQualifiedName("e1");
}
if (exx is e2)
{
xname = new XmlQualifiedName("e2");
}
return new SoapException(exx.Message, xname);
}

}

 

 

客户端:

 

private void button1_Click(object sender, EventArgs e)
{
try
{
exception.Service s = new testexception.exception.Service();//实例化代理
if (this.radioButton1.Checked)
{
s.causeexception(1);//引发异常
}
if (this.radioButton2.Checked)
{
s.causeexception(2);
}
}
catch (SoapException ex)
{
switch(ex.Code.ToString())//根据SOAPEXCEPTION.CODE的值显示相应的消息
{
case "e1":MessageBox.Show("has error e1");
break;
case "e2":MessageBox.Show("has error e2");
break;
}
}

}