Enterprise Library - Exception Handling Application Block - Part 1
本文演示Enterprise Library – Exception Handling Application Block 异常管理模块的使用,如何将异常日志记录添加到应用程序中,以及如何使用Replace Handler隐藏敏感信息。本文由http://blog.entlib.com 开源ASP.NET博客平台小组根据EntLib HOL手册编译提供,欢迎交流。
练习一:记录异常日志
1. 首先打开\Enterprise Library 4.1 HOL\CS\Exception Handling\exercises\ex01\begin 目录下的Puzzler.sln 项目文件。
该应用程序执行2个功能:检查单词的拼写;根据字符列表,使用字典生成单词列表。
运行应用程序,界面如下所示。在单词文本输入框,输入 ab123,然后点击 Add Word 按钮,将抛出一个未捕获异常。
下面实现如何使用Exception Handling Application Block,进行异常管理。
2. 选择PuzzlerUI 项目,添加如下dll 的引用。
Microsoft.Practices.EnterpriseLibrary.ExceptionHandling.dll
3. 打开Puzzler.cs 代码文件,添加对ExcepitonHandling 命名空间的引用。
using Microsoft.Practices.EnterpriseLibrary.ExceptionHandling;
找到btnAddWord_Click 方法,添加try/catch 代码块,如下所示:
private void btnAddWord_Click(object sender, System.EventArgs e)
{
try
{
// TODO: Handle exceptions
PuzzlerService.Dictionary.AddWord(txtWordToCheck.Text);
errorProvider1.SetError(txtWordToCheck, "");
}
catch (Exception ex)
{
bool rethrow = ExceptionPolicy.HandleException(ex, "UI Policy");
if (rethrow)
throw;
MessageBox.Show(string.Format(
"Failed to add word {0}, please contact support.",
txtWordToCheck.Text));
}
}
4. 为 PuzzlerUI 项目添加app.config配置文件,并使用EntLib附带的配置文件编辑器打开配置文件。然后,添加 Exception Handling Application Block 的配置,如下图所示。
接下来,添加新的Exception Policy,如下图所示。
设置Exception Policy的Name属性为 UI Policy,该Policy的名称需要和前面的代码中保持一致。
bool rethrow = ExceptionPolicy.HandleException(ex, "UI Policy");
选择UI Policy 节点,添加新的Exception Type,如下图所示。
在弹出的Type Selector对话框中,选择System.Exception类型,如下图所示。
这个filter设置哪一类的Exception由异常处理代码来负责处理,将处理所有继承自System.Exception 类型的异常。另外,设置System.Exception类型的PostHandlingAction属性为None,该属性值None表示所有的异常将 在异常处理代码内部处理,调用方(caller)不需要在catch代码块中重新抛出异常。
下面进一步选择Exception Handling Application Block | UI Policy | Exception 节点,并选择 New | Logging Handler 菜单项,如下图所示。这一步操作将自动添加Logging Application Block到配置文件中,你可以观察一下app.config 配置文件的变化。
选择 Exception Handling Application Block | UI Policy | Exception | Logging Handler 节点,设置如下属性:
FormatterType = TextExceptionFormatter
LogCategory = General
上述配置操作完成后,记得要保存配置文件。
5. 设置PuzzlerUI 项目添加对如下dll引用。
Microsoft.Practices.EnterpriseLibrary.ExceptionHandling.Logging.dll
因为Enterprise Library 的一个目标是保持Application Blocks之间相互低耦合,因此Exception Handling Application Block也可以不必使用Logging Application Block(例如,创建自己的异常管理Handler)。如果你使用两个application blocks,你需要引用上述的dll, Exception Handler来通过logging application block 来记录异常日志(默认安装情况下,该dll在如下目录C:\Program Files\Microsoft Enterprise Library 4.1 - October 2008\Bin)。
6. 再次运行应用程序
重复前面的步骤,在单词文本输入框,输入abc123,然后点击 Add Word 按钮,将弹出一个对话框 – Failed to add word abc123, please contact support。
检查windows的事件日志(Event Log),查看Application 日志,发现日志信息已经记录了。
为了在应用程序中给所有的代码添加try/catch,你可以考虑添加一个全局的Exception Handler。有2个events可以用来监听未捕获异常(unhandled exception):
(1)当执行Application.Run 方法的线程发生未捕获异常时,触发Application.ThreadException事件。
(2)如果handler抛出异常,或者不在UI线程中发生异常,将触发AppDomain.UnhandledException事件。
7. 更新代码
(1)删除之前btnAddWord_Click方法中添加的代码,如下所示:
private void btnAddWord_Click(object sender, System.EventArgs e)
{
PuzzlerService.Dictionary.AddWord(txtWordToCheck.Text);
errorProvider1.SetError(txtWordToCheck, "");
}
(2)打开Startup.cs代码文件,添加命名空间的引用。
using Microsoft.Practices.EnterpriseLibrary.ExceptionHandling;
同时,在Startup类中添加如下方法来处理异常。
public static void HandleException(Exception ex, string policy)
{
Boolean rethrow = false;
try
{
rethrow = ExceptionPolicy.HandleException(ex, policy);
}
catch (Exception innerEx)
{
string errorMsg = "An unexpected exception occured while " +
"calling HandleException with policy '" + policy + "'. ";
errorMsg += Environment.NewLine + innerEx.ToString();
MessageBox.Show(errorMsg, "Application Error",
MessageBoxButtons.OK, MessageBoxIcon.Stop);
throw ex;
}
if (rethrow)
{
// WARNING: This will truncate the stack of the exception
throw ex;
}
else
{
MessageBox.Show("An unhandled exception occurred and has " +
"been logged. Please contact support.");
}
}
上述方法使用Exception Handling Application Block,如果Exception Handling Application Block自身发生问题(如遗漏配置项),也将显示有效的信息。
继续添加如下的方法作为应用程序的ThreadException事件的event handler:
static void Application_ThreadException(object sender, ThreadExceptionEventArgs e)
{
HandleException(e.Exception, "UI Policy");
}
上述方法使用前面定义过的UI Policy。在随后的练习中,将定制这一Policy,允许忽略某些异常,并关闭应用程序。
下面继续添加AppDomain的UnhandledException 事件的Event Handler:
static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
if (e.ExceptionObject is System.Exception)
{
HandleException((System.Exception)e.ExceptionObject, "Unhandled Policy");
}
}
上述代码使用了一个新的policy(Unhandled Policy),下一节将创建。Unhandled Policy 总是仅记录异常,并不重抛异常。
最后,在Main方法中,通过如下代码连接event handler和事件:
static void Main()
{
Application.ThreadException += new ThreadExceptionEventHandler(Application_ThreadException);
AppDomain.CurrentDomain.UnhandledException += new UnhandledExceptionEventHandler(CurrentDomain_UnhandledException);
Puzzler f = new Puzzler();
Application.Run(f);
}
再次运行应用程序,重复前面的测试步骤,检查弹出的消息对话框和事件日志中的异常记录,确认完成了上述所有步骤,且应用程序工作和预期一致。
http://blog.entlib.com 开源ASP.NET博客平台小组,欢迎你继续方法下一节内容:Exception Handling application block – 异常管理策略。
参考文档:
Exception Handling Application Block Hands-On Labs for Enterprise Library