安徽移動經營分析系統詳細設計說明書——總體流程控制和公用模塊第1頁共18頁安徽移動經營分析系統詳細設計說明書（總體流程控制和公共模塊設計）版本號：V0.3安徽移動通信有限責任公司南京聯創科技股份有限公司二○○三年八月修改歷史版本號日期編寫者修改內容0.12003-8-1任保同完成初稿0.22003-9-16任保同修改了文檔格式，增加了數據庫操作部分的處理流程0.32003-9-26任保同修改了首頁，增加了目錄，修改了一些錯別字

目錄安徽移動經營分析系統 1詳細設計說明書 1（總體流程控制和公共模塊設計） 11. 軟件結構 41.1. 功能模塊一覽表 42. 技術實現 43. 各模塊詳細設計 53.1. 截獲過濾模塊設計 53.1.1. 模塊描述 53.1.2. 處理流程 53.1.3. 類對象設計 83.2. 登錄控制模塊設計 83.2.1. 模塊描述 83.2.2. 處理流程 93.2.3. 類對象設計 103.3. 數據庫操作模塊設計 103.3.1. 模塊描述 103.3.2. 處理流程 113.3.3. 類對象設計 133.4. 頁面組合設計 143.4.1. 模塊描述 143.4.2. 類對象設計 143.5. 錯誤處理設計 153.5.1. 模塊描述 153.5.2. 處理流程 153.6. 配置設計 153.6.1. 模塊描述 153.6.2. 處理流程 154. 錯誤處理 175. 附錄 175.1. 定義 175.2. 參考資料 18

軟件結構前臺總體流程控制主要包括截獲過濾層、登錄控制、權限驗證、請求資源配置和跳轉控制、數據源配置等幾個模塊。總體大致流程如下：總體流程控制由以上各模塊配合完成，各模塊的具體功能和實現方法在模塊設計中說明。功能模塊一覽表模塊名稱簡單描述截獲過濾模塊將一些客戶狀態驗證、客戶請求資源的權限驗證統一處理。登錄控制模塊控制用戶登錄系統，確保系統的安全。數據庫操作模塊可復用的數據庫操作模塊。頁面組合設計為所有的頁面設定模版，統一頁面風格。錯誤處理設計統一錯誤信息的處理，包括錯誤信息的生成和展示。系統配置設計配置設計，主要定義了數據源、Action、Form等的引用方法。技術實現參見《安徽移動經營分析系統詳細設計說明書-應用集成發》基本設計概念。各模塊詳細設計截獲過濾模塊設計模塊描述本模塊截獲過濾層，截獲所有客戶端的請求資源，對客戶狀態、客戶請求資源作逐一的驗證，只有所有驗證都通過的請求才定位到請求的資源。 設計的主要目的是將一些客戶狀態驗證、客戶請求資源的權限驗證統一處理。處理流程SignonFilter主要完成兩個任務：截獲用戶的所有請求，并判斷此時用戶session是否過期，如果沒有過期，供以后的模塊處理。在用戶session過期，截獲用戶請求的資源，包括URI和各種參數，保存下來。講用戶的請求定位到登錄模塊，登錄成功后，登錄模塊讀取SignonFilter保存的信息，并定位到讀取的資源。流程圖如下： OperateFilter主要完成以下任務：讀取參數，判斷用戶的操作類型，決定如何跳轉。如果用戶的操作類型為數據庫操作，根據操作類型，判斷用戶是否有操作的權限，根據權限驗證情況確定跳轉。流程圖如下。注意：數據操作處理（查詢、插入、刪除、修改）的要求：查詢操作傳遞參數action=browse&funcmoducode=xxx插入操作時傳遞參數action=insert&funcmoducode=xxx刪除操作時傳遞參數action=delete&funcmoducode=xxx修改操作時傳遞參數action=update&funcmoducode=xxx或者插入、刪除、修改操作時傳遞參數action=edit&funcmoducode=xxx使用Action控制跳轉時，頁面調轉增加參數action=goto。如果不按照上述方式傳遞參數，則流程控制模塊會強制性的將客戶請求跳轉到錯誤處理頁面。類對象設計FilterManager管理所有的過濾器的處理，負責創建FilterChain，并初始化FilterChain中的過濾器。FilterChain是一個容器，所有的過濾器都按一定的順序存放在其中。SignonFilter檢查用戶狀態，用戶是否登錄、Session是否有效等，如果用戶未登錄或Session已經過期，跳轉到登錄界面。對于Session過期的情況，保存用戶當前請求的資源，當用戶登錄成功后，直接跳轉到當前請求的資源。OperateFilter驗證用戶是否有瀏覽或操作（增刪改）權限，這個過濾器會根據用戶的權限和所請求的操作判斷是否執行用戶的請求。如果用戶有相應的權限，則執行用戶的請求，如果用戶沒有相應的權限，則不執行用戶的請求并返回給用戶一條錯誤信息。Target客戶端請求的資源。登錄控制模塊設計模塊描述本模塊登錄控制模塊，完成用戶登錄時的各種驗證，包括，用戶輸入是否為空的驗證（不允許為空）、用戶是否存在，用戶名和密碼是否正確、登錄IP是否合法、登錄時間是否合法等一系列驗證。本模塊的目的是保證合法的用戶的登錄和保證不合法的用戶不能登錄，確保系統的安全。處理流程用戶登錄的過程要完成一系列的驗證，按照順序，依次是用戶是否存在的驗證、用戶密碼是否存在的驗證、用戶登錄IP是否合法的驗證、用戶登錄時間是否合法的驗證。任何一次驗證不能通過，則用戶的狀態始終為未登錄狀態，只有當前一次驗證通過后，才進行下面的驗證，只有當某個用戶通過所有的驗證后，才能成功的登錄。類對象設計LogonAction相當于這一模塊的“客戶端“，負責調用LogonDAO和LogonVO來完成用戶登錄的驗證和資源的重新定位。LogonDAO這是真正的邏輯處理的地方，完成包括用戶是否存在，用戶名和密碼是否正確、登錄IP是否合法、登錄時間是否合法在內的一系列驗證。LogonVO存儲需要驗證的數據，便于訪問，它是由LogonDAO創建的。DataSource這一部分完成數據庫的查詢和數據的封裝，數據的封裝結果以LogonVO的形勢返回給LogonDAO和LogonAction。數據庫操作模塊設計模塊描述本模塊數據庫操作模塊，作為數據庫操作的公共模塊，使管理數據庫操作和業務數據庫操作實現了相同的接口，在調用該模塊來實現數據庫操作時，無論是業務數據庫操作還是管理數據庫操作，只要調用相同的類，相同的方法即可實現。通過多種方式得到數據庫連接，確保得到正確的數據庫連接。處理流程用戶通過這一模塊可以獲得業務數據庫或管理數據庫的連接（DBFactory），兩者獲取連接的邏輯相同，首先嘗試從WebLogic連接池獲得數據庫連接，如果成功獲得數據庫連接，則繼續下面的操作；如果未能成功獲得數據庫連接，則嘗試通過IBMDB2APPDriver獲得數據庫連接，如果成功獲得數據庫連接，則繼續下面的操作；如果未能成功獲得數據庫連接，則繼續嘗試通過IBMDB2NETDriver獲得數據庫連接，如果成功獲得數據庫連接，則繼續下面的操作；如果獲得數據庫連接失敗，則給出出錯信息。在進行數據庫操作時，無論是查詢操作還是增刪改操作，無論是操作成功還是操作失敗，都確保釋放數據庫連接，然后給出操作失敗的信息（操作失敗時）或繼續以下操作（操作成功時）。類對象設計DBUTil是一個抽象類，實現了一些公共方法，比如excuteQuery、excuteUpdate、release。預留了兩個抽象方法，讓涉及到具體的數據庫的方法去實現。MDBUTil是一個管理數據庫的操作的類，實現了setDataSource和setConnection方法，setDataSource使用了weblogic的dataSource的配置，setConnection使用了標準的JDBC獲得數據庫連接，系統默認的先調用setDataSource，如果系統不能正確的從weblogic得到數據庫連接，則系統自動調用setConnection，從標準JDBC獲得連接，這樣增加了系統的穩定性。BDBUTil是一個業務數據庫的操作的類，實現了setDataSource和setConnection方法，setDataSource使用了weblogic的dataSource的配置，setConnection使用了標準的JDBC獲得數據庫連接，系統默認的現調用setDataSource，如果系統不能正確的從weblogic得到數據庫連接，則系統自動調用setConnection，從標準JDBC獲得連接，這樣增加了系統的穩定性。DBFactory是一個專門用來實例化上述類的類，當我們使用數據庫操作時，可以直接通過DBFactory獲得以MDBUTil或BDBUTil實例化的DBUTil，接著可以直接調用DBUTil的excuteQuery，release兩個方法來實現數據庫查詢操作和釋放資源，或者調用DBUTil的excuteUpdate，release兩個方法來實現數據庫增、刪、改操作和釋放資源。頁面組合設計模塊描述本設計模塊主要是為所有的頁面設定模版本設計模塊的目的是統一模版，統一展示風格。類對象設計subjsp組成一個完整的視圖的基本JSP，他們是真正的顯示數據的頁面。這些頁面包括title、header、search、error、content、footer六個組成部分。Template定義樣式的模版，定義了title、header、search、error、content、footer六個部分的排版。compositeView使用模版，并將subjsp中的各個部分包含近來組成一個完整的視圖。錯誤處理設計模塊描述本模塊錯誤處理，完成各種出錯信息的處理，包括生成錯誤信息和展示錯誤信息。統一系統的錯誤處理。處理流程出錯信息存儲在Struts的ApplicationResources中，并在ActionErrors中引用定義在ApplicationResources中定義的鍵值，并在compositeView中包括error頁面，則錯誤信息可以自動顯示。當用戶試圖進行超過自身權限的操作時，頁面自動調轉到錯誤處理頁面，此時會給用戶提供一些選擇，比如返回門戶、還是重新登錄。配置設計模塊描述配置設計，主要定義了數據源、Action、Form等的引用方法。處理流程數據源配置如下： 為了保證的到數據庫連接，在兩個地方配置了數據源。WEBLOGIC數據源，在WEBLOGIC的控制臺完成配置標準JDBC數據源，在config資源文件中完成配置，配置結果如下：#createdby:RenBaotong#createdat:2003.08.05#definedriverclassesdriverClass=COM.ibm.db2.jdbc.app.DB2DriverdriverClass2=COM..DB2Driver#definemanagedatabaseinformationurl_m=jdbc:db2:biuser_m=db2adminpassword_m=db2adminserver_m=1port_m=6789database_m=bischema_m=db2admin#definebusinessdatabaseinformationurl_b=jdbc:db2:bass_aquser_b=db2instpassword_b=db2instserver_b=44port_b=6789database_b=bass_aqschema_b=db2inst#defineweblogicDataSoucedataSource_m=dataSource_bidataSource_b=dataSource_bass全局轉發配置如下： <global-forwards><forwardname="logon"path="/jsp/welcome/logon.jsp"/><forwardname="adhoc"path="/jsp/adhoc/main.jsp"/><forwardname="monitor"path="/jsp/monitor/main.jsp"/><forwardname="olap"path="/jsp/olap/main.jsp"/><forwardname="parameter"path="/jsp/parameter/main.jsp"/><forwardname="portal"path="/jsp/portal/main.jsp"/><forwardname="report"path="/jsp/report/main.jsp"/><forwardname="security"path="/jsp/security/main.jsp"/></global-forwards>ActionForm配置如下： <form-beans><form-beanname="LogonForm"type="bass.util.LogonForm"/></form-beans>ActionMapping配置如下： <action-mappings><actionname="LogonForm"type="bass.util.LogonAction"input="/jsp/welcome/logon.jsp"scope="session"path="/LogonAction"><forwardname="failure"path="/jsp/portal/failure.jsp"/></action><actiontype="bass.p