異常管理接口說(shuō)明

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

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

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

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

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

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

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

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