【導讀】科藍公司網上銀行系統(tǒng)。科藍軟件系統(tǒng)有限公司

　　

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