WCF服务编程设计规范(3):服务契约、数据契约和实例管理设计规范
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
I
MyContract
{...}
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
.
避免在
ServiceBehavior
和
CallbackBehavior
属性里把
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
DataSet
s and
DataTable
s (or their type-safe
subclasses) from operations. Return a neutral representation such as an array.
不要接受或者返回
ADO.NET
DataSet
s
和
DataTable
s (
或它们的类型安全的子类
)
。返回一个中立的数据形式，比如数组。
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.
在持久化服务里，通常指定一个完成操作。