WCF服务编程设计规范(3):服务契约、数据契约和实例管理设计规范。本节涵盖服务契约和数据契约设计规范,以及服务实例管理内容。中英对照版本,欢迎留言交流。
Service Contracts
服务契约
1.       Always apply the ServiceContract attribute on an interface, not a class:
ServiceContract属性标记到契约接口上,而不是服务类上
  //Avoid:避免
  [ServiceContract]
  class MyService
  {
  [OperationContract]
  public void MyMethod()
  {...}
  }
  //Correct:正确
  [ServiceContract]
  interface IMyContract
  {
  [OperationContract]
  void MyMethod();
  }
  class MyService : IMyContract
  {
  public void MyMethod()
  {...}
  }
2.       Prefix the service contract name with an I:
服务契约名称以I开头
  [ServiceContract]
  interface IMyContract
  {...}
3.       Avoid property-like operations:
避免定义与属性类似的操作
  //Avoid:
  [ServiceContract]
  interface IMyContract
  {
  [OperationContract]
  string GetName();
  [OperationContract]
  void SetName(string name);
  }
4.       Avoid contracts with one member.
避免契约里只包含一个成员
5.       Strive to have three to five members per service contract.
每个契约里尽量保证3-5个成员
6.       Do not have more than 20 members per service contract. Twelve is probably the practical limit.
         每个服务契约里成员不要超过20个。12个也许久应该就是极限
Data Contracts
数据契约
1. Avoid inferred data contracts (POCO). Always be explicit and apply the DataContract attribute.
         避免使用推测性的数据契约。明确使用DataContract属性定义数据契约。
1.       Use the DataMember attribute only on properties or read-only public members.
只在属性或者只读的成员上使用DataMember属性
2.       Avoid explicit XML serialization on your own types.
避免自己的类型上明确使用XML序列化标记
3.       Avoid message contracts.
避免使用消息契约
5. When using the Order property, assign the same value to all members coming from the same level in the class hierarchy.
         当使用Order属性的时候,对于类层次相同的所有成员赋相同的值
6. Support IExtensibleDataObject on your data contracts. Use explicit interface implementation.
         数据契约支持IExtensibleDataObject。使用明确地实现接口。
7. Avoid setting IgnoreExtensionDataObject to true in the ServiceBehavior and CallbackBehavior attributes. Keep the default of false.
         避免在ServiceBehaviorCallbackBehavior属性里把IgnoreExtensionDataObject 设置为true。保持默认的false
8. Do not mark delegates and events as data members.
         不要使用委托和事件作为数据成员
9. Do not pass .NET-specific types, such as Type, as operation parameters.
         不要传递.NET-specific类型,比如Type,作为操作参数。
10. Do not accept or return ADO.NET DataSets and DataTables (or their type-safe subclasses) from operations. Return a neutral representation such as an array.
         不要接受或者返回ADO.NET DataSetsDataTables (或它们的类型安全的子类)。返回一个中立的数据形式,比如数组。
11. Suppress the generation of a generic type parameter hash code and provide a legible type name instead.
         不要产生泛型类型参数的哈希值,使用一个易懂的类型名称作为替代。
Instance Management
实例管理
1. Prefer the per-call instance mode when scalability is a concern.
         当考虑到可伸缩性的时候,使用Per_Call模式,单调模式。
2. If setting SessionMode.NotAllowed on the contract, always configure the service instancing mode as InstanceContextMode.PerCall.
         如果在契约上设置了SessionMode.NotAllowed,通常会把服务实例模式设置为InstanceContextMode.PerCall
3. Do not mix sessionful contracts and sessionless contracts in the same service.
         不要在一个服务里把会话契约和非会话契约混用。
4. Avoid a singleton unless you have a natural singleton.
         避免使用单例模式,除非理所当然地应该使用单例模式。
5. Use ordered delivery with a sessionful service.
         尽量在会话服务里使用顺序传递。
6. Avoid instance deactivation with a sessionful service.
         避免在会话服务里停止服务实例
7. Avoid demarcating operations.
         避免分布操作(比如有先后顺序的操作。)
8. With durable services, always designate a completing operation.
         在持久化服务里,通常指定一个完成操作。