wcf契约版本处理与异常处理（随记）

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

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

----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;