.NET设计规范————类型设计规范

类型设计规范

从CLR的角度看,只有值类型和引用类型两种类型,但是从框架设计的角度我们把类型从逻辑上分了更多的组。如下所示:

类是引用类型的一般情况,占了框架中的大多情况,类的流行归于它支持面向对象的特征,以及它的普遍的适用性,基类和抽象类是两个特殊的逻辑分组,它们与扩张性有关。

由于CLR不支持多继承,接口类型可以用来模拟多继承,既能被引用类型实现,也能被值类型实现。

结构是值类型的一般情况,应该用于小而简单的类型,就像编程语言的基本类型一样。

枚举是值类型的一个特例,它用来定义一小组值。

静态类是那些用来容纳静态成员的类型,常用来提供对其他操作的快速访问。

委托、异常、Attribute、数据、集合都是引用类型的特例,各有各自的用途。

1.1     类型和名字空间

在设计大型框架之前,应该决定如何将功能划分到一组功能域中,这些功能域由名字空间表示,为了确保一组有条理的名字空间包含的类型能很好的集成,不发生冲突,以及不会重复,自顶向下的设计很有必要。导致了下面的规范:

要用名字空间把类型组织成一个相关的特性域的层次结构。(主要是为了把类型组织成一个有条理、易于浏览的、易于理解的层次结构)

避免非常深的名字空间层次(难于浏览,需要经常回溯)

避免有太多的名字空间。

避免把为高级场景而设计的类型和常见的编程任务而设计的类型放在同一个名字空间中。(方便用户更容易理解框架的基本概念,容易在常见的场景中使用框架)

不要指定名字空间就定义类型。(把相关的类型组织到一个层次结构中,有助于解决可能存在的名字冲突)

标准子名字空间的命名

很少使用的类型应该放在子名字空间中,以免扰乱主名字空间,我们确定了几组类型,应该把它们从主名字空间中区分离出来。

1.       .Design子名字空间

仅用于设计时的类型应该放在名为.Design的子名字空间。如:System.Windows.Forms.Design;

System.Messaging.Design;

要用带“.Design”后缀的名字空间来容纳那些为基本名字空间提供设计时的功能的类型。

2.       .Permissions子名字空间

许可类型应该放在名为“.Permissions”子名字空间中。

要用带“.Permissions”后缀的名字空间来容纳那些基本名字空间提供自定义许可的类型。

3.       .Interop子命名空间

许多框架需要支持与旧系统的互操作性(interoperability)。

要用带“.Interop”后缀的名字空间来容纳那些为基本名字空间提供相互操作功能的类型。

要用带“.Interop”后缀的名字空间来容纳所有位于PIA中的代码。

1.2     类和结构之间的选择

引用类型在堆上分配,由垃圾收集器管理;而值类型要么在栈上分配并在栈展开时释放,要么内联在容纳它的类型中并在容纳它的类型被释放时释放。因此,与引用类型的分配与释放相比,值类型的分配与释放开销更低。

引用类型的数组不是非内联分配的,意为数组元素只是一些引用,指向那些位于堆中的引用类型的实例。而值类型的分配是内联的,数组的元素就是值类型的真正实例。因此值类型的分配和释放的开销要比引用类型的大的多,在大多情况下,值类型数组具有更好的局部性。

值类型在被强制转换为对象或装箱因为装箱和对象是在堆上分配的,且由垃圾收集器管理,所以太多的装拆箱操作会对堆、垃圾收集器,并对系统性能造成影响。

引用类型的赋值是复制引用,而值类型的赋值复制整个值,对大的引用类型复制开销要比值类型小的多。

引用类型是引用传递,值类型是值传递。改变引用类型的一个实例会影响其他的实例,改变值类型的实例,不会影响到它的副本。

框架中的大多数类型应该是类,但是在某些特殊情况下,由于值类型所具有的特征,使用结构更合适。

考虑定义结构而不是类(如果该类型的实例比较小,生命周期比较短,经常被内嵌在其他对象中

不要定义结构,除非该类型具有以下特征:

它在逻辑上代表一个独立的值,与基本类型相似(int)

它的实例大小小于16字节

它是不可变的

它不需要被经常装箱

在所有的其他情况下,应该将类型定义为类。

1.3     类和接口之间的选择

一般来说,类是用来暴漏抽象的优先选择。

点在于当需要允许API不断演化时,它的灵活性不如类,一旦你发布了一个接口,它的成员就永远固定了,给接口添加任何东西都会破坏已经实现该接口的已有类型。

类提供了更多的灵活性,你可以给一个已发布的类添加成员。只要添加的方法不是抽象的,任何已有的派生类无需改变仍能继续使用。

要优先采用类而不是接口

与基于接口的API相比,基于类的API容易演化得多,因为可以给类型添加成员而不会破坏已有的代码。

要用抽象类而不是接口来解除协定与实现之间的耦合。

抽象类经过正确的设计,同样能够解除协定与实现之间的耦合,与接口能达到的程度不相上下。

要定义接口,如果需要提供一个多态的值类型层次结构的话。(值类型不能自其它类型继承,但是她们可以实现接口)

考虑通过定义接口来达到与多重继承相类似的效果。

1.4     抽象类的设计

不要在抽象类型中定义公有的或内部受保护的构造函数。

只有当用户需要创建一个类型的实例时,该类型的构造参数才是公有的,由于你无法创建一个抽象类的实例,因此如果抽象类型具有公有构造函数

要为抽象类定义受保护的构造函数或内部构造函数。

受保护的构造函数仅仅是允许子类型被创建时,基类能够做自己的初始化。

内部构造函数可以用来把该抽象类的具体实现限制在定义该抽象类的程序集中。

要为发布的抽象类提供至少一个继承自该类的具体类型。

有助于验证该抽象类的设计是否正确。

1.5     静态类的设计

静态类被定义为一个只包含静态成员的类。如果一个类被定义为静态,那么它就是密封的、抽象的,不能覆盖或者声明任何实例成员。

静态类是在纯面向对象设计和简单性之间的一个权衡,它们被广泛用来提供一下访问其他操作的快捷方式,或者不需要完整的面向对象封装器的时候提供一些功能。(System.Enviroment)

要尽量少用静态类

静态类仅被用作辅助类,来支持框架的面向对象的核心。

不要把静态类当做杂物箱。

每一个静态类都应该有其明确的目的。

不要在静态类中声明或覆盖实例成员。

 要把静态类定义为密封的、抽象的,并添加一个私有的实例构造函数。

1.6     接口的设计

虽然大多数情况下API用类或结构来构建最好,但是在有些情况下,接口更合适。

CLR 不支持多继承,但允许类型实现一个或多个接口,因此通常用接口来实现多继承。

在创建能够为多种类型(包括值类型)所支持的公共接口时。

要定义接口,如果你需要包括值类型在内的一组类型支持一些公共的API。

      考虑定义接口,如果需要让已经自其它类型继承的类型支持该接口提供的功能。

      避免使用记号接口(没有成员的接口)

      要为接口提供至少一个实现该接口的类型。

      要为你定义的每个接口提供至少一个使用该接口的API(一个以接口为参数的方法或是一个类型为该接口的属性)

      不要给已发行的接口再添加成员。

这样做会破坏该接口的实现,为了避免版本的问题,应该创建一个新的接口。

一般来说,在为托管代码设计可重用的程序库时,你应该选择类而不是接口。

1.7     结构的设计

通用目的的值类型通常称为struct(结构)。

不要为结构提供默认的构造函数。(C#不允许结构有默认的构造函数)

要确保所有的实例数据都为零,false,或null时,结构仍处于有效状态。(可以防止在创建一个结构时创建出无效的实例)

     要为值类型实现IEquatable<T>

值类型的Object.Equals方法会导致装箱,默认的实现并不高效,因为使用了反射,IEquatable<T>.Equals性能好的多,不会导致装箱。

不要显示的扩展System.ValueType

1.8     枚举的设计

枚举是一种特殊的值类型,有两种类型的枚举:简单枚举和标记枚举。

简单枚举代表小型的、闭合的一组选择。例如(一组颜色):

Public enumColor{

Red,

Green,

Blue,

……

}

标记枚举的设计是为了支持对枚举值进行按位操作。标记枚举的常见例子是一个选择列表

[Flags]

Public enumAttributeTargets

{

Assembly=0x0001,

Module=0x0002,

Cass=0x0004,

Struct=0x0008

}

要用枚举来加强那些表示值的集合的参数、属性以及返回值的类型性。

要优先使用枚举而不要使用静态常量。(枚举是一个包含一组静态常量的结构)

不要把枚举用于开发的集合(比如操作系统版本等)

不要提供为了今后使用而保留的枚举值。

避免显示的暴漏只有一个值的枚举。

不要把sentinel值包含在枚举值中。

要为简单枚举类型提供零值。(应该考虑把该值称为None之类的东西,如果这样的值不适合用于某个特定的枚举,那么应该把该枚举中最常用的默认值赋值为0)

考虑用Int32作为枚举的基本实现类型。

要用复数名词或者名词短语来命名标记枚举,用单数名词或者名词短语来命名简单枚举。

不要直接扩充System.Enum

1.8.1  标记枚举的设计

要对标记枚举使用System.FlagsAttribute,不要把该attribute用于简单枚举。

[Flags]

Public enumAttributeTargets

{

…..

}

要用2 的幂次方作为标记枚举的值,这样就可以通过按位或操作自由组合他们。

[Flags]

Public enumWatcherChangeTypes

{

Created=0x0002,

Deleted=0x0004,

Changed=0x0008,

Renamed=0x00010,

}

考虑为常用的标记组合提供特殊的枚举值。(位操作是一个高级概念,对应简单任务来说不是必须的,FileAccess.ReadWrite就是这样一个例子)

[Flags]

Public enumFileAccess

{

Read=1,

Write=2,

ReadWrite=Read|Write,

}

避免让创建的标记枚举包含某些无效的组合。

避免把零用作标记枚举的值,除非该值表示“所有标记都被清除“,而且按下一条规范进行了适当的命名。(CLR规定任何值类型的默认值“所有的位都清零“)

要把标记枚举的零值命名为None,对其标枚举来说,该值必须始终意味着“所有标记均被清除”。

[Flags]

Public enumBorderStyle

{

Fixed3D=0x1,

FixedSingle=0x2,

None=0x0

}

但是,该规则只适用于标记枚举,对于非标记枚举的情况,避免使用0值实际上是不利的,所有的枚举类型一开始都为零值。

1.8.2  给枚举添加值

常会发现在发现之后需要给一个枚举添加值,如果新添加的值是一个已有API的返回值,那么就存在潜在的应用程序兼容性问题。

考虑给枚举添加值,尽管有那么一点兼容性的风险。

如果有实际数据,表明给枚举添加值会导致应用程序的不兼容,可以考虑添加一个新的API来返回新老枚举值,这样就能确保仍然兼容现有的应用程序。

1.9     嵌套类型

嵌套类型是一个定义在另一个类型的作用域内的类型。另一个类型被称为外层类型。嵌套类型能够访问外层类型的所有成员。可以访问定义在外层类型的私有字段以及定义在外层类型的所有父类的受保护字段。

一般来说,尽量少用嵌套类型,嵌套类型与外层类型紧密耦合,不适合将它们作为通用类型。嵌套类型适合用来对它们的外层类型的实现细节建模。

要想让一个类型能够访问外层类型的成员时才使用嵌套类型。

      不要用嵌套类型进行逻辑分组,应该用名字空间来达到此目的。

      避免公开的暴漏嵌套类型,唯一的例外是如果只需要在极少数的场景中声明嵌套类型的变量,比如派生子类,或者其他高级自定义场景中。

      不要使用嵌套类型,如果该类型可能会被除了它的外层类型之外的类型引用。

      不要使用嵌套类型,如果它们需要被客户代码实例化。

      不要把嵌套类型定义为接口的成员。

一般来说尽量少用嵌套类型,而且应该避免将嵌套类型公开暴漏给外界。

时间: 2024-10-11 09:59:06

.NET设计规范————类型设计规范的相关文章

类型设计规范

.NET设计规范————类型设计规范 类型设计规范 从CLR的角度看,只有值类型和引用类型两种类型,但是从框架设计的角度我们把类型从逻辑上分了更多的组.如下所示: 类是引用类型的一般情况,占了框架中的大多情况,类的流行归于它支持面向对象的特征,以及它的普遍的适用性,基类和抽象类是两个特殊的逻辑分组,它们与扩张性有关. 由于CLR不支持多继承,接口类型可以用来模拟多继承,既能被引用类型实现,也能被值类型实现. 结构是值类型的一般情况,应该用于小而简单的类型,就像编程语言的基本类型一样. 枚举是值类

《.NET 设计规范》第 4 章:类型设计规范

第 4 章:类型设计规范 4.1 类型和命名空间 要用命名空间把类型组织成一个由相关的功能区所构成的层次结构中. 避免非常深的命名空间层次.因为用户需要经常回找,所以这样的层次浏览起来很困难. 避免有太多的命名空间. 避免把为高级方案而设计的类型和为常见编程任务而设计的类型放在同一个命名空间中. 不要不指定类型的命名空间就定义类型. 要把那些为基本命名空间提供设计时功能的类型放在带“.Design”后缀的命名空间中. 要把那些为基本命名空间提供自定义权限的类型放在带“.Permissions”后

红绿灯与设计规范

过马路的时候突然注意到红绿灯,恰好最近的新交通规则也热火朝天,就顺势吐槽下关于"设计规范"的思考. 提到设计规范,很多人都觉得是个很虚.不务实的绩效工程,很多企业为设计规范而设计规范,拍脑袋定规则,投了精力进去,面子起来了,最后死掉了.以前也很不情愿去制定设计规范,经历多个终端的设计痛苦后,渐渐明白了设计规范"存在即合理"的意义.可以500%提高开发效率的前端UI框架! 红绿灯的启示 扯淡之前,还是先回到红绿灯这个事儿上: 这是再常见不过的红绿灯.当工业化城市化达到

NET设计规范二:类型成员设计

http://www.cnblogs.com/yangcaogui/archive/2012/04/20/2459567.html 接着 → .NET设计规范一:设计规范基础 上一篇,我们来了解下类型成员命名的设计! 3.类型成员命名的设计 3.1字段 ①遵循“ camelCasing  ”的命名规则 ②要用名词或名词词组,不要使用C#关键字 ③不要给字段添加任何前缀 ④定义常量的时候要使用“PascalCasing ”的命名规范 ⑤当定义私有变量的时候使用“camelCasing”命名,并且在

持续集成方案

大纲 构建 版本控制 部署 单元测试 架构文档化 命名约定 数据库伸缩性 自动化 反馈 实践 引言: 持续集成的前身: 在使用持续集成之前,很多开发团队都是用每日构建(nightly build).当时,微软使用这个实践很多年了.谁破坏了构建,就要负责监视后续的构建构成,直至发现下一个破坏了构建的人. 为什么要使用持续集成? 对于大多数项目来说,采纳持续集成实践是向高效率和高质量迈进的一大步.它保证那些创建大型复杂系统的团队具有高度的自信心和控制力.一旦代码提交引入了问题,持续集成就能为我们提供

Phenix.NET for WebAPI &amp; WF &amp; CSLA,企业级、分布式、符合领域建模的OOP软件快速开发平台

2016-8-28版本: Phenix6(for WebAPI & WF & CSLA)开发平台        : http://download.csdn.net/detail/phenixiii/9615312 CSLA & Delphi 爱好者 & Phenix for .net 开发平台用户交流群:206648373 以下是版本升级告示: 在IDE中设计业务类的映射关系演示: 2011-10-9升级: BusinessBase取子业务对象集合时,可以从本地的业务对象

[转载]C#编程规范

C#编程规范 2011-06-24 13:44:55|  分类: 雪球|举报|字号 订阅 1. 简介 本规范为一套编写高效可靠的 C# 代码的标准.约定和指南.它以安全可靠的软件工程原则为基础,使代码易于理解.维护和增强,提高生产效率.同时,将带来更大的一致性,使软件开发团队的效率明显提高. 2. 适用范围 本规范适用于公司所有的C#源代码,为详细设计,代码编写和代码审核提供参考和依据. 3. 文体 本规范中的建议分为四种:要,建议,避免,不要,表示需要遵循的级别.文档中会以粗体表示.对于应遵循

《构建之法(第三版)》第四章

4.1 代码规范 代码规范可以分为两个部分: 代码风格规范:主要是文字上的规定 代码设计规范:牵扯到程序设计,模块之间的关系,设计模式等方方面面的通用原则. 4.2 代码风格规范 代码风格的原则是简明,易读,无二义性 Tab键在不同的情况下会显示不同的长度,严重干扰阅读体验.4个空格的距离可读性最好 行宽必须限制,可以限定为100字符 在复杂的条件表达式中,用括号清楚地表示逻辑优先级 每个"{"和"}"都独占一行 if (condition) { DoSomethi

2018--20179215--《构建之法(第三版)》第四章 两人合作

构建之法 第四章 读书笔记 4.1代码规范 代码规范可以分为两部分: 代码风格规范-主要是文字上的规定 代码设计规范-牵涉到程序设计.模块之间的关系.设计模式等方方面面的通用原则 4.2代码风格规范 代码风格的原则是:简明,易读,无二义性. 缩进:4个空格的距离阅读性最好. 行宽:可限制为100个字符. 分行:不要把多条语句放在一行,每个"{"和"}"单独占一行,不要把多个变量放在同一行. 命名:不要提到类型或其他语法方面的描述:避免过多的描述:避免可要可不要的修饰