-----------版本控制策略;必须支持向后兼容;----就是当服务端发生改变,但客户端未更新会不会发生错误;
一旦契约发布,若要契约发生变化,如何不影响客户端使用;
----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;