- 为用于最常用的场景的类型保留一个简单直观的名字
- 为标识符选择描述性名字,它们可以说明每个方法是做什么的,以及每个类型和参数是表示什么的。(不要担心看起来很冗长)
- 要通过异常消息来告诉开发人员对框架的无用
- 要尽可能地提供强类型API
- 要确保与.net框架保持一致性
- 限制抽象的数量
- 主要有两种方法可以为API层划分名字空间:
在单独的名字空间中暴露层
在相同的名字空间中暴露层 - 标识符的大小写规则
为了区分一个标识符中得多个单词,把标识符中的每个单词的首字母大写。
两种方法分别是:PascalCasing camelCasing - PascalCasing约定被用于除了参数名之外的所有标识符,它把标识符中每个单词的首字母(包括长度为两个字符以上的首字母缩写词)大写,例如
PropertyDescriptor
HtmlTag
两个字母长的首字母缩写词是一个特例,这种情况下两个字母都要大写,如
IOStream - camelCasing约定仅用于参数的名字,它把标识符中除了第一个单词之外的所有单词的首字母大写。如果两个字母长得首字母缩写词开始,那么两个字母都要小写:
propertyDescriptor
ioStream
htmlTag
转载于:https://www.cnblogs.com/stevezheng/archive/2011/11/21/2257135.html