.NET设计规范(六) 异常

第6章 异常

设计异常的唯一目的是报告错误。

6.1. 抛出异常

û 不要返回错误码。

ü 要通过抛出异常的方式来报告操作失败。

ü 考虑通过调用System.Environment.FailFast来终止进程,而不是抛出异常,如果代码遇到了严重问题,已经无法继续安全的执行。

û 如果能够避免的话,不要在正常的控制流中使用异常,。

double a = 98,b = 0;

double result = 0;

try

{

result = SafeDivision(a,b);

Console.WriteLine("{0} divided by {1} = {2}",a,b,result);

}

catch (DivideByZeroException e)

{

//bad

result = SafeDivision(a,2);

Console.WriteLine("Attempted divide by zero.");

}

Console.ReadKey();

ü 考虑抛出异常可能会对性能造成的影响。

ü 要为所有的异常撰写文档,并把它们作为协定的一部分,前提是这些异常是由于违反了公有成员的协定而抛出的。

û 不要让公有成员根据某个选项来决定是否抛出异常。

static double SafeDivision(double x,double y,bool throwOnError)

{

//bad

if (y ==0)

{

if (throwOnError)

throw new System.DivideByZeroException("Attempted divide by zero.");

}

return x / y;

}

û 不要把异常用作公有成员的返回值或输出参数。

//bad

public Exception DoSomething() { }

ü 考虑使用辅助方法来创建异常。

static double SafeDivision(double x,double y)

{

if (y == 0)

ThrowNewDivideByZeroException();

return x / y;

}

static void ThrowNewDivideByZeroException()

{

string description = "Attempted divide by zero.";

throw new System.DivideByZeroException(description);

}

û 避免显示的从finally代码块中抛出异常。

finally

{

if (y == 0)

throw new System.DivideByZeroException();

Console.ReadLine();

}

6.2. 为抛出的异常选择合适的类型

ü 考虑优先使用System名字空间中已有的异常,而不是自己创建新的异常类型。

ü 如果对错误的处理方式或其他已有的异常有所不同,要使用自定义的异常类型。否则的话,应该使用已有的异常。

û 不要仅仅为了拥有自己的异常而创建并使用新的异常,要使用最合理,最有针对的异常。

try

{

object ObjPerson = null;

if (ObjPerson == null)

throw new ArgumentNullException();//good

throw new ArgumentException();//bad

Console.WriteLine(ObjPerson.ToString());

}

catch (ArgumentNullException e)

{

……….

}

6.2.1. 错误消息的设计

ü 要在抛出异常时为开发人员提供丰富而有意义的错误消息。

ü 要确保异常消息的语法正确无误。

ü 要确保异常消息中的每个句子都有句话。

û 避免在异常消息中使用问号和惊叹号。

û 不要在没有得到许可的情况下在异常消息中泄漏安全消息。

ü 考虑把组件抛出的异常消息本地化,如果希望组件为不同语言的开发人员所使用。

try

{

if (y == 0)

throw new System.DivideByZeroException("Attempted divide by zero.");

}

6.2.2. 异常处理

û 不要在框架的代码中,在捕获具体类型不确定的异常时,把错误吞了。

û 不要在转移异常而编写的catch代码块中把任何特殊的异常排除在外。

ü 考虑捕获特定类型的异常,如果理解该异常在具体环境中产生的原因,并能对错误做出适当的反应。

û 不要捕获不应该捕获的异常。通常应该允许异常沿着调用栈向上传递。

ü 要在进行清理工作时使用try-finally,避免使用try-catchcatch代码块是来从错误中恢复。Finally代码是来清理的。

ü 要在捕获并重新抛出异常是使用空的throw语句。

try

{

stream = new FileStream(......);

}

finally

{

if(stream != null) stream.Close();

}

û 不要用无参数的catch块来处理不符号CLS规范的异常。

6.2.3. 对异常进行封装

ü 考虑对较低层次抛出的异常进行适当的封装。

û 避免捕获并封装具体类型不确定的异常。

ü 要在对异常进行封装时为其指定内部异常。

6.3. 标准异常类型的使用

6.3.1. ExceptionSystemException

û 不要抛出System.ExceptonSystem.SystemException异常。

û 不要在框架代码中捕获System.ExceptonSystem.SystemException异常,除非打算重新抛出。

û 避免捕获System.ExceptionSystem.SystemExcepton异常,除非是在顶层的异常处理器中。

catch(Exception e)

{

Console.Write(……);

throw;

}

6.3.2. ApplicationException

û 不要抛出System.ApplicationException或从它派生新类。

6.3.3. InvalidOperationException

ü 要抛出InvalidOperationException异常,如果对象处于不正确的状态。

6.3.4. ArgumentExceptionArgumentNullExceptionArgumentOutOfRangeException

ü 要抛出ArgumentException异常或其子类,如果传入的是无效参数。

ü 要在抛出ArgumentException异常或其子类时设置ParamName属性。

ü 要在属性的设置方法中,以value作为隐式值参数的名字。

public string Name

{

set

{

if(value == null){

throw new ArgumentNullException("value",…);

}

}

}

6.3.5. NullReferenceExceptionIndexOutOfRangeExceptionAccessViolationException

û 不要让公用API显示的或隐式的抛出NullReferenceExceptionAccessViolatonExceptionIndexOutOfRangeException异常。

6.3.6. StackOverFlowExcetion

û 不要显示的抛出StackOverflowException异常。应该只有CLR才能显式的抛出该异常。

û 不要捕获StackOverflowException异常。

6.3.7. OutOfMemoryException

û 不要显示的抛出OutOfMemoryException异常。应该只有CLR才能抛出该异常。

6.3.8. ComExceptionSEHException及其他CLR异常

û 不要显示的抛出InteropException,ComExceptionSEHException异常。应该只有CLR才能抛出这些异常。

û 不要显示的捕获SEHExcepton异常。

6.3.9. ExecutionEngineException

û 不要显示的抛出ExecutionEngineException异常。

6.4. 自定义异常的设计

û 避免太深的继承层次。

ü 要从System.Exception或其它常用的异常基类派生新的异常类。

ü 要在命名异常类时使用Exception后缀。

ü 要使异常可序列化。为了使异常能够跨应用程序域。

ü 要为所有的异常提供下面常用的构造函数。

public class SomeException:Exception,ISerializable

{

Public SomeException();

Public SomeException(string message);

Public SomeException(string message,Exception inner);

Protected SomeException(SerializationInfo info,StreamingContext context);

}

ü 要把与安全性有关的信息保存在私有的异常状态中。

ü 考虑为异常定义属性。

6.5. 异常与性能

û 不要因异常可能对性能造成的负面影响而使用错误码。

6.5.1. Tester–Doer模式

ü 考虑在方法中使用Tester-Doer模式来避免因异常而引起的性能问题。

ICollection<int> numbers= ...

if(!numbers.IsReadOnly)

{

numbers.Add(1);

}

用来对条件进行测试的成员称为tester,在前面的例子中就是IsReadOnly。用来执行实际的操作并可能会抛出异常的成员称为doer.在上例中就是Add方法。

6.5.2. Try-Parse模式

ü 考虑在方法中使用Try-Parse模式来避免因异常而引起的性能问题。

ü 要在实现Try-Parse模式时使用Try前缀,并用布尔类型作为方法的返回类型。

ü 要为每个使用Try-Parse模式的方法提供一个会抛出异常的对应成员。

public struct DateTime

{

public static DateTime Parse(string dateTime){……}

public static bool TryParse(string dateTime,out DateTime result){…..}

}

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


什么是设计模式一套被反复使用、多数人知晓的、经过分类编目的、代码 设计经验 的总结;使用设计模式是为了 可重用 代码、让代码 更容易 被他人理解、保证代码 可靠性;设计模式使代码编制  真正工程化;设计模式使软件工程的 基石脉络, 如同大厦的结构一样;并不直接用来完成代码的编写,而是 描述 在各种不同情况下,要怎么解决问题的一种方案;能使不稳定依赖于相对稳定、具体依赖于相对抽象,避免引
单一职责原则定义(Single Responsibility Principle,SRP)一个对象应该只包含 单一的职责,并且该职责被完整地封装在一个类中。Every  Object should have  a single responsibility, and that responsibility should be entirely encapsulated by t
动态代理和CGLib代理分不清吗,看看这篇文章,写的非常好,强烈推荐。原文截图*************************************************************************************************************************原文文本************
适配器模式将一个类的接口转换成客户期望的另一个接口,使得原本接口不兼容的类可以相互合作。
策略模式定义了一系列算法族,并封装在类中,它们之间可以互相替换,此模式让算法的变化独立于使用算法的客户。
设计模式讲的是如何编写可扩展、可维护、可读的高质量代码,它是针对软件开发中经常遇到的一些设计问题,总结出来的一套通用的解决方案。
模板方法模式在一个方法中定义一个算法的骨架,而将一些步骤延迟到子类中,使得子类可以在不改变算法结构的情况下,重新定义算法中的某些步骤。
迭代器模式提供了一种方法,用于遍历集合对象中的元素,而又不暴露其内部的细节。
外观模式又叫门面模式,它提供了一个统一的(高层)接口,用来访问子系统中的一群接口,使得子系统更容易使用。
单例模式(Singleton Design Pattern)保证一个类只能有一个实例,并提供一个全局访问点。
组合模式可以将对象组合成树形结构来表示“整体-部分”的层次结构,使得客户可以用一致的方式处理个别对象和对象组合。
装饰者模式能够更灵活的,动态的给对象添加其它功能,而不需要修改任何现有的底层代码。
观察者模式(Observer Design Pattern)定义了对象之间的一对多依赖,当对象状态改变的时候,所有依赖者都会自动收到通知。
代理模式为对象提供一个代理,来控制对该对象的访问。代理模式在不改变原始类代码的情况下,通过引入代理类来给原始类附加功能。
工厂模式(Factory Design Pattern)可细分为三种,分别是简单工厂,工厂方法和抽象工厂,它们都是为了更好的创建对象。
状态模式允许对象在内部状态改变时,改变它的行为,对象看起来好像改变了它的类。
命令模式将请求封装为对象,能够支持请求的排队执行、记录日志、撤销等功能。
备忘录模式(Memento Pattern)保存一个对象的某个状态,以便在适当的时候恢复对象。备忘录模式属于行为型模式。 基本介绍 **意图:**在不破坏封装性的前提下,捕获一个对象的内部状态,并在该
顾名思义,责任链模式(Chain of Responsibility Pattern)为请求创建了一个接收者对象的链。这种模式给予请求的类型,对请求的发送者和接收者进行解耦。这种类型的设计模式属于行为
享元模式(Flyweight Pattern)(轻量级)(共享元素)主要用于减少创建对象的数量,以减少内存占用和提高性能。这种类型的设计模式属于结构型模式,它提供了减少对象数量从而改善应用所需的对象结