26
2019.2

连贯操作

作者: POPASP
POPASP模型基础类提供的连贯操作方法,可以有效的提高数据存取的代码清晰度和开发效率,并且支持所有的CURD操作。使用也比较简单, 假如我们现在要查询一个User表的满足状态为1的前10条记录,并希望按照用户的创建时间排序 ,代码如下: ```brush:vb set rs = B_("user").where("status= true").order("addtime").top(10).select() ``` 这里的where、order和top方法T就被称之为连贯操作方法,除了select方法必须放到最后一个外(因为select方法并不是连贯操作方法),连贯操作T的方法调用顺序没有先后,例如,下面的代码和上面的等效: ```brush:vb set rs = B_("user").order("addtime").top(10).where("status= true").select() ``` 可能有些人还不太习惯使用连贯操作,但是连贯操作的好处还是显而易的。 连贯操作通常只有一个参数,并且仅在当此查询或者操作有效,完成后会自动清空连贯操作的所有传值(有个别特殊的连贯操作有多个参数,并且会记录当前的传值)。简而言之,连贯操作的结果不会带入以后的查询。 系统支持的连贯操作方法有: | 连贯操作 | 作用 | 支持的参数类型 | | -------- | ----- | ---- | | where | 用于查询、更新或者删除等条件的定义 | Integer、Long、String、Dictionary、Array(数组) | | onlySql | 是否只输出sql语句 | Number | | from | 用于定义要操作的from后面连接字符串 | String | | table | 用于定义要操作的数据表名称 | String | | data | 用于新增或者更新数据之前的数据对象赋值 | Dictionary | | field | 用于定义要查询的字段 | String、Array | | fieldRev | 用于定义要查询的排除字段 | String、Array | | order | 用于对结果排序 | String、Dictionary | | top | 用于限制查询结果数量 | Integer | | page | 用于查询分页 | Integer、Long、String、Array | | group | 用于对查询的group支持 | String | | having | 用于对查询的having支持 | String、Dictionary、Array | | leftJoin | 用于对查询的join支持 | String、Array | | union * | 用于对查询的union支持 | String | | unionAll * | 用于对查询的union all支持 | String | 所有的连贯操作都返回当前的数据库类(如POPASP_ACCESS)实例对象(Me),其中带 * 标识的表示支持多次调用。 ### onlySql onlySql 是否只输出sql语句 | 项目 | 说明 | | -------- | ----- | | 用法 | onlySql(bool) | | 参数 | 是否只要sql语句 :1或true则输出sql语句,0或false则输出查询结果 | | 返回值 | 当前实例对象 | | 备注 | 该方法只在当前调用有效,如果想查看每次查询的sql语句,则需每次调用调方法 | 用法示例: ```brush:vb dim sql,dict set dict = D_ dict("username") = "admin" dict("password") = md5("123123") sql = B_("user").onlySql(1).table("user").where(dict).find() var_export sql'var_export为sub过程,用于变量输出 '将输出sql语句 SELECT TOP 1 * FROM `user` WHERE ( username = 'admin' AND password = '4297f44b13955235245b2497399d7a93' ) ``` ### where 用于查询、更新或者删除等条件的定义 | 项目 | 说明 | | -------- | ----- | | 用法 | where(where) | | 参数 | where(必须):查询或者操作条件,Integer、String、Dictionary、Array | | 返回值 | 当前实例对象 | Where方法是使用最多的连贯操作方法,更详细的用法请参考后面的6.8 CURD操作和6.9查询语言部分。 ### table table 定义要操作的数据表名称,动态改变当前操作的数据表名称,需要写数据表的全名 | 项目 | 说明 | | -------- | ----- | | 用法 | table(tableName) | | 参数 | tableName(必须):数据表名称,String | | 返回值 | 当前实例对象 | | 备注 | 如果不调用table方法,会自动获取模型对应或者定义的数据表 | 用法示例: ```brush:vb dim rs set rs = B_("user").table("content").find() ``` 一般情况下,无需调用table方法,默认会自动获取当前模型对应或者定义的数据表。 ### from POPASP定义了leftjoin方法,没有定义inner join、right join,甚至嵌套的复杂方法,而是定义了"select * from [from]"中的from后面连接字符串的from方法。 | 项目 | 说明 | | -------- | ----- | | 用法 | from(str) | | 参数 | str(必须):数据表名称,String | | 返回值 | 当前实例对象 | | 备注 | 如果同时调用table与from,那么忽略前者,而采用from | 用法示例: ```brush:vb dim rs set rs = B_("user").from("content").find() ``` ### data data 可以用于新增或者保存数据之前的数据对象赋值 | 项目 | 说明 | | -------- | ----- | | 用法 | data(dict) | | 参数 | dict(必须):数据,Dictionary | | 返回值 | 当前实例对象 | | 备注 | 如果不调用data方法,则会取当前的Request.form数据对象或者传入add和save的数据 | 使用示例: ```brush:vb '这个示例用来添加一条记录 dim dict,id set dict = D_ '创建一个Dictionary对象 dict("meta") = "email" dict("content") = "iaspcms@163.com" dict("add_time") = now() id = B_("contact").data(dict).add '5 ``` ```brush:vb '在上面示例的基础上,修改一条记录 dim dict,result set dict = D__ '创建一个Dictionary对象 dict("content") = "iaspcms@163.com" dict("username") = "iaspcms" result = B_("contact").where(5).data(dict).save() ``` ### field field 用于定义要查询的字段 | 项目 | 说明 | | -------- | ----- | | 用法 |field(field) | | 参数 | 字段名(必须):数据支持 String、Array | | 返回值 | 当前实例对象 | | 备注 | 如果不调用field方法,则默认返回所有字段,和field(" ' ")等效 | 使用示例: ```brush:vb <% Class TestAction sub field dim rs1,rs2 set rs1 = B_("contact").field("meta,content as cont").find() var_export rs1 set rs2 = B_("contact").field( array("meta","content as cont") ).find() var_export rs2 end Sub End Class %> ``` 如果不调用field方法或者field方法传入参数为空的话,和使用field(" * ")是等效的。但是我们更建议只获取需要显式的字段名。 ### fieldRev fieldRev 用于定义要查询的排除字段 | 项目 | 说明 | | -------- | ----- | | 用法 |fieldRev(field) | | 参数 | 字段名(必须):数据支持 String、Array | | 返回值 | 当前实例对象 | | 备注 | 如果同时调用field与fieldRev,则采用后者 | 使用示例: ```brush:vb <% Class Test sub field dim rs1,rs2 set rs1 = B_("contact").field("meta,content").find() var_export rs1 set rs2 = B_("contact").field( array("meta","content") ).find() var_export rs2 end Sub End Class %> ``` ### order order 用于对操作结果排序 | 项目 | 说明 | | -------- | ----- | | 用法 | order(order) | | 参数 | 排序的字段名:数据支持 String、Dictionary | | 返回值 | 当前实例对象 | | 备注 | 如果不调用order方法,按照数据库的默认规则 | 使用示例: ```brush:vb order("id desc") order("status desc,id asc") ``` order方法的参数支持Dictionary对象,此时常用于ajax,如下: ```brush:vb <% class TestAction sub order dim rs,dict set dict = D_ dict("is_top") = "DESC" dict("post_id") = "ASC" set rs = B_("post").field("post_id,title").order(dict).select() var_export rs end sub End Class %> ``` ### top 用于定义要查询的结果限制(支持所有的数据库类型) | 项目 | 说明 | | -------- | ----- | | 用法 | top(top) | | 参数 | 限制数量:数据支持 Integer | | 返回值 | 当前实例对象 | | 备注 | 如果不调用top方法,则表示没有限制,top语句适用于access、excel、mssql(sql server)数据库,如果在sqlite3中调用该方法,相当于调用了limit | 我们知道不同的数据库类型的limit用法是不尽相同的,在Access与mssql中无limit,但是有top。 使用示例: ```brush:vb top(5) top("5") '如果字符串是数字值的也可以 set rs = B_("post").field("post_id,title").top("5").select() ``` ### limit 用于定义要查询的结果限制(支持所有的数据库类型) | 项目 | 说明 | | -------- | ----- | | 用法 | limit(limit) | | 参数 | 限制数量:数据支持 Integer,String | | 返回值 | 当前实例对象 | | 备注 | 如果不调用limit方法,则表示没有限制,limit语句适用于sqlite3、mysql数据库,如果要在access、excel、mssql(sql server)数据库中调用了该方法,相当于调用了top,而且此时参数类型只能是Integer | 使用示例: ```brush:vb sql = B_(Array("user","sqlite3","sqlite.db")).onlySql(1).field("id,username").limit("10,10").select() 'sql为 SELECT id,username FROM `User` LIMIT 10 , 10 ``` ### PAGE page 用于定义要查询的数据分页 | 项目 | 说明 | | -------- | ----- | | 用法 | page(page) | | 参数 | page(必须):数据支持 Integer、Long、String、Array | | 返回值 | 当前实例对象 | Page操作方法可以更加快速的进行分页查询。 Page方法的用法格式为: ```brush:vb Page("page[,listRows]") ``` Page表示当前的页数,listRows表示每页显示的记录数。例如: ```brush:vb Page("2,10") ``` 表示每页显示10条记录的情况下面,获取第2页的数据。 listRow如果不写的话,默认取10条。 在使用分页后,如果取当前页,只需将页数设置为null即可,如 ```brush:vb Page("null,10") ``` ### GROUP group 用于数据库的group查询支持 | 项目 | 说明 | | -------- | ----- | | 用法 | group(group) | | 参数 | 限制数量:数据支持 String | | 返回值 | 当前实例对象 | 使用示例 ```brush:vb group("is_top") ``` Group方法的参数只支持字符串 ### HAVING having 用于数据库的having查询支持 | 项目 | 说明 | | -------- | ----- | | 用法 | having(having) | | 参数 | having(必须):String | | 返回值 | 当前实例对象 | 使用示例: ```brush:vb having('user_id>0') ``` ### leftJoin leftJoin 用于数据库的left join查询支持 | 项目 | 说明 | | -------- | ----- | | 用法 | leftJoin(leftJoin) | | 参数 | leftJoin(必须):String | | 返回值 | 当前实例对象 | 使用示例: ```brush:vb class Test sub join dim rs set rs = B_("post").field("post_id,title").