异常管理接口说明

1、华为信息门户异常管理接口说明文档历史日期描述作者2004-06-11创建文档余健异常管理设计简介系统中应对外协或集成的第三方成品做异常封装。整个系统统一定义由exception中继承的异常PortalException,依据对组件异常封装和自定义应用异常封装的原则，派生出以下异常：Ø XmlException xml操作异常Ø DominoException Domino集成异常Ø SapExceptionSap集成异常Ø CMExceptionCM操作异常Ø DBExceptionDB操作异常Ø AppException自定义应用异

2、常u WorkFlowException工作流管理异常u PermissionException权限管理异常u ManageException应用管理异常（含后台管理）u CommonException其它应用异常代码定义依据异常结构的定义，对异常代码同样进行划分，各异常的代码范围如下：Ø XmlException PE00001-PE00100Ø DominoException PE00101-PE00200Ø SapExceptionPE00201-PE00300Ø CMExceptionPE00301-PE00400Ø DBExcepti

3、onPE00401-PE00500Ø AppExceptionPE01000-PE09000u WorkFlowExceptionPE01001-PE01100u PermissionExceptionPE01101-PE01200u ManageExceptionPE01201-PE01300u CommonExceptionPE01301-PE01400集成应用说明异常抛出处理结构如图:说明：Ø 底层模块如果底层模块具有自定义异常类如CMHandler,NoteHandler,那么只允许抛出相关异常，也就是说CMHandler只能抛出CMException,NoteHa

4、ndler只能抛出NotesException。一、 如果底层模块捕获到系统异常，则必须将该系统异常作为内嵌异常抛出,即 throw new CMException(异常代码，系统异常)二、如果底层模块需主动抛出异常，则调用 throw new CMException(异常代码)其它模块及工具类依次类推。Ø 业务逻辑必须遵循异常规化的原则,尤其是CommonException和ManagerException,如属于后台管理异常一律抛出ManagerException,前台应用异常一律抛出CommonException。一、 捕获异常尽量必免用异常父类Exception捕获，应分级捕

5、获，如tryCatch(CMException CME)Catch(CommonException CE)Catch(PortalException PE)Catch(Exception e)具体捕获层次取决于应用需求。二、如果捕获到底层模块异常，应将底层模块异常作为内嵌异常抛出,如tryCatch(CMException CME)throw new CommonException(异常代码,CME)三、如果需主动抛出异常,应向上抛出,如tryif 不成功throw new CommonException(异常代码)Catch(CommonException CE)throw new Comm

6、onException(CE);Ø 控制层接收业务逻辑异常，调用异常处理程序(该部份正在设计中)接口使用概述包名类名PortalException功能说明异常处理父类接口名称接口描述PortalException(String _strErrCode)通过错误代码构造异常PortalException(String _strErrCode, String _sParams)通过错误代码，参数数组构造异常PortalException(Throwable _cause)通过系统异常构造异常PortalException(String _strErrCode, Throwable _ca

7、use)通过错误代码，系统异常构造异常PortalException(PortalException _pe)通过自定义异常构造异常getMessage()获取错误信息(自身信息+内嵌信息)getErrCode()获取异常代码printStackTrace()打印堆栈信息接口名称PortalException(String _strErrCode)接口说明通过错误代码构造异常输入参数String 错误代码返回结果无接口名称PortalException(String _strErrCode, String _sParams)接口说明通过错误代码，参数数组构造异常输入参数String 错误代码S

8、tring 参数数组(我们可能需要传递一些参数来个性化异常信息，做到异常信息的通用化,在异常信息配置文件中，用一些特殊的标志来标识需要被参数化的地方,目前这种标识用?来做如: “?,您没有正常登录!”在参数数组中传入用户ID 杨龙，最后构造出来的异常信息就是“杨龙，您没有正常登录！”返回结果无接口名称PortalException(String _strErrCode, Throwable _cause)接口说明通过错误代码、系统异常构造异常输入参数String错误代码Throwable系统异常返回结果无接口名称PortalException(PortalException _pe)接口说明通过自定义异常构造异常输入参数PortalException自定义异常返回结果无接口名称PortalException(Throwable _cause)接口说明通过系统异常构造异常输入参数Throwable系统异常返回结果无接口名称getMessa