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

　　

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