.异常管理接口说明.docVIP

异常管理接口说明 文档历史 日期 描述 作者 2004-06-11 创建文档 余健 异常管理设计简介 系统中应对外协或集成的第三方成品做异常封装。整个系统统一定义由exception中继承的异常PortalException,依据对组件异常封装和自定义应用异常封装的原则，派生出以下异常： XmlException xml操作异常 DominoException Domino集成异常 SapException Sap集成异常 CMException CM操作异常 DBException DB操作异常 AppException 自定义应用异常 WorkFlowException 工作流管理异常 PermissionException 权限管理异常 ManageException 应用管理异常（含后台管理） CommonException 其它应用异常 代码定义 依据异常结构的定义，对异常代码同样进行划分，各异常的代码范围如下： XmlException PE00001-PE00100 DominoException PE00101-PE00200 SapException PE00201-PE00300 CMException PE00301-PE00400 DBException PE00401-PE00500 AppException PE01000-PE09000 WorkFlowException PE01001-PE01100 PermissionException PE01101-PE01200 ManageException PE01201-PE01300 CommonException PE01301-PE01400 集成应用说明 异常抛出处理结构如图: 说明： 底层模块 如果底层模块具有自定义异常类如CMHandler,NoteHandler,那么只允许抛出相关异常，也就是说CMHandler只能抛出CMException,NoteHandler只能抛出NotesException。 如果底层模块捕获到系统异常，则必须将该系统异常作为内嵌异常抛出, 即 throw new CMException(异常代码，系统异常) 二、如果底层模块需主动抛出异常，则调用 throw new CMException(异常代码) 其它模块及工具类依次类推。 业务逻辑 必须遵循异常规化的原则,尤其是CommonException和ManagerException,如属于后台管理异常一律抛出ManagerException,前台应用异常一律抛出CommonException。 捕获异常尽量必免用异常父类Exception捕获，应分级捕获，如 try{ }Catch(CMException CME){ }Catch(CommonException CE){ }Catch(PortalException PE){ }Catch(Exception e){ } 具体捕获层次取决于应用需求。 二、如果捕获到底层模块异常，应将底层模块异常作为内嵌异常抛出,如 try{ }Catch(CMException CME){ throw new CommonException(异常代码,CME) } 三、如果需主动抛出异常,应向上抛出,如 try{ if 不成功 throw new CommonException(异常代码) }Catch(CommonException CE){ throw new CommonException(CE); } 控制层 接收业务逻辑异常，调用异常处理程序(该部份正在设计中) 接口使用概述 　 包名 mon.exception 类名 PortalException 功能说明 异常处理父类 接口名称 接口描述 PortalException(String _strErrCode) 通过错误代码构造异常 PortalException(String _strErrCode, String[] _sParams) 通过错误代码，参数数组构造异常 PortalException(Throwable _cause) 通过系统异常构造异常 PortalException(String _strErrCode, Throwable _cause) 通过错误代码，系统异常构造异常 PortalException(PortalException _pe) 通过自定义异常构造异常 getMessage() 获取错误信息(自身信息+内嵌信息) getErrCode() 获取异常代码 printStackTrace()