框架必须以易于使用的方式来为普通用户提供一个低门栏。
每个人在第一次接触一个新框架时,都希望其是简单而功能强大的。如果他一开始就感觉其很复杂,则会望而却步。
- 要确保每个特性域的名字空间只包含哪些用于最常见场景的类型。应该把用于更高级的场景的类型放在子名字空间中。
例如:System.Net命名空间提供了有关网络的主要API,而更高级的socket API则位于System.Net.Socket子命名空间。 - 要为构造函数和方法提供简单的重载函数。参数少,且都是基本类型。
- 不要在为主要的使用场景而设计类型中包含用于高级场景(这里我个人感觉是不常用的意思)的方法。
通过从框架中减少(或至少不增加)特性,能够使开发人员更有效率。因为需要处理的概念减少了。CLR把多重继承排除在外就是这个原因。 - 不要要求用户在最基本的场景中显示地实例化一个以上的类型。
- 不要要求用户在为基本使用场景编写代码之前就进行大量的初始化。
如果一些初始化是必需的,那么当用户未执行初始化而引起异常时,应该在异常消息中清楚的告诉用户需要做些什么。 - 要尽可能地(用便利的重载函数)为所有的属性和参数提供合适的默认值。
当然不要盲目采用,如果默认值会引起错误,自然不可取。 - 要通过异常来传达API的误用。
显示错误的原因、如何修正等信息。
没有评论:
发表评论