【導(dǎo)讀】科藍(lán)公司網(wǎng)上銀行系統(tǒng)?？扑{(lán)軟件系統(tǒng)有限公司

　　

【正文】 文件名稱(chēng)： CSII Security Product User Guide 頁(yè)碼 /頁(yè)數(shù) ： 第 19 頁(yè) 切記：字符串中不能包含空格，因?yàn)樵摯畬⑼ㄟ^(guò) i18n的 properties獲取針對(duì)特定語(yǔ)種的信息。 ? public void submit(Context context) throws PeException； 此入口用于對(duì)完成該交易的最終處理，如修改數(shù)據(jù)庫(kù)，或發(fā)動(dòng)主機(jī)交易以完成業(yè)務(wù)。 切記：在 submit中不能調(diào)用 prepare()。 擴(kuò)展方法 在擴(kuò)展前，請(qǐng)先看以確定擴(kuò)展是必要的。 一般而言，擴(kuò)展有二種可能性： ? 該交易需要額外的有效性檢查，或者需要在發(fā)送主機(jī)前需要準(zhǔn)備一些額外數(shù)據(jù)。 針對(duì)這種情況，子類(lèi)需要重載： public void prepare(Context context) throws PeException { //TODO 在這里加有效性檢查的代碼 } ? IbsTwophaseAction提供的處理不能滿(mǎn)足要求，如需要更新本地?cái)?shù)據(jù)庫(kù)或需要發(fā)動(dòng)一次以上的主機(jī)交易。 針對(duì)這種情 況，子類(lèi)需要重載： public void submit(Context context) throws PeException； //切記： 在該方法內(nèi)不能寫(xiě) prepare(context)。 //TODO 在這里加處理代碼， 有效性檢查部分 必須 在 prepare()內(nèi)處理， 。 } 可調(diào)用的父類(lèi)方法： ? 發(fā)動(dòng)主機(jī)交易： (, trsCode )。 Object fromHost = issueHostTrs(context, map)。 ? 獲取其它資源： 順序號(hào)產(chǎn)生器： IdFactory idFactory= ()； 科藍(lán)軟件系統(tǒng)有限公司 文件編號(hào) CSIIGUIDEIBSAPI Client Server International Inc. 日期 2020 年 02 月 15 日 文件名稱(chēng)： CSII Security Product User Guide 頁(yè)碼 /頁(yè)數(shù) ： 第 20 頁(yè) SqlMapping： () 入口 submit()的 內(nèi)部流程 ? 獲取所有輸入數(shù)據(jù)（根據(jù)交易定義里的 fieldsfields/） 。 ? 準(zhǔn)備系統(tǒng)預(yù)設(shè)參數(shù)， 請(qǐng)參考 IbsQueryAction 部分； ? 格式化發(fā)送報(bào)文； ? 發(fā)送主機(jī)并接受返回； ? 若該 Action設(shè)置了 returnCodeValidator，則通過(guò) returnCodeValidator 來(lái)檢查主機(jī)返回碼，若非正常返回系統(tǒng)拋出 ValidationException。 ? 將主機(jī)返回?cái)?shù)據(jù)放入 context，默認(rèn)將返回 Map 的所有 Entry 放入 resultKeyName 不為空，則將返回 Map 作為一個(gè) 整體放入 context,鍵為resultKeyName。 關(guān)于 Template 常用模版： queryTemplate：用于查詢(xún)交易的模版 emptyPageLoadertemplate：裝載頁(yè)面的模版 pageLoaderTemplate：裝載頁(yè)面并初始化數(shù)據(jù)的模版 twoPhaseTrsTemplate：二階段交易的模版（不含授權(quán)流程） entryTrsWorkflow（二階段交易的模版（含授權(quán)流程）） trsConfirmTemplate(用于顯示確認(rèn)頁(yè) ) 舉例： 交易定義： !調(diào)出輸入頁(yè)面 , YourAction的 init()會(huì)被自動(dòng)調(diào)用 transaction id=step1 template=pageLoaderTemplate actions ref name=act01YourAction/ref /actions 科藍(lán)軟件系統(tǒng)有限公司 文件編號(hào) CSIIGUIDEIBSAPI Client Server International Inc. 日期 2020 年 02 月 15 日 文件名稱(chēng)： CSII Security Product User Guide 頁(yè)碼 /頁(yè)數(shù) ： 第 21 頁(yè) channels channel type= param name=successinputPage/param /channel /channels /transaction !—返回確認(rèn)頁(yè)面 , YourAction的 prepare()會(huì)被自動(dòng)調(diào)用 transaction id=step2 template=trsConfirmTemplate actions ref name=act01YourAction/ref /actions fields 有效性檢查 /fields channels channel type= param name=successconfirmPage/param /channel /channels /transaction !—返回結(jié)果頁(yè)面 , YourAction的 prepare()會(huì)被自動(dòng)調(diào)用 transaction id=step3 template=entryTrsWorkflow actions ref name=act01YourAction/ref /actions fields 有效性檢查 (同 step2) /fields channels channel type= param name=successresultPage/param /channel /channels /transaction 頁(yè)面 ： 確認(rèn)頁(yè)： 科藍(lán)軟件系統(tǒng)有限公司 文件編號(hào) CSIIGUIDEIBSAPI Client Server International Inc. 日期 2020 年 02 月 15 日 文件名稱(chēng)： CSII Security Product User Guide 頁(yè)碼 /頁(yè)數(shù) ： 第 22 頁(yè) pe:hiddenData / 使用該 Tag可保存所有上頁(yè)提交的數(shù)據(jù)。 科藍(lán)軟件系統(tǒng)有限公司 文件編號(hào) CSIIGUIDEIBSAPI Client Server International Inc. 日期 2020 年 02 月 15 日 文件名稱(chēng)： CSII Security Product User Guide 頁(yè)碼 /頁(yè)數(shù) ： 第 23 頁(yè) 關(guān)于 Custom Tags pe:option,pe:checkbox, pe:radio ? 這三種 Tag 的 optionName 都可包含多個(gè) key 或?qū)ο蟮膶傩?，通過(guò) ”,”分隔。 SELECT name=AcNo pe:option items=${} optionName=id,name delimeter=” ” (默認(rèn)為 /) optionValue=id currentValue=${AcNo} / /SELECT 若 optionName里指定的變量還需要字典翻譯，則可加constantPrefix=”prefix1,prefix2” prefix?與 optionName一一對(duì)應(yīng)，對(duì)無(wú)需翻譯的設(shè)為空串。 如： SELECT name=AcNo pe:option items=${} optionName=id,name， constantPrefix=”,Currency” delimeter=” ” (默認(rèn)為 /) optionValue=id currentValue=${AcNo} / /SELECT ? 這三種 Tag 的 condition 可以用來(lái)確定列表中哪些項(xiàng)可以輸出。 SELECT name=AcNo pe:option items=${} !— 表 示 accounts列表中的輸出項(xiàng) Account的屬性是‘ 1’或著是‘ 2’的才顯示 由于 ’1’、 ’2’等一位的字符串在邏輯表達(dá)式中的類(lèi)型為 char,因此需要通過(guò)(0)來(lái)獲取字符串的第一個(gè)字符。 對(duì)大于等于二位的字符串，可直接通過(guò) id==’123456’進(jìn)行比較。 科藍(lán)軟件系統(tǒng)有限公司 文件編號(hào) CSIIGUIDEIBSAPI Client Server International Inc. 日期 2020 年 02 月 15 日 文件名稱(chēng)： CSII Security Product User Guide 頁(yè)碼 /頁(yè)數(shù) ： 第 24 頁(yè) condition=(0)==’1’||(0)==’2’ optionName=id,name delimeter=” ” (默認(rèn)為 /) optionValue=id currentValue=${AcNo} / /SELECT pe:option 例一：賬號(hào)列表由 交易初始化。 ? 代碼為： public class XXXXAction extends IbsTwoPhaseAction implements PageLoader { public void init(Context context) throws PeException { //獲 取賬號(hào)列表 list（從數(shù)據(jù)庫(kù)或 user） //通過(guò) SavedArrayList包裹后放入 context。（為了在輸入有錯(cuò)誤時(shí)，能繼續(xù)保留該列表） (AcList, new SavedArrayList(list)。 } } ? 頁(yè)面為： pe:saveMap !—用于保留 AcList,在一個(gè)頁(yè)面中只能出現(xiàn)一次。用于保留頁(yè)面裝載時(shí)的列表數(shù)據(jù)，其他情況不可濫用該 Tag SELECT name=AcNo pe:option items=${AcList} optionName=id optionValue=id currentValue=${AcNo} / /SELECT /pe:saveMap 例二：賬號(hào)列表從用戶(hù)對(duì)象中獲取。 ? 代碼為： 無(wú)需初始化代碼。 ? 頁(yè)面為： !—無(wú)需 pe:saveMap SELECT name=AcNo pe:option items=${} optionName=id 科藍(lán)軟件系統(tǒng)有限公司 文件編號(hào) CSIIGUIDEIBSAPI Client Server International Inc. 日期 2020 年 02 月 15 日 文件名稱(chēng)： CSII Security Product User Guide 頁(yè)碼 /頁(yè)數(shù) ： 第 25 頁(yè) optionValue=id currentValue=${AcNo} / /SELECT 例三：列表從常量表 獲取。 ? 代碼為： 無(wú)需初始化代碼。 ? 頁(yè)面為： !—無(wú)需 pe:saveMap select name=UserStatus pe:option items=${} constantPrefix=UserStatus currentValue=${UserStatus} / /select ? : ! 操作員狀態(tài) list name=UserStatus param 0/param param 1/param param 2/param /list ? : =正常 =注銷(xiāo) =需要重置密碼 pe:checkbox,pe:radio 與 pe:option類(lèi)似。舉例如下： pe:radio fieldName=RoleId items=${RoleList} constantPrefix=Role