绑定变量SQL查询方法使用说明.doc

变更设计-绑定变量动态SQL查询方法设计BindSQL查询方法使用说明1 使用说明调用绑定变量查询接口使用说明。1. 声明BindSQL对象实例2. 编写标准绑定变量动态SQL。3. 顺序调用setValueList将参数，传入参数值，对应表名、列名。表名与列名为SQL中参数对应列的表名与类型，SQL编写时对char类型的列使用trim（）方法，则表名、列名传null即可。setValueList提供两种构造函数方便调用者使用:setValueList(String tValue,String tTableName,String tColName)setValueList(double tValue,String tTableName,String tColName)注：若变量字段无对应表、列且变量的类型为varchar 则tTableName、tColName填null或 “”若变量字段无对应表、列且变量的类型为date 则tTableName、tColName填date若变量字段无对应表、列且变量的类型为number 则tTableName、tColName填number4. 调用query(String tSQL)方法，传入编写好的动态SQL，得到SSRS容器。该方法支持非绑定变量动态SQL查询，并返回SSRS，处理逻辑与ExeSQL类似。1.1 实例 String tSQL = Select 测试|count(1) From lcpol l Where 1=1 + And l.polno = ? + And trim(l.contno) = ? + And l.amnt = ? + And l.payintv = ? + And l.cvalidate = ? + And l.riskcode = ? + And l.managecom like ? + And (case ? when 1 then 1 end )=1 + And (case ? when 1 then 1 end )=1 ; BindSQL tBindSQL = new BindSQL(); tBindSQL.setValueList(8632H00025520,lcpol,polno); tBindSQL.setValueList(8632H0002552,null,null); tBindSQL.setValueList(20000,lcpol,amnt); tBindSQL.setValueList(12,lcpol,payintv); tBindSQL.setValueList(2002-6-27,lcpol,cvalidate); tBindSQL.setValueList(00601000,lcpol,riskcode); tBindSQL.setValueList(8632%,); tBindSQL.setValueList(1,number,number); tBindSQL.setValueList(1,); SSRS rs = tBindSQL.query(tSQL);for(int k=1;k=rs.MaxRow;k+)String t= ; for(int j=1;j=rs.MaxCol;j+) t+=rs.GetText(k,j)+ ; System.out.println(结果 = +t);# BindSQL = Select 测试|count(1) From lcpol l Where 1=1 And l.polno = 8632H00025520 And trim(l.contno) = 8632H0002552 And l.amnt = 20000.0 And l.payintv = 12 And l.cvalidate = 2002-6-27 And l.riskcode = 00601000 And l.managecom like 8632% And (case 1 when 1 then 1 end )=1 And (case 1 when 1 then 1 end )=1 结果 = 测试1测试结论：Like使用绑定变量方式查询测试通过。Number类型绑定变量方式查询测试通过。Char类型使用绑定变量方式查询测试通过。VarChar类型使用绑定变量方式查询测试通过。使用Trim（）后使用绑定变量方式查询测试通过。1.2 文件列表JAVAsrccomsinosoftutilityBindSQL.javaJAVAsrccomsinosoftutilityBindValue.javaJAVAsrccomsinosoftutilityUserTableInfo.java2 注意事项1. 绑定变量的写法较为严谨，需严格限定输入值的顺序，以及SQL书写规范。例1：select ？num？+1 from dual,当num为空时，原算法程序执行结果为1，而新算法程序会报错。该SQL可以改写为select nvl(？num？,0)+1 from dual，使得新旧算法程序均支持。例2：select case ?FLAG? WHEN 1 THEN 0 ELSE FROM DUAL 要素FLAG对应的类型应为number类型，故表名与列名段应填写number2. 绑定变量的执行计划是以第一次执行时产生的，若绑定变量的字段数据分布不均，且第一次传入参数占有权重较大，则可能会影响到索引使用，造成之后的执行索引使用不当,影响效率，建议对分布不均的字段不适用绑定变量查询方式。3. 若要素无对应表名与列名，且要素值类型可为varchar，则表名、列名描述描述“”。4. 若要素无对应表名与列名，且要素值类型需为number，则表名、列名描述“number”。如：select case ?FLAG? WHEN 1 THEN 0 ELSE FROM DUAL要素FLAG对应的类型应为number类型，故表名与列名段应填写number5. 若要素无对应表名与列名，且要素值类型需为Date，则表名、列名描述“date”。6. 对于字段使用trim，substr等函数的，则可认为该字段为varchar7. SQL中”%”在变量左边的建议不使用绑定变量，因为可能无法使用到索引，会使得该S