通用查詢功能第三版EasyQueryVer3使用說明

1、通用查詢功能第三版EasyQueryVer3使用說明1演示模板：22相關(guān)文件23功能說明：23.1.查詢功能23.1.1.easyQueryVer3(strSql, synchronization, useCache, strStart)23.1.2.decodeEasyQueryResult(strResult, notUseEasyQuery, notUseTurnPage, otherTurnPage)33.1.3.easyExecSql(strSql, synchronization, useCache, strStart, notUseEasyQuery, notUseTurnPag

2、e)33.1.4.turnPage.queryModal(strSql, multilineGrid)33.2.顯示功能43.2.1.displayMultiline(arrDisplayData, multilineGrid, otherTurnPage)43.3.翻頁功能43.3.1.turnPageClass()43.3.2.turnPage.getData (arrDataSet, arrDataIndex, pageRecordNum)53.3.3.turnPage.firstPage()53.3.4.turnPage.previousPage()53.3.5.turnPage.ne

3、xtPage()53.3.6.turnPage.lastPage()53.3.7.自動控制顯示翻頁按鈕53.4.其他輔助功能函數(shù)63.4.1.getWherePart(fieldName, controlName, strOperate, fieldType)63.4.2.clearArrayElements(arrData)63.4.3.chooseArray(dataArray, filterArray)64復(fù)雜應(yīng)用實(shí)例74.1.虛擬數(shù)據(jù)源的MultiLine顯示和翻頁操作74.2.在一個(gè)頁面中顯示一個(gè)MultiLine，并多次使用查詢、拆分等功能74.3.在一個(gè)頁面中顯示多個(gè)MultiL

4、ine71 演示模板：l uieasyQueryVer3ExampleEasyQueryVer3ExampleInput.jspl uieasyQueryVer3ExampleEasyQueryVer3ExampleInit.jspl uieasyQueryVer3ExampleEasyQueryVer3Example.js運(yùn)行：http:/localhost:8900/ui/easyQueryVer3Example/EasyQueryVer3ExampleInput.jsp注意：localhost是你的主機(jī)名2 相關(guān)文件請確認(rèn)以下相關(guān)文件存在于對應(yīng)的目錄中：uicommoneasyQuery

5、Ver3EasyQueryVer3.jsuicommoneasyQueryVer3EasyQueryCache.jsuicommoneasyQueryVer3EasyQueryKernel.jspuicommoneasyQueryVer3EasyQueryVer3Window.jsp3 功能說明：必須在使用如下功能的頁面中包含（注意：不要直接從這里拷貝語句到代碼中！）：<SCRIPT src="./common/javascript/Common.js" ></SCRIPT><SCRIPT src="./common/easyQuer

6、yVer3/EasyQueryVer3.js"></SCRIPT>3.1. 查詢功能3.1.1. easyQueryVer3(strSql, synchronization, useCache, strStart)l 功能說明：輸入一個(gè)SQL語句，返回約定格式的查詢結(jié)果字符串。l 輸入?yún)?shù)說明1) strSql（String類型）：SQL語句字符串。2) synchronization（1為同步，0為異步）：默認(rèn)情況為1。同、異步查詢方式設(shè)置。同步為查詢出數(shù)據(jù)后才繼續(xù)執(zhí)行程序；異步為發(fā)出查詢請求后繼續(xù)執(zhí)行程序，查詢結(jié)果會在其他地方進(jìn)行反饋。3) useCache（1

7、為緩存結(jié)果，0為不緩存）：默認(rèn)情況為0。設(shè)置查詢結(jié)果緩存。需要進(jìn)行頁面緩存設(shè)置，即在需要保存結(jié)果的頁面包含（注意，該頁面刷新后緩存將被清空）：<SCRIPT src="./common/easyQueryVer3/EasyQueryCache.js"></SCRIPT>4) strStart（int類型）：默認(rèn)情況為1。設(shè)置查詢開始記錄位置。StrSql為必填參數(shù)，其他可以不填。l 輸出參數(shù)說明1) 查詢成功返回查詢結(jié)果字符串：由記錄和字段拼成，記錄以分隔，字段以|分隔，字段首是查詢出的所有記錄的數(shù)量。2) 查詢失敗返回falsel 使用范例strS

8、ql = "select SysVar, SysVarType, SysVarValue from ldsysvar where 1=1 "strQueryResult = easyQueryVer3(strSql, 1, 1, 1);strQueryResult值為：“ 總記錄數(shù) 記錄1字段1 | 記錄1字段2 | 記錄2字段1 | 記錄2字段2 ”3.1.2. decodeEasyQueryResult(strResult, notUseEasyQuery, notUseTurnPage, otherTurnPage)l 功能說明：將約定格式的字符串拆分成二維數(shù)組。l

9、輸入?yún)?shù)說明1) strResult：約定格式的字符串。主要與easyQueryVer3函數(shù)配套使用，輸入查詢返回的結(jié)果字符串。2) notUseEasyQuery：非easyQueryVer3查詢結(jié)果字符串標(biāo)記。非約定格式字符串。3) notUseTurnPage: 不使用翻頁功能。“1”非，“0”是，默認(rèn)非。4) otherTurnPage: 使用其它的翻頁對象，而不是默認(rèn)的turnPage對象，必須是一個(gè)turnPageClass的對象。l 輸出參數(shù)說明1) 拆分成功返回二維數(shù)組：行（一維）為記錄，列（二維）為字段。2) 拆分失敗返回null3.1.3. easyExecSql(strS

10、ql, synchronization, useCache, strStart, notUseEasyQuery, notUseTurnPage)l 功能說明：將easyQueryVer3和decodeEasyQueryResult結(jié)合使用。輸入一個(gè)SQL語句，返回一個(gè)查詢結(jié)果的二維數(shù)組。l 輸入?yún)?shù)說明（同easyQueryVer3）1) notUseEasyQuery：非easyQueryVer3查詢結(jié)果字符串標(biāo)記。非約定格式字符串。2) notUseTurnPage: 不使用翻頁功能。“1”非，“0”是，默認(rèn)非。l 輸出參數(shù)說明（同decodeEasyQueryResult）3.1.4.

11、 turnPage.queryModal(strSql, multilineGrid)l 功能說明：快速查詢顯示接口，只能使用默認(rèn)的turnPage翻頁對象，一個(gè)頁面只能使用一次。方法會根據(jù)傳入的SQL語句查出數(shù)據(jù)，并顯示在傳入的MultiLine對象中，省去easyQueryVer3->decodeEasyQueryResult->turnPage.getData->displayMultiline等詳細(xì)控制代碼。l 輸入?yún)?shù)說明1) strSql（String類型）：SQL語句字符串。2) multilineGrid：初始化過的Multiline對象。l 輸出參數(shù)說明（無

12、）3.2. 顯示功能3.2.1. displayMultiline(arrDisplayData, multilineGrid, otherTurnPage)l 功能說明：調(diào)用Multiline功能模塊顯示二維數(shù)組。Multiline使用部分詳見侯志敏編寫的使用文檔。l 輸入?yún)?shù)說明1) arrDisplayData：一個(gè)二維數(shù)組。維數(shù)需要與Multiline初始化時(shí)的二維數(shù)組一致。2) multilineGrid：初始化過的Multiline對象。3) otherTurnPage: 使用其它的翻頁對象，而不是默認(rèn)的turnPage對象，必須是一個(gè)turnPageClass的對象。l 輸出參數(shù)

13、說明（無）3.3. 翻頁功能該功能必須配合Multiline和displayMultiline使用3.3.1. turnPageClass()l 功能說明：使用翻頁功能首先要建立turnPageClass對象，必須建立為全局變量，名稱不能改變，必須為var turnPage = new turnPageClass();（水平有限，找不到自動檢測出對象類型的方法）所有的翻頁方法均以該對象的方法調(diào)用，即頁面中調(diào)用翻頁方法需要寫成：<INPUT VALUE="首頁" TYPE=button onclick="turnPage.firstPage();"&

14、gt; <INPUT VALUE="上一頁" TYPE=button onclick="turnPage.previousPage();"> <INPUT VALUE="下一頁" TYPE=button onclick="turnPage.nextPage();"> <INPUT VALUE="尾頁" TYPE=button onclick="turnPage.lastPage();">l 輸入?yún)?shù)說明1) turnPage.strQuer

15、yResult：easyQueryVer3的查詢結(jié)果。2) turnPage.arrDataCacheSet：decodeEasyQueryResult拆分后的二維數(shù)組。3) turnPage.pageDisplayGrid：初始化過的Multiline對象。4) turnPage.strQuerySql：查詢的SQL語句。5) turnPage.pageIndex：查詢結(jié)果顯示起始頁。從0開始記數(shù)，第一頁為0。默認(rèn)0。6) turnPage.useSimulation：使用模擬數(shù)據(jù)源，必須在拆分字符串前付值。為1表示使用，為0表示不使用。默認(rèn)為0。7) turnPage.queryAllRe

16、cordCount：查詢結(jié)果的記錄總數(shù)。在拆分函數(shù)中獲取。8) turnPage.blockPageNum：一個(gè)數(shù)據(jù)塊的頁面數(shù)。默認(rèn)為common.js文件中定義的MAXMEMORYPAGES。9) turnPage.pageLineNum：一個(gè)頁面要顯示的記錄數(shù)。默認(rèn)為common.js文件中定義的MAXSCREENLINES。l 輸出參數(shù)說明（無）3.3.2. turnPage.getData (arrDataSet, arrDataIndex, pageRecordNum)l 功能說明：在查詢結(jié)果數(shù)組中取出符合頁面顯示大小設(shè)置的數(shù)組。是翻頁控制的基礎(chǔ)。（注意：Common.js中定義的M

17、AXMEMORYPAGES * MAXSCREENLINES不能大于查詢塊的大小，查詢塊大小在SysConst.java中的同名變量進(jìn)行設(shè)置）l 輸入?yún)?shù)說明1) arrDataSet：要進(jìn)行數(shù)據(jù)顯示的二維數(shù)組。2) arrDataIndex：當(dāng)前要顯示數(shù)據(jù)在數(shù)組中的索引3) pageRecordNum：當(dāng)前頁面要顯示的記錄數(shù)l 輸出參數(shù)說明1) 成功則返回符合頁面顯示容量的二維數(shù)組。2) 失敗返回null3.3.3. turnPage.firstPage()l 功能說明：從第一個(gè)查詢結(jié)果塊的第一條記錄開始顯示。l 輸入?yún)?shù)說明（無）l 輸出參數(shù)說明（無）3.3.4. turnPage.pre

18、viousPage()l 功能說明：當(dāng)查詢結(jié)果超出一頁的顯示容量時(shí)，查找上一頁數(shù)據(jù)并顯示。l 輸入?yún)?shù)說明（無）l 輸出參數(shù)說明（無）3.3.5. turnPage.nextPage()l 功能說明：當(dāng)查詢結(jié)果超出一頁的顯示容量時(shí)，查找下一頁數(shù)據(jù)并顯示。l 輸入?yún)?shù)說明（無）l 輸出參數(shù)說明（無）3.3.6. turnPage.lastPage()l 功能說明：從最后一個(gè)查詢結(jié)果塊的最后一條記錄開始顯示。l 輸入?yún)?shù)說明（無）l 輸出參數(shù)說明（無）3.3.7. 自動控制顯示翻頁按鈕l 功能說明：在JSP頁面中自動控制顯示翻頁按鈕。使用該設(shè)置后，如果查詢結(jié)果數(shù)量大于頁面設(shè)置的顯示行數(shù)，就會顯示翻

19、頁按鈕，否則不顯示。設(shè)置方法為：在翻頁代碼的外邊加上如下DIV標(biāo)簽：<Div id = "divPage" align=center style = "display: 'none' "><INPUT VALUE="首頁" TYPE=button onclick="turnPage.firstPage();"> <INPUT VALUE="上一頁" TYPE=button onclick="turnPage.previousPage();&

20、quot;> <INPUT VALUE="下一頁" TYPE=button onclick="turnPage.nextPage();"> <INPUT VALUE="尾頁" TYPE=button onclick="turnPage.lastPage();"> </Div>l 輸入?yún)?shù)說明（無）l 輸出參數(shù)說明（無）3.4. 其他輔助功能函數(shù)3.4.1. getWherePart(fieldName, controlName, strOperate, fieldType)

21、l 功能說明：獲取頁面指定控件的值，并按照指定類型拼成SQL語句的尾串。作者為HST。l 輸入?yún)?shù)說明1) fieldName：SQL中要使用的字段名稱。2) controlName：控件名稱。默認(rèn)取與字段相同名稱的控件。3) strOperate：操作符。默認(rèn)為“=”號操作。4) fieldType( 0為字符型，1為數(shù)字型 )：字段類型。默認(rèn)為0。l 輸出參數(shù)說明1) 返回可直接拼至SQL語句WHERE以后的尾串。l 使用范例strSql = "select SysVar, SysVarType, SysVarValue from ldsysvar where 1=1 "

22、; + getWherePart( 'SysVar' ) + getWherePart( 'SysVarType' ) + getWherePart( 'SysVarValue' );3.4.2. clearArrayElements(arrData)l 功能說明：清空數(shù)組函數(shù)。l 輸入?yún)?shù)說明1) arrData：數(shù)組。l 輸出參數(shù)說明1) 返回空數(shù)組。3.4.3. chooseArray(dataArray, filterArray)l 功能說明：過濾二維數(shù)組，獲取需要的字段。l 輸入?yún)?shù)說明1) dataArray：二維數(shù)組。2) data

23、Array：包含過濾索引的一維數(shù)組，存放需要的字段的位置，從0開始記數(shù)。l 輸出參數(shù)說明1) 返回二維數(shù)組。l 使用范例chooseArray( 1，2，3，4 , 0 ) returns 1，34 復(fù)雜應(yīng)用實(shí)例在演示模板中均有以下情況的詳細(xì)實(shí)現(xiàn)方法。4.1. 虛擬數(shù)據(jù)源的MultiLine顯示和翻頁操作虛擬數(shù)據(jù)源的意思是不通過easyQueryVer3（strSql）方法獲取數(shù)據(jù)庫的數(shù)據(jù)，而是通過其它手段（一般是自己寫java后臺或者直接寫死在代碼中）獲得符合規(guī)則的字符串，并將該字符串中的數(shù)據(jù)顯示在MultiLine中加以顯示和操作。 使用的關(guān)鍵點(diǎn)：1 將數(shù)據(jù)字符串保存進(jìn)turnPage的查

24、詢結(jié)果屬性中：turnPage.strQueryResult = strData;2 設(shè)置使用虛擬數(shù)據(jù)源標(biāo)記：turnPage.useSimulation = 1; 3 必須將所有數(shù)據(jù)設(shè)置為一個(gè)數(shù)據(jù)塊：turnPage3.blockPageNum = turnPage3.queryAllRecordCount / turnPage3.pageLineNum;4 接著可進(jìn)行拆分字符串到二維數(shù)組、過濾二維數(shù)組字段等操作，過濾功能只能用在這個(gè)地方。4.2. 在一個(gè)頁面中顯示一個(gè)MultiLine，并多次使用查詢、拆分等功能早期版本不支持這個(gè)功能，屬于設(shè)計(jì)上的缺陷，因?yàn)樵诓鸱止δ埽╠ecodeEasyQueryResult）中設(shè)置了公共屬性，所以當(dāng)一個(gè)查詢被成功執(zhí)行并顯示在MultiLine中后，再次執(zhí)行拆分操作會導(dǎo)致記數(shù)混亂，必須重新再執(zhí)行前一個(gè)查詢。解決方案是擴(kuò)充decodeEasyQueryResult方法的接口，增加了第三個(gè)參數(shù)notUseTurnPage，使與翻頁無關(guān)的查詢不會修改公共屬性。使用的關(guān)鍵點(diǎn)：1 decodeEas