ASP.NET企业开发框架IsLine FrameWork系列之十--ExceptionProcessProvider异常框架(下)
接上文
异常展示
系统异常模块除了记录功能,还有一个很重要的功能:异常展示,即系统发生异常后,展示给用户怎样的页面。展示给用户友好页面具有以下必要性:
●展示给用户友好页面,可以降低用户焦虑感,提高用户体验。
●将系统异常隐藏,避免代码、路径等技术信息外泄,提高系统安全性。
●将系统运行时异常统一管理,有助于提高软件整体质量,便于整体把控。
友好页面的展示类型也是根据配置节点信息完成的,管理员只需更改配置节点中的枚举值,即可改变用户体验页面,用户体验页面共有10中方式,分别是抛出原始异常信息、抛出定制异常信息、抛出简单信息(不包含异常)以及隐藏异常信息等方式。
在系统开发阶段,可以使用抛出原始异常信息的展现方式,系统部署后,可以使用抛出简单信息(不包含异常)或隐藏异常信息的方式,选择这些展示方式的同时,还可以选择是否记录到日志介质。
各种异常展示的配置信息大全,假如有一个页面代码如下:
try
{
string i = "i";
Response.Write(i);
}
catch (Exception ex)
{
ILException ile = new ILException();
ile.WriteLog(ex);
}
正常访问页面显示字符串“i”,假如代码修改如下,便会发生错误:
try
{
string i = "i";
Response.Write(Convert.ToInt32(i));
}
catch (Exception ex)
{
ILException ile = new ILException();
ile.WriteLog(ex);
}
根据以下不同配置信息,页面有不同的显示,这个显示方式根据web.config给出的键值决定:
<add key="IsLine.ExceptionProcess.Configuration.ProcessStyle" value="ThrowOriginalWithLog"/>
其中,value可以为以下枚举值:
- ThrowOriginalWithLog
这种方式的含义是抛出原始错误,终止应用程序,并将这种错误记录到异常日志中。
图1 原始错误
2.ThrowOriginalWithoutLog
这种方式的含义只是抛出原始错误,终止应用程序,并不记录这种错误,图示同上。
3.ThrowFriendlyWithLog
这种方式的含义是抛出友好的错误信息,终止应用程序,并记录异常。友好异常信息由自己定义。
图2 抛出友好信息
4.ThrowFriendlyWithoutLog
这种方式的含义是抛出友好的错误信息,终止应用程序,并不记录异常,图示同上。
需要注意的是,使用3、4两种配置,需要在web.config中添加额外的节点信息,这些信息决定了友好信息的显示字段与排版:
在<configSections></configSections>中添加以下信息
<sectionGroup name="IsLine.ExceptionProcess.Configuration">
<section name="ILExceptionModel" type="IsLine.Data.Configuration.SuitConfig" />
</sectionGroup>
在</configSections><appSettings>之间加入以下信息
<IsLine.ExceptionProcess.Configuration>
<ILExceptionModel>
<Message>->Message:@Message</Message>
<Level>->Level:@Level</Level>
<HelpLink>->Helper:@HelpLink</HelpLink>
<Source>->Source:@Source</Source>
<StackTrace>->Stack Trace:@StackTrace</StackTrace>
<TargetSite>->Trigger:@TargetSite</TargetSite>
<HResult>->Result Code:@HResult</HResult>
<EventDate>->Event Date:@EventDate</EventDate>
<OtherPlus>->Contact Method:</OtherPlus>
</ILExceptionModel>
</IsLine.ExceptionProcess.Configuration>
5.ThrowSimpleWithLog
这种方式的含义是抛出简单的预定义的错误信息,终止应用程序,并记录异常。
图3 抛出简单预定义信息
这些预定义信息由以下节点定义,value部分就是页面显示的信息:
<add key="IsLine.ExceptionProcess.ExceptionProcessProvider.FriendlySimpleText" value="The current page has an exception!"/>
6.ThrowSimpleWithoutLog
这种方式的含义是抛出简单的预定义的错误信息,终止应用程序,并不记录异常,图示同上。
7.ShowSimpleWithLog
这种方式的含义是显示简单的预定义的错误信息,不终止应用程序,并记录异常。
这种方式显示错误信息与5、6相同,但是5、6配置形式,如果程序中遇到错误则会触发“throw”,从而导致程序终止运行;而7、8怎会显示错误,程序继续运行。
8.ShowSimpleWithoutLog
这种方式的含义是显示简单的预定义的错误信息,不终止应用程序,并不记录异常。
9.HideWithLog
这种方式的含义是不显示任何错误信息,不终止应用程序,并将异常信息记录。
10. HideWithoutLog
这种方式的含义是不显示任何错误信息,不终止应用程序,并不记录异常信息。
注意,异常的记录是日志模块可以理解为继承的关系,日志模块的缓存等特性配置,在异常中仍有效。
至于,异常信息被写到什么地方,正如我们前面所说到的,它是由日志的Render决定的:
<add key="IsLine.ExceptionProcess.Configuration.RenderName" value="OracleUsingSPRender"/>
“OracleUsingSPRender”便是日志的Render名称, Render模型描述了异常记录位置、格式等信息,详细请见
IsLine FrameWork系列之八--ExceptionProcessProvider异常框架(上) 中的第三点。
超级异常日志
如果在异常记录的过程中,发生错误,这时异常信息不会记录成功,异常信息自动被忽略,如果管理员希望在日志模块出现错误时,ILFW仍然记录这些信息,管理员可以打开配置文件中“超级日志”的开关。
当此开关打开后,如果日志模块出现错误(例如数据库连接中断),ILFW会自动将当前信息记录至一个文本文件中,直到导致日志模块错误的因素消失。
在web.config中添加以下节点开启超级日志功能:
<add key="IsLine.ExceptionProcess.ExceptionProcessProvider.IsOpenDebugInfo" value="True" />
以下节点表示超级日志记录位置:
<add key="IsLine.ExceptionProcess.ExceptionProcessProvider.DebugInfo" value="C:\IsLineLog\FinallyLog.txt" />
注意,超级日志只能写入文本文件,并且使用超级日志需要确保相关账户对日志文件具有完全控制权限。
我是李鸣 欢迎您关注我的下一篇文章。
李鸣(aicken)原创 转载注明