zoukankan      html  css  js  c++  java
  • .NET设计规范三:类型和类型成员设计的约定和惯用法

      继续上两篇未完成的工作 → ①.NET设计规范一:设计规范基础 ②.NET设计规范二:类型成员设计

      上两篇主要是说了类型和类型成员在命名上的规范,对它们的具体设计还没有涉及到,这篇文章是从一个普通开发人员的角度理解,会有很多不足之处,希望能得到大家的指点!

      首先说一下本文只是借助书本做的一些小结,大牛(架构师)们请不要喷我,如果实在憋不住,那就是使劲的喷吧,在喷中成长!

      4.类型设计的约定和惯用法

        4.1类和接口的选择

          ①应该优先使用类

          首先类是用于暴露抽象的优先选择!

          微软开发人员提供给我们的方案是:定义一个接口,然后再定义一个抽象基类实现这个接口!

     1     public interface IComponent  //这是.NET Framework中比较突出的案例
     2     {
     3         void GetID();
     4     }
     5 
     6     public class Component:IComponent
     7     {
     8         public void GetID()
     9         {
    10             // To Do.
    11         }
    12     }

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

          ③如果需要定义一个多态的值类型层次结构的话,要定义一个接口

    1     public struct Int32 : IComparable, IFormattable, IConvertible
    2     {
    3         
    4     }
    5     public struct Int64 : IComparable, IFormattable, IConvertible
    6     {
    7 
    8     }

          ④考虑使用接口来实现多重继承

            Note:定义一个接口的标志就是它只做一件事。  

        4.2抽象类的设计  

          优点:

          ①灵活性比较大

          ②能通过继承扩展功能

          ③可以对抽象类中的虚方法和抽象方法实现重写达到功能扩展

          设计:

          ①抽象类中的构造函数修饰符因为为“protected”或者为“interal”,不过大多数情况都是“protected”

          ②定义好的抽象类必须要有类去继承它,而不能让它成为孤家寡人,这样有助于验证抽象类的有效性

    1     public abstract class Animal
    2     {
    3         protected Animal()
    4         {
    5         }
    6     }

         4.3接口的设计

          ①接口可以支持多重继承

          ②避免使用记号接口(也就是无成员的接口)

          ③要为接口提供实现的类型,跟上面抽象类一样,不要成为孤家寡人

          ④在大型项目开发中,都会提供一系列的接口供外部调用(这也是设计接口的场景之一)

          ⑤接口一旦定义就不能做改动了

        4.4静态类的设计

          ①尽量少自定义静态类,如果设计的静态类有一种辅助的效果,那么就应该定义一个这样的静态类,如.NET Framework中的“File”类,一种文辅助类

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

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

        4.5结构的设计

          ①不要为结构提供默认的构造函数

          ②一般来说自定义的结构类比较少

        4.6枚举的设计

          ①要用枚举来加强那些表示值的集合的参数,属性或者返回值的类型型

          ②要优先使用枚举而不要使用静态变量

            比如:在定义一些颜色属性的时候,使用枚举是最好的选择。

          ③不要提供为了今后使用的枚举值

          ④不要定义枚举中只有一个值,如果只有一个那还不如定一个常量呢!

          ⑤要为简单的枚举提供“0”值,详细理解“0”值请看 → 从枚举的初始化说起 [C#]

    1     public enum Color
    2     {
    3         Red = 0,  //这是一种规范
    4         Yellow = 1,
    5         Black = 2
    6

          ⑥考虑用“Int32”类型数值作为枚举值的值

          ⑦要使用复数名词或名词词组命名“标记枚举”,用单数名词或名词词组命名简单枚举

        4.7标记枚举

          标记枚举提供对枚举值的位操作!

          ①必须要加上“[Flags]”标志特性

          ②要用2的幂次方作为标记枚举的值(其实这个规则不怎么明白,不过这确实是一个很重要的规范)

    1     [Flags]
    2     public enum MyEnumTypes
    3     {
    4         Created = 0x0002,
    5         Updated = 0x0004,
    6         Deleted = 0x0008
    7     }

           ③在合适的情况下要为标记枚举提供特殊的枚举值,也就是组合枚举

    1     [Flags]
    2     public enum FileAccess
    3     {
    4         Read = 1,      //这边定义的“int”型的枚举值跟上面使用2的幂次方作为枚举值没有冲突,我们应该在以后的开发中使用2的幂次方作为枚举值
    5         ReadWrite = 3,  //提供一个组合值,或者这样 →  ReadWrite = Read | Write
    6         Write = 2
    7     }

           ④不要定义无效的枚举值

     

      5.成员设计

        5.1方法的重载

          ①避免在重载的时候随意给参数名,应该保持参数名的一致性

          

          ②避免打乱参数的顺序,在多个重载中保持参数顺序的一致性

          ③要把最长的重载做成“虚方法”,这样有助于派生类的重写,增强了扩展性

          ④不要在重载成员中使用“ref”或“out”参数

    View Code
     1     public class My
     2     {
     3         public void MyOne(string name)
     4         {
     5             MyOne(name, 0);
     6         }
     7 
     8         public void MyOne(string name, int age)
     9         {
    10             MyOne(name, age, "");
    11         }
    12 
    13         public virtual void MyOne(string name, int age, string address)
    14         {
    15 
    16         }
    17     }

          ⑤要允许引用类型的参数可为“null”,不过需要在方法中对“null”值进行判断

        5.2显式和隐式实现接口

          ①避免显式实现接口

            感觉这个规范在“迭代器”中的运用还是比较多的,可以参照这篇文章:程序猿个人文章目录索引中的迭代器系列

            说实话这个话题我也不敢讲多少,因为我自己对它本质的东西理解的好不够深入,所以就泛泛的说几句!

        5.3属性和方法的选择

          ①属性侧重于数据的体现,而方法侧重于操作,不过话说两者的性能不是很多(虽然书上也讨论过两者性能差异,但是可以忽略不急)

          ②建议多使用属性,如果定义够多的属性,那么相应的就要为属性定义同等的私有变量,也就是对变量的封装

          ③避免方法中参数过多,如果太多建议使用属性来减少方法重载

          ④需要使用方法的一些通用情况

            I,该操作是一个转化操作,如:ToString()方法

            II,该操作每次返回的结果不一样,如:Guid.NewGuid()

            III,该操作返回的是一个数组或集合(这个情况还是蛮实用的)

          ⑤所以说使用属性是它只代表简单的数据操作,过于复杂的操作应该使用方法来完成 

        5.4索引器的设计

          个人理解:索引器就是对集合以及数组的封装!

          索引器可以是单个索引也可以是多个索引,索引器是附加在类级别上的,所以它才使用“this”关键字的,在前面一文中也简单的介绍了这方面的知识!

          ①避免使用一个以上参数的索引器

        5.5构造函数设计

          有两种构造函数:类型构造函数和实例构造函数

          类型构造 → 也就是静态构造函数,必须为静态的,在进行初始化的时候是第一个执行的!

          ①必须为私有构造(编译器会强制规定的)

          ②不要在类型构造中抛出异常

          实例构造 → 也就是普通的构造

          ①考虑提供简单的构造函数,可以默认构造函数

          ②如果使用构造函数重载,那么构造函数的参数作用应该设置为主要属性,而不是“可有可无”的参数

          ③要在构造函数做最少的事

          ④如果要使用构造函数重载,需要提供一个空构造,这样就不会破坏依赖于空构造的类型成员

        5.6事件的设计

          关于事件定义的基本规范可以参考前一篇的文章!

          ①要使用系统自定义的委托 →  EventHandler<T> (可以说这是个通用规范把)

          ②考虑把事件的处理方法设置为虚方法,这样派生类就可以重写,提高扩展性

          如果想深入理解推荐几篇文章:C#委托和事件(2) ,浅谈C#中常见的委托C# 中的委托和事件

        5.7字段的设计

          ①不要提高公共的或受保护的实例字段

          ②要使用属性来访问字段,这样跟直接访问字段是一样的

          ③要用常量字段来表示永远不会改变的常量,大家可以找点资料理解下“const”和“readonly”的差异

          ④不要把可变类型的实例赋值给只读字段

          ⑤要用公有的静态只读字段来定义预定义的对象实例(这个个人理解起来有点不懂)

          

     

      好了就写这么多了,感觉好累,因为本人不是啥架构师,是个小菜鸟(这是从我这个角度看问题的,高度还没有上升上去),写这些东西也是模仿书上的,算是一点小总结,不能算经验的!

      如有问题还请大家多多指教!

      下一篇:.NET设计规范四:简单的扩展设计与个人思考

  • 相关阅读:
    call me
    互相关注请留言!我也会及时关注你的哦!
    tomcat单机多实例
    powerdesigner导出rtf
    IDEA快捷键
    SQLyog Enterprise Trial 试用期问题
    ubuntu 16.04 忘记root密码
    使用Xshell连接ubuntu
    观察者模式(Observer)和发布(Publish/订阅模式(Subscribe)的区别
    jvm方法栈
  • 原文地址:https://www.cnblogs.com/yangcaogui/p/2461490.html
Copyright © 2011-2022 走看看