6.4 bboss-taglib标签库新增标签及属性说明

1.1.1   调整原有标签的属性说明

扩展分页，列表，详细信息页面直接设置statement执行数据库查询功能，增加预编译查询方式

 

o beaninfo标签，pager标签，list标签增加以下属性：

sqlparamskey:指定将绑定变量参数存储在request 属性集中的变量名称，以便pager，beaninfo，list标签获取sql的绑定变量参数值

 

 

上述功能相关的文件：

/bboss-tablib/webapp/WEB-INF/pager-taglib.tld

frameworkset.jar

frameworkset-pool.jar

frameworkset-util.jar

bboss-aop.jar

1.1.2   新增标签

dbutil-执行数据库增、删、改操作（预编译和普通）

sqlparams-用于支持在pager标签，beaninfo标签，list标签上执行预编译操作的绑定变量集合，同时可以指定sql绑定变量的定义语法分界符。

 

batchutil-执行预编译批处理、普通批处理操作

statement-指定batchutil要执行的批处理语句，可以是预编译sql语句，也可以是普通sql语句

batch-指定statement指定的预编译sql语句的一组绑定变量

sqlparam-用来指定预编译操作的sql绑定变量参数的值、数据类型、数据格式，只能内置在dbutil，sqlparams，statement,batch三个标签中。

1.1.3   属性说明

dbutil标签的属性说明如下：

 

    statement：指定要执行的sql语句，可以普通sql语句，也可以是带绑定变量的sql模板语句，必须要写的属性

    dbname：指定数据库连接池名称，可选属性，默认为poolman中配置的第一个连接池

    pretoken：指定预编译sql语句的绑定变量定义前置分界符，必须与后置分界符endtoken一起指定。可选属性，默认为#[

    endtoken：指定预编译sql语句的绑定变量定义后置分界符，必须与前置分界符pretoken一起指定。可选属性，默认为]

    action:指定sql对应数据库操作类型，包括：delete,insert,update,必填选项    

    result:指定数据库操作结果存储变量的名称，可选属性，默认值变量名称为：dbutil_result

 

sqlparams标签属性说明如下：

    pretoken：指定预编译sql语句的绑定变量定义前置分界符，必须与后置分界符endtoken一起指定。可选属性，默认为#[

    endtoken：指定预编译sql语句的绑定变量定义后置分界符，必须与前置分界符pretoken一起指定。可选属性，默认为]

    sqlparamskey:指定将参数存储在request 属性集中的变量名称，用来和pager，beaninfo，list标签设置好模板sql的绑定变量参数值

    sqlparams必须和pager，beaninfo，list标签一起使用

   

batchutil标签属性说明如下：

       dbname-批处理操作对应的数据库连接池的名称，可选属性，默认为poolman中配置的第一个连接池

       type-批处理操作类型，取值范围common,prepared,可选属性，默认值为prepared

       batchOptimize-优化预编译批处理操作控制变量

      

statement标签属性说明如下：

    sql-指定批处理的sql语句，可以使预编译sql语句和普通sql语句

    pretoken-指定预编译sql语句的绑定变量定义前置分界符，必须与后置分界符endtoken一起指定。可选属性，默认为#[

    endtoken-指定预编译sql语句的绑定变量定义后置分界符，必须与前置分界符pretoken一起指定。可选属性，默认为]

      

sqlparam 属性说明：

    name：绑定变量名称，必须和预编译sql模板中的变量名称保持一致，必选项

    value：变量值，必选项

    type：变量类型，可选项，默认值为string,对应的取值范围如下：

           bigdecimal

        boolean

        byte

byte[]

           date

           double

           float

           int

           long

           short

           string

           time

           timestamp

           blob

           clob

           blobfile

           clobfile

    dataformat：数据格式，主要用来指定日期类型(date,time,timestamp)的存储格式

 

 

特别说明：

这pretoken 、endtoken两个属性主要用来支撑在标签预编译查询功能时定义sql语句变量的语法

例如：

pretoken = "#//["

endtoken = "//]"

上面的变量值就是默认的变量分界符，开发人员可以指定自己的分界符

 

后续将要实现的功能：

增加存储过程，函数执行标签

 

1.1.4   使用实例

参考测试用例：

beaninfo:/bboss-tablib/webapp/pager/testDetailTag_prepareddb.jsp

list:/bboss-tablib/webapp/pager/testListPagertag_prepareddb.jsp

pager:/bboss-tablib/webapp/pager/testPagerTag_prepareddb.jsp

dbutil:

    新增-/bboss-tablib/webapp/pager/testPagerTag_preparedInsert.jsp

    删除-/bboss-tablib/webapp/pager/testPagerTag_preparedDeletedb.jsp

    更新-/bboss-tablib/webapp/pager/testPagerTag_preparedUpdatedb.jsp

Batchutil:

    普通批处理操作-/bboss-tablib/webapp/pager/testPagerTag_batchdb.jsp

    预编译批处理操作-/bboss-tablib/webapp/pager/testPagerTag_preparedbatchdb.jsp