異常管理接口說明

1、華為信息門戶異常管理接口說明文檔歷史日期描述作者2004-06-11創(chuàng)建文檔余健異常管理設計簡介系統(tǒng)中應對外協(xié)或集成的第三方成品做異常封裝。整個系統(tǒng)統(tǒng)一定義由exception中繼承的異常PortalException,依據(jù)對組件異常封裝和自定義應用異常封裝的原則，派生出以下異常：Ø XmlException xml操作異常Ø DominoException Domino集成異常Ø SapExceptionSap集成異常Ø CMExceptionCM操作異常Ø DBExceptionDB操作異常Ø AppException自定義應用異

2、常u WorkFlowException工作流管理異常u PermissionException權限管理異常u ManageException應用管理異常（含后臺管理）u CommonException其它應用異常代碼定義依據(jù)異常結(jié)構(gòu)的定義，對異常代碼同樣進行劃分，各異常的代碼范圍如下：Ø XmlException PE00001-PE00100Ø DominoException PE00101-PE00200Ø SapExceptionPE00201-PE00300Ø CMExceptionPE00301-PE00400Ø DBExcepti

3、onPE00401-PE00500Ø AppExceptionPE01000-PE09000u WorkFlowExceptionPE01001-PE01100u PermissionExceptionPE01101-PE01200u ManageExceptionPE01201-PE01300u CommonExceptionPE01301-PE01400集成應用說明異常拋出處理結(jié)構(gòu)如圖:說明：Ø 底層模塊如果底層模塊具有自定義異常類如CMHandler,NoteHandler,那么只允許拋出相關異常，也就是說CMHandler只能拋出CMException,NoteHa

4、ndler只能拋出NotesException。一、 如果底層模塊捕獲到系統(tǒng)異常，則必須將該系統(tǒng)異常作為內(nèi)嵌異常拋出,即 throw new CMException(異常代碼，系統(tǒng)異常)二、如果底層模塊需主動拋出異常，則調(diào)用 throw new CMException(異常代碼)其它模塊及工具類依次類推。Ø 業(yè)務邏輯必須遵循異常規(guī)化的原則,尤其是CommonException和ManagerException,如屬于后臺管理異常一律拋出ManagerException,前臺應用異常一律拋出CommonException。一、 捕獲異常盡量必免用異常父類Exception捕獲，應分級捕

5、獲，如tryCatch(CMException CME)Catch(CommonException CE)Catch(PortalException PE)Catch(Exception e)具體捕獲層次取決于應用需求。二、如果捕獲到底層模塊異常，應將底層模塊異常作為內(nèi)嵌異常拋出,如tryCatch(CMException CME)throw new CommonException(異常代碼,CME)三、如果需主動拋出異常,應向上拋出,如tryif 不成功throw new CommonException(異常代碼)Catch(CommonException CE)throw new Comm

6、onException(CE);Ø 控制層接收業(yè)務邏輯異常，調(diào)用異常處理程序(該部份正在設計中)接口使用概述包名類名PortalException功能說明異常處理父類接口名稱接口描述PortalException(String _strErrCode)通過錯誤代碼構(gòu)造異常PortalException(String _strErrCode, String _sParams)通過錯誤代碼，參數(shù)數(shù)組構(gòu)造異常PortalException(Throwable _cause)通過系統(tǒng)異常構(gòu)造異常PortalException(String _strErrCode, Throwable _ca

7、use)通過錯誤代碼，系統(tǒng)異常構(gòu)造異常PortalException(PortalException _pe)通過自定義異常構(gòu)造異常getMessage()獲取錯誤信息(自身信息+內(nèi)嵌信息)getErrCode()獲取異常代碼printStackTrace()打印堆棧信息接口名稱PortalException(String _strErrCode)接口說明通過錯誤代碼構(gòu)造異常輸入?yún)?shù)String 錯誤代碼返回結(jié)果無接口名稱PortalException(String _strErrCode, String _sParams)接口說明通過錯誤代碼，參數(shù)數(shù)組構(gòu)造異常輸入?yún)?shù)String 錯誤代碼S

8、tring 參數(shù)數(shù)組(我們可能需要傳遞一些參數(shù)來個性化異常信息，做到異常信息的通用化,在異常信息配置文件中，用一些特殊的標志來標識需要被參數(shù)化的地方,目前這種標識用?來做如: “?,您沒有正常登錄!”在參數(shù)數(shù)組中傳入用戶ID 楊龍，最后構(gòu)造出來的異常信息就是“楊龍，您沒有正常登錄！”返回結(jié)果無接口名稱PortalException(String _strErrCode, Throwable _cause)接口說明通過錯誤代碼、系統(tǒng)異常構(gòu)造異常輸入?yún)?shù)String錯誤代碼Throwable系統(tǒng)異常返回結(jié)果無接口名稱PortalException(PortalException _pe)接口說明通過自定義異常構(gòu)造異常輸入?yún)?shù)PortalException自定義異常返回結(jié)果無接口名稱PortalException(Throwable _cause)接口說明通過系統(tǒng)異常構(gòu)造異常輸入?yún)?shù)Throwable系統(tǒng)異常返回結(jié)果無接口名稱getMessa