wcf契约版本处理与异常处理(随记)

时间:2024-04-19 20:11:05

-----------版本控制策略;必须支持向后兼容;----就是当服务端发生改变,但客户端未更新会不会发生错误;

一旦契约发布,若要契约发生变化,如何不影响客户端使用;

----wsdl:契约;

服务契约的变化--对客户端的影响:

操作签名的增加 (无影响,默认缺省值)

操作签名的删除(无影响,默认被忽略掉)

增加新的操作(无影响,客户端不知道)

删除操作、修改参数类型、修改返回值(报错)

---

数据契约的变化    对客户端的影响

添加non-required   无影响;

添加新的required   会报错;

删除 non-required  不会报错 但会丢失;

删除required        会报错;

修改数据类型;      如果类型兼容,会产生未知异常,否则报错;

解决版本兼容性;

----Iextensibledataobject是将冗杂的数据进行临时的保存;

public class DataUser:IExtensibleDataObject

{

private ExtensionDataObject obj;

public ExtensionDataObject ExtensionData

{

get

{

return obj;

}

set

{

obj = value;

}

}

}

----数据契约序列化器;测试新旧版本兼容;

1.using System.Runtime.Serialization;

2.          Person p = new Person();

p.Name = "郭泽峰";

DataContractSerializer ds = new DataContractSerializer(typeof(Person));

FileStream fs = new FileStream("cc.xml", FileMode.Create);

ds.WriteObject(fs, p);

fs.Close();

public partial class Form1 : Form

{

public Form1()

{

InitializeComponent();

}

private void button1_Click(object sender, EventArgs e)

{

Person1 p = new Person1();

p.Name = "d";

p.Id = 123;

DataContractSerializer ds = new DataContractSerializer(typeof(Person1));

FileStream fs = new FileStream("cc.xml", FileMode.Create);

ds.WriteObject(fs, p);

fs.Close();

}

private void button2_Click(object sender, EventArgs e)

{

//新版本到旧版本

DataContractSerializer ds = new DataContractSerializer(typeof(Person));

FileStream fs = new FileStream("cc.xml",FileMode.Open);

XmlDictionaryReader reader = XmlDictionaryReader.CreateTextReader(fs,new XmlDictionaryReaderQuotas());

Person per = (Person)ds.ReadObject(reader, false);

MessageBox.Show(per.Name);

fs.Close();

//旧版本到新版本

per.Name = "hhhhh";

DataContractSerializer dss = new DataContractSerializer(typeof(Person1));

FileStream fss = new FileStream("cc.xml", FileMode.Create);

ds.WriteObject(fss, per);

fss.Close();

}

}

3.这样就把对象生成xml文件了;

-----------可扩展数据对象:

namespace wcf1

{

[DataContract(Name="Person", Namespace="wcf1")]

public  class Person:IExtensibleDataObject

{

[DataMember]

public string Name {get;set;}

private ExtensionDataObject obj;

public ExtensionDataObject ExtensionData

{

get

{

return obj;

}

set

{

obj = value;

}

}

}

[DataContract(Name = "Person", Namespace = "wcf1")]

public class Person1 : IExtensibleDataObject

{

[DataMember]

public string Name { get; set; }

[DataMember]

public int Id { get; set; }

private ExtensionDataObject obj;

public ExtensionDataObject ExtensionData

{

get

{

return obj;

}

set

{

obj = value;

}

}

}

}

-----这样就可以实现新就版本的交互了;当然也有害处,若新版本增加了1mb数据,当提交给旧版本时,这1mb相当于没有用途;加重了负载;

--以上是可扩展数据对象;

禁止使用可扩展数据对象:

<behaviors >

<serviceBehaviors>

<behavior name="aa">

<dataContractSerializer ignoreExtensionDataObject="true"/>

</behavior>

</serviceBehaviors>

</behaviors>

后者是:

[ServiceBehavior( IgnoreExtensionDataObject=true)]

public  class Person:IExtensibleDataObject

------版本控制策略:

1.严格的版本控制,一旦改动重新生成,但是不实用;

2.使用的版本策略:向后或向前的兼容性;

保存未知元素和容忍缺失元素以至于可以兼容,单参数变化就不行了;

-------

1.添加操作,不用升级版本;

2.删除操作,升级版本;

3.添加了新的参数,不用升级,会默认缺省值;

4.参数发生了变化,升级版本;

5.删除了参数:不用升级版本;

----数据契约:

1.新添加成员,不用升级;

2.删除成员,不用升级;(多余的被忽略)

3.数据类型,名称发生变化,需要升级;

---

wcf缺省提供版本相容性支持;

------------------------------------------------------剖出异常:

1.所有异常都被序列化为soap faults; (soap 1.1和soap1.2格式)

2.soap1.2

Code:必须;可以是规范定义的代码

Reason:必须,错误字符串的解释信息

Role:可选;描述错误源的URI;

Detail:可选,提供错误的body信息;

Node:可选;描述产生错误的节点URI;

3. isoneway=true;标记后客户端并不能捕捉异常,而响应式则捕捉

4. 是否包含敏感信息;

两种方式:

1.在wcf服务中标记:

[ServiceBehaviorAttribute(IncluedeExceptionDetailsInFaults=true)]

puFaultblic class service:Iservice

{

}

2.web配置节点中的behavior里配置:<serviceDebug includeExceptionDetailInFaults="true">

5.剖出类型有三种:FaultException\FaultException<T>\MesssageFault:

(1)

throw new FaultException("");

throw new FaultException(new FaultReason(""));

throw new FaultException(new FaultReason(""),FaultCode.CreateSenderFaultCode(null));

(2) FaultException<T>,不利于互操作,

错误契约:[faultContract(typeof())]

T:必须是数据契约或是可序列化类型;也可以是clr特有的异常(不利于互操作)云因如果客户端是java,和。net定义异常不一样,容易出现错误;T:为数据契约,更好的互操作;

在契约接口的每个声明操作上添加标签;将错误信息对象化;//---案例:

throw new FaultException<InvalidOperationException>(new InvalidOperationException(""), "", FaultCode.CreateSenderFaultCode(null));

public interface IReturnuser

{

[OperationContract(IsOneWay = true)]

[FaultContract(typeof(CusError))]

void Return

}

(3) MessageFaults

MessageFault mfault = MessageFault.CreateFault(FaultCode.CreateSenderFaultCode(null), new FaultReason("错误"), new InvalidOperationException("an error occurred"), null, "", "");

FaultException fe = FaultException.CreateFault(mfault,typeof(InvalidOperationException));

throw fe;