基線版本二次開發(fā)規(guī)范指導文檔要點

1、中電長城發(fā)卡機基線版本二次開發(fā)規(guī)范中電長城發(fā)卡機基線版本二次開發(fā)規(guī)范v1.0擬 制:審核:批準:中電長城（長沙）信息技術有限公司應用開發(fā)團隊2015年03月03日中電長城發(fā)卡機基線版本二次開發(fā)規(guī)范版本記錄修訂日期版本號修訂內(nèi)容編寫人備注2015.03.03V1.0新建目錄1. 概述32. 遵循的原則33. 一級目錄結構介紹 33.1. Core 目錄33.2. Base 目錄33.3. App 目錄44. 平臺資源加載優(yōu)先級 45. 二級目錄45.1. Flash主框架背景目錄 45.2. Css樣式目錄55.2.1. 命名55.2.2. 引用65.3. Local資源目錄75.3.1. 介紹

2、75.3.2. 目錄結構75.3.3. 資源分類. Image目錄（動畫、圖片）. Report 目錄. Sound 目錄85.4. Mock 目錄85.5. Tpl 目錄85.6. Trans 目錄86. 配置中的命名規(guī)則96.1. Flexview.xml 中 name 屬性命名 96.2. action.xml 中 name 屬性命名96.3. tran.xml 中 TranNO 屬性命名 107. 常量定義108. Session命名空間 109. 統(tǒng)一的session、application 變量及頁面參數(shù)訪問 1010. 平臺組件參數(shù)

3、初始化（JAVA類調(diào)試）11141. 概述二次開發(fā)指在現(xiàn)有平臺基線版本上，進行具體銀行應用項目的具體業(yè)務代碼實現(xiàn)或者通過評估后，對基線版本中的功能進行豐富和積累。2. 遵循的原則遵循的原則主要有三點：1、Core目錄下的變更修改，由平臺開發(fā)人員進行，應用開發(fā)者不能進行修改；2、Base目錄下的變更修改，有基線版本人員在機構討論確認后，進行積累修改，應用 開發(fā)者不能進行修改；3、App目錄下的變更修改，則有應用開發(fā)人員根據(jù)實際需要或從基線中將實際用到的功能模塊提取拷貝到app下（實際中，如果功能不變，那么只需要拷貝具體模塊下的flexviews.xml文件，目錄結構和 base目錄結構保持一致）

4、；或新增新的功能模塊。3. 一級目錄結構介紹3.1. Core 目錄g.s"nN呂cfccssctp0倉句句矗P 廠1>在實際開發(fā)過程中，我們常關注的主要是tpl目錄和script目錄。1、 tpl目錄下主要是我們常常使用到的JSP模板（在編寫flexview.xml時會使用到）；2、 script目錄主要是平臺的封裝的JS,涉及到主要有 OCX控件的調(diào)用（如二代證，攝像頭等），JS界面效果（如信息提示框），以及一些經(jīng)常用到的JS對象方法。3、 CSS目錄主要是核心提供給模板的css樣式。3.2. Base 目錄trans該目錄中主要是基線版本整理出來的常用業(yè)務功能。我們主要關

5、注的是cfg目錄、css目錄、local目錄。1、cfg目錄下是平臺基線版本的業(yè)務功能模塊和相關的參數(shù)配置信息。2、Css基線版本中頁面樣式設置，該目錄下的樣式文件，大量用途功能模塊中的通用頁面設置上。3、Local目錄下主要是媒體資源文件4、 Tpl目錄主要是進行基線版本開發(fā)時，早core目錄下的模板無法滿足需要，而自己進行 模板編寫放在該目錄下。5、 Trans目錄主要是基線版本開發(fā)中使用到的子JS或是子JSP,放到該目錄下。3.3. App 目錄鼻顯applocalmockscripttra rm該目錄主要是在具體的銀行項目開發(fā)中使用，除了 根據(jù)實際情況進行編寫。script目錄使用較少

6、外，其他都需要4.平臺資源加載優(yōu)先級在實際銀行項目開發(fā)過程中，我基于平臺基線版本進行二次開發(fā)，可大大節(jié)省重復的開發(fā)工作，主要原因是基線中已經(jīng)提供了實現(xiàn)好的功能模塊，我們只需要在流程配置中加載進去即可，但由于各個銀行的界面元素風格不同，因此需要進行flexview.xml、css rpt模板、圖片動畫 等等資源文件按照 基線版本中的命名保持一致進行修改，從而達到在不改變功能實現(xiàn)上，通過替換來實現(xiàn)風格的轉換。因此，在app和base兩個目錄下的資源存在一個優(yōu)先級別的關系，具體如下:App/cfg下具體功能模塊資源（最高）Base下全局資源（最低）1、App目錄下功能資源文件,最高，例如：app/c

7、fg/autocfg/業(yè)務功能，下的資源文件;2、App目錄下全局資源文件,次之，例如：app/css；3、Base目錄下功能資源文件,再次之，例如：base/cfg/autocfg/業(yè)務功能，下的資源文件;4、Base目錄下全局資源文件,最低，例如： base/css;。資源加載，是由高到底進行,如果最高級有，則使用最高的，沒有在降一級加載。以此類推。5. 二級目錄5.1. Flash主框架背景目錄該目錄主要是在 app 一級目錄下，有兩個文件在不同項目中需要被替換VTM.swfBg.jpg :背景圖片5.2. Css樣式目錄該目錄主要是應用的css樣式目錄，主要有文件：Manage.css

8、：主要是后臺管理的通用按鈕布局樣式，及其他。Common.css:主要是flexview.xml中的標簽通用屬性布局、樣式。Newcard.css :主要是發(fā)卡的通用按鈕布局樣式，及其他。Style.css：平臺提供的模板樣式。5.2.1. 命名Manage.css、Common.css、Newcard.css下的樣式命名，原則使用.文件名_ 開頭，例如:1、Manage.css 使用的是：/* 界面顯示3個按鈕布局樣式位置mag_3_butt_+ 編號（例如.mag_3_butt_1,表示從左往右數(shù)，左邊第一個按鈕位置，.mag 3 butt 0默認表示按鈕隱藏不顯示）.mag_3_butt

9、_0 top : 840;left : 250 ;.mag 3 butt 1top : 840;left : 200 ;.mag 3 butt 2top : 840;left : 515 ;.mag 3 butt 3top : 840;left : 824 ;2、Common.css 使用的是：/* fontName屬性字體設置*/.common_fontName fontName :微軟雅黑；3、Newcard.css使用命名是：/* 界面顯示3個按鈕布局樣式位置.newcard 3 butt+編號（例如.newcard 3 butt 1,表示從左往右數(shù)，左邊第一個按鈕位置.newcard

10、3 butt 0默認表示按鈕隱藏不顯示）.newcard 3 butt 0top : 840;522.引用這里主要是講解平臺中flexview.xml中如何使用，樣式的使用通過class屬性進行,舉例說明：1引用單個樣式：<Panel background ="" Rtl ="" timeout=""arrowStyle= "LEFT"class = "$mon=.common Panel label"/>該配置class屬性中引用的樣式指的是：common.css文件中的.comm

11、on_Panel_label樣式,$ mon=.com mon_Pan el_label中的 mon指得是 css 目錄下的 com mon. css 文件，后面的common_Panel_label指的是common.css文件設置的樣式。（注意：根據(jù)平臺資源加載優(yōu)先級別來自動決定是app還是base下的）。2、引用多個樣式：vOutputBox RtlType ="Text" id ="1"class ="$mon=.common error msg|common=.common TextColor fontName"html =

12、"true" fontWeight ="" ></ OutputBox >該配置class屬性中引用的樣式指的是： css目錄下的common.css文件中的兩個樣式設置，分另U是 common.css文件中的的 .common_error_msg 禾口.common_TextColor_fontName 兩 個樣式，“用于區(qū)分多個樣式，也可以使多個不同文件樣式，如下所示：class ="$mon=.common error msg|manage=.mag TextColor fontName"指 的 是 commo

13、n.css 文件 中的的.common_error_msg 禾口 manage.css 文件中 的.mag_TextColor_fontName 兩個樣式。1、 兩個樣式引用時，樣式設置中的屬性不可重復，比如：都有l(wèi)eft 屬性，那么在解析的時 候這會出錯。2、 根據(jù)平臺資源加載優(yōu)先級別來自動決定是app還是base下的）。53 Local資源目錄531. 介紹該目錄存在于app、base core三個一級目錄下他的資源則為該一級目錄下的全局資源 該目錄如果存在于一級目錄下的cfg/autocfg下的具體功能模塊下，則為該功能模塊的資源。5.3.2. 目錄結構J 邇 localJ 命 Chin

14、ese鼻 2 image> 鬲 butt、匸 flashL】資源對頤表,txt肌陰為 reportL-? sound闖 perties BIO； english該目錄存在于app、base core三個一級目錄下，存放的主要是多媒體資源文件（資源加載 使用遵循第四章節(jié)的“平臺資源加載優(yōu)先級”），主要包括：flash文件、圖片文件、音頻文件、rpt模板文件、perties信息文件。目錄結構如上圖所示：Local包括兩種語言，中文和英文兩級目錄，這兩級目錄下的子結構 保持一致。5.3.3. 資源分類5.331.Image目錄（動畫、圖片）該目錄下郵

15、兩個子目錄：butt和flashButt :他主要存放的是.swf文件格式的按鈕。命名格式：英文翻譯_butt.swf例如：checkBala nce_butt.swf表示余額查詢按鈕。Flash :他從主要存放的是.swf文件格式的二級底背景和動畫。 命名格式：1英文翻譯_bg.swf表示二級底背景。例如：warmNotice_bg.swf 表示溫馨提示二級底背景框2、功能_英文翻譯_mov.swf表示動畫效果。例如：fun ctionn sertCard_mov.swf表示插卡動畫（功能中使用）mainnsertCard_mov.swf表示主界面中的插卡動畫。1在image根目錄下，必須有

16、一個.txt格式的資源對照表文件。2、如果有特殊情況需要.jpg等格式的圖片文件，則直接存放在image目錄下。5332Report 目錄該目錄主要是存在rpt模板文件。命名規(guī)則：1、顯示輸出的rpt模板文件名命名規(guī)則：flexview.xml配置中行的 name屬性命名.rpt （備注：flexview.xml配置中行的 name屬性 命名命名規(guī)則詳見 6.1章節(jié)）。2、打印輸出的rpt模板文件名命名規(guī)則：flexview.xml配置中行的 name屬性命名_print .rpt （備注：flexview.xml配置中行的 name 屬性命名命名規(guī)則詳見6.1章節(jié)）。示例說明：女口果 fle

17、xview.xml 中的 name屬性命名為： cardboxmag_mainCardboxList_display。1、顯示輸出示例：rpt 顯示模板文件名：cardboxmag_mainCardboxList_display.rpt2、打印輸出示例：rpt 顯示模板文件名：cardboxmag_mainCardboxList_display_print.rpt.Sou nd 目錄該目錄主要存放的是音頻文件。音頻文件命名規(guī)則：英文翻譯。例如：inputPassWord.wav （請輸入輸入密碼）。5.4. Mock 目錄該目錄存在于app base core根目錄下（備注：目錄

18、中的資源則為全局資源，當前使 用該方式），也可新建在具體功能模塊目錄下（ 備注：目錄中的資源則為模塊資源，暫未實 現(xiàn)該方式），存放的主要是模擬報文文件，文件名命名和action.xml中的Action標簽中的Name屬性值一致。5.5. Tpl 目錄該目錄存在于app base、core根目錄下（則為全局資源），也可新建在具體功能模塊目 錄下（則為模塊資源），主要存放為模板文件。在該目錄下可新建分類的模板目錄?？蓞⒖?core目錄結構。5.6. Trans 目錄該目錄為子JS或子JSP存放目錄，它主要有兩中方式：1、app、base core 根目錄下這種方式的為全局性資源，優(yōu)先級參考第四章2

19、、具體功能模塊目錄下該方式為模塊資源，優(yōu)先級最高，參考第四章。因此，在實際中，如果沒有特殊情況， 子JS或子JSP必須使用該種方式文件命名：文件名必須flexview.xml 中的RIAView 標簽中的Name屬性值一致。備注：文件命名和 flexview.xml中的RIAView 標簽中的name屬性值一致。6. 配置中的命名規(guī)則6.1. Flexview.xml 中 name 屬性命名命名規(guī)則遵循功能名+處理過程（或處理類別）的全英文翻譯的原則。 規(guī)則：功能名_處理過程_類型（后面可根據(jù)實際需要繼續(xù)以“_”拼接）。類型主要有一下幾種：1、Display （顯示信息）主要適用于顯示列表信息

20、，查詢信息，如：查詢列表信息，余額信息等等示例 1: cardboxmag_mainCardboxList_displaycardboxmag指功能模塊mainCardboxList指主界面卡箱信息列表 display指類型為顯示2、_Error （錯誤信息）主要適用于顯示錯誤信息，如：錯誤提示信息顯示配置示例 2： cardboxmag_mainCardboxList_errorrcardboxmag指功能模塊mainCardboxList指主界面卡箱信息列表errorr指類型，為錯誤3、Succeed （成功信息）主要適用于顯示錯誤信息，如：錯誤提示信息顯示配置示例 2： cardboxm

21、ag_mainCardboxList_succeedcardboxmag指功能模塊mainCardboxList指主界面卡箱信息列表succeed指類型，為成功4、_Wait （等待處理）主要適用于正在處理中的情況，如：正在處理請稍后示例 2： cardboxmag_mainCardboxList_waitcardboxmag指功能模塊mainCardboxList指主界面卡箱信息列表wait指類型，為處理等待6.2. action.xml 中 name 屬性命名命名規(guī)則遵循功能名+處理過程（或處理類別）的全英文翻譯的原則。 規(guī)則：1、功能名_處理過程（注意，處理過程英文翻譯的第一個字母必須大

22、寫） 示例 2： cardboxmag_FindCardboxList 查詢卡箱信息 actioncardboxmag指功能模塊FindCardboxList指處理過程63tran.xml中TranNO 屬性命名TranNo屬性命名必須和 action中的Name屬性一致，否則無法調(diào)用該配置文件中的處理過程7. 常量定義類定義：com.gwi.abmc.global.AppC on sta nt.java說明：將應用相關的所有字符串常量定義在此類中，可減少代碼維護成本，同時增強代碼可閱讀性。示例：/回單主鍵內(nèi)部字段分隔符public static finalStringKEY_SPLITER

23、= "A"/默認超級管理員用戶名、密碼及權限(將應用配置參數(shù)作為常量來引用)publicstaticfinalStri ngMANAGER_DEFAULT_ID = AppParamsHelper.getAppParam ("appManagerNo" );publicstaticfinalStri ngMANAGER_DEFAULT_PWD = AppParamsHelper. getAppParam ("appManagerPwd");有了以上定義，應用中回單主鍵內(nèi)部字段分隔符” A ”的使用，可通 AppC on sta nt.

24、KEY_SPLITER來引用，等等。.Session命名空間類定義:com.gwi.abmc.global.Sessio nN amespace.java說明：Session變量名定義，應用中與業(yè)務相關的所有Session名稱定義在此，應用中對Sessi on的訪問，請使用此類中定義的名稱進行訪問。示例：Sessi onN amespace.java中定義：publicstaticfinalStri ngUSER NAME ="USERNAME'應用環(huán)節(jié)：1.java,jsp中引用示例：Sessio n.getAttribute(Sessio nN amespace.USER

25、_NAME);Sessio n.setAttribute(Sessio nN amespace.USER NAME,somevalue);2.xml配置中引用(需平臺支持)示例：value= ” $s. USER_NAME9.統(tǒng)一的 session application 變量及頁面參數(shù)訪問變量及頁面參數(shù)訪問方法，一般在action類定義：com.gwi.abmc.util.ActHelper.java 說明：提供統(tǒng)一的 session 、application 中使用。初始化：方試1:ActHelperactHelper= new ActHelper(IModel,OModel);方試2 :ActHelperactHelper= new ActHelper(this);方法說明：1. 獲取終端信息publicJSONO