WCF服务编程设计规范(2):序言、通用设计规范和要点。主要翻译整理,序言、WCF设计通用设计规范、设计要点。并给出注释。注释内容于括号内。下一部分会整理,服务契约、数据契约、实例管理的内容。这里放出的是中英文对照版。方便大家学习。最后翻译结束,我会整理一个纯中文版放出。如有错误,请批评指正。欢迎留言交流。
序言
对于一次成功的产品交付来说,完整编码规范至关重要。这个规范可以帮助强化一些通用的最佳实践准则,并避免犯错,方便整个团队理解这些知识。通常,编码规范都是相当的繁琐,动辄上百页,内容详细叙述每个编码规则的基本原理。虽然这比没有规范要好的多,但是通常开发人员难以理解和掌握。相反,《WCF编码规范》只有10多页,并且详细介绍“是什么”和“为什么”。我相信要完全理解每个编码规则的精髓并恰当地应用这些规则,需要阅读大量的书籍和多年的工作经验。当有新人进入团队时,你可以快速地告诉他或她应该“先看看这个规范”。因为,完全理解这些规范需要时间和今年感言,在此之前,我们就应该遵守它。这里涵盖了一些常用的规则、缺陷、指南和建议。这里会使用在《WCF Master Class》和《Programming WCF Services》(精通WCF课程和WCF服务编程)里介绍的最佳实践和Helper Class。
Juval Lowy
General Design Guidelines
通用设计规范
1.All services must adhere to these principles:
所有的服务必须遵守这些原则:
a)Services are secure.
服务是安全的。
b)Service operations leave the system in a consistent state.
服务操作保证系统在一直的状态。
c)Services are thread-safe and can be accessed by concurrent clients.
服务是线程安全的并且可以被并发的客户端访问。
d)Services are reliable.
服务是可靠的。
e)Services are robust.
服务是健壮的。
2.Services can optionally adhere to these principles:
这些原则不是必须的。
a)Services are interoperable.
服务是可互操作的
b)Services are scale-invariant.