org.teasoft.bee.osql

接口 PreparedSql

public interface PreparedSql

支持带占位符的sql操作.sql语句是DB能识别的SQL,非面向对象的sql.Support sql string with placeholder.The sql statement is really DB's grammar,not object oriented type. 若是简单的操作,建议用面向对象的操作方式,ObjSQL和ObjSQLRich. 若没有用占位符(?),则传入空数组或Map即可.

从以下版本开始:

1.0 支持如name=#{name},name like #{name%}的map参数形式, 1.2

作者:

Kingstar

方法概要

方法

限定符和类型	方法和说明
int	modify(String sqlStr, Map<String,Object> map) 已过时。 不建议使用,因为框架不知道具体是更改了什么表,会影响缓存的正确性,从而产生缓存数据不准确的危险
int	modify(String sql, Object[] preValues) 已过时。 不建议使用,因为框架不知道具体是更改了什么表,会影响缓存的正确性,从而产生缓存数据不准确的危险
List<String[]>	select(String sqlStr, Map<String,Object> map) 查询并将每一行结果转成String数组.select and transform every record to string array.
List<String[]>	select(String sqlStr, Map<String,Object> map, int start, int size)
List<String[]>	select(String sql, Object[] preValues) 查询并将每一行结果转成String数组.select and transform every record to string array.
List<String[]>	select(String sql, Object[] preValues, int start, int size)
<T> List<T>	select(String sqlStr, T entity, Map<String,Object> parameterMap) 通过变量的占位语句查询数据.entity和map都可以向参数传递值,map可以作为entity的补充,用于传递范围查询等复杂查询的参数.
<T> List<T>	select(String sqlStr, T entity, Map<String,Object> parameterMap, int start, int size)
<T> List<T>	select(String sql, T returnType, Object[] preValues) 通过问号的占位语句查询数据 eg: select * from orders where userid=?
<T> List<T>	select(String sql, T returnType, Object[] preValues, int start, int size)
String	selectFun(String sqlStr, Map<String,Object> map) 用函数查询结果.select result with function.
String	selectFun(String sql, Object[] preValues) 用函数查询结果.select result with function.
String	selectJson(String sqlStr, Map<String,Object> map) 查询结果,并以json格式返回.select and return json format result.
String	selectJson(String sqlStr, Map<String,Object> map, int start, int size) 查询结果,并以json格式返回.select and return json format result.
String	selectJson(String sql, Object[] preValues) 查询结果,并以json格式返回.select and return json format result.
String	selectJson(String sql, Object[] preValues, int start, int size) 查询结果,并以json格式返回.select and return json format result.
<T> List<T>	selectSomeField(String sqlStr, T entity, Map<String,Object> parameterMap) 通过变量的占位语句查询数据(只查询部分字段).entity和map都可以向参数传递值,map可以作为entity的补充,用于传递范围查询等复杂查询的参数.
<T> List<T>	selectSomeField(String sqlStr, T entity, Map<String,Object> parameterMap, int start, int size)
<T> List<T>	selectSomeField(String sql, T returnType, Object[] preValues) 通过问号的占位语句查询数据(只查询部分字段) eg: select * from orders where userid=?
<T> List<T>	selectSomeField(String sql, T returnType, Object[] preValues, int start, int size)

方法详细资料

select

<T> List<T> select(String sql,
                 T returnType,
                 Object[] preValues)

通过问号的占位语句查询数据 eg: select * from orders where userid=?

参数:

sql - 直接用?作为占位符的sql查询语句.

returnType - 返回entity的类型.

preValues - 按下标顺序给sql的占位符设值的Object数组.

返回:

返回returnType类型的实体List.

select

<T> List<T> select(String sql,
                 T returnType,
                 Object[] preValues,
                 int start,
                 int size)

select

<T> List<T> select(String sqlStr,
                 T entity,
                 Map<String,Object> parameterMap)

通过变量的占位语句查询数据.entity和map都可以向参数传递值,map可以作为entity的补充,用于传递范围查询等复杂查询的参数. eg:select * from orders where userid=#{userid} eg:select * from orders where name like #{name%}

参数:

sqlStr - 使用#{para}作为占位符的sql查询语句.

entity - entity中非null的值,会转换成map的元素作为参数,entity的字段会自动转成表的列名.

parameterMap - map结构的参数,通过map的key与sqlStr中变量名对应. 若map有元素的key与从entity转来的一样,会使用map的.

返回:

返回与entity类型一样的实体List.

select

<T> List<T> select(String sqlStr,
                 T entity,
                 Map<String,Object> parameterMap,
                 int start,
                 int size)

selectSomeField

<T> List<T> selectSomeField(String sql,
                          T returnType,
                          Object[] preValues)

通过问号的占位语句查询数据(只查询部分字段) eg: select * from orders where userid=?

参数:

sql - 直接用?作为占位符的sql查询语句.

returnType - 返回entity的类型.

preValues - 按下标顺序给sql的占位符设值的Object数组.

返回:

返回returnType类型的实体List.

selectSomeField

<T> List<T> selectSomeField(String sql,
                          T returnType,
                          Object[] preValues,
                          int start,
                          int size)

selectSomeField

<T> List<T> selectSomeField(String sqlStr,
                          T entity,
                          Map<String,Object> parameterMap)

通过变量的占位语句查询数据(只查询部分字段).entity和map都可以向参数传递值,map可以作为entity的补充,用于传递范围查询等复杂查询的参数. eg:select * from orders where userid=#{userid} eg:select * from orders where name like #{name%}

参数:

sqlStr - 使用#{para}作为占位符的sql查询语句.

entity - entity中非null的值,会转换成map的元素作为参数,entity的字段会自动转成表的列名.

parameterMap - map结构的参数,通过map的key与sqlStr中变量名对应. 若map有元素的key与从entity转来的一样,会使用map的.

返回:

返回与entity类型一样的实体List.

selectSomeField

<T> List<T> selectSomeField(String sqlStr,
                          T entity,
                          Map<String,Object> parameterMap,
                          int start,
                          int size)

selectFun

String selectFun(String sql,
               Object[] preValues)
                 throws ObjSQLException

用函数查询结果.select result with function. SQL function: max,min,avg,sum,count. 注意:因没有与entity关联,没有应用上缓存. Notice:can not use the cache because don't relay the entity.

参数:

sql - SQL select statement

preValues - 按下标顺序给sql的占位符设值的Object数组.

返回:

返回函数统计的值.如果统计的结果集为空,除了count返回0,其它都返回空字符.

抛出:

ObjSQLException

selectFun

String selectFun(String sqlStr,
               Map<String,Object> map)
                 throws ObjSQLException

用函数查询结果.select result with function. SQL function: max,min,avg,sum,count. 注意:因没有与entity关联,没有应用上缓存. Notice:can not use the cache because don't relay the entity.

参数:

sql - SQL select statement

map - map结构的参数,通过map的key与sqlStr中变量名对应.

返回:

返回函数统计的值.如果统计的结果集为空,除了count返回0,其它都返回空字符.

抛出:

ObjSQLException

select

List<String[]> select(String sql,
                    Object[] preValues)

查询并将每一行结果转成String数组.select and transform every record to string array. 注意:因没有与entity关联,没有应用上缓存. Notice:can not use the cache because don't relay the entity.

参数:

sql - SQL select statement

preValues - parameter values for placeholder

返回:

List,每个元素是一行记录转换成的string数组. List, every element is string array(transform from record).

select

List<String[]> select(String sql,
                    Object[] preValues,
                    int start,
                    int size)

select

List<String[]> select(String sqlStr,
                    Map<String,Object> map)

查询并将每一行结果转成String数组.select and transform every record to string array. 注意:因没有与entity关联,没有应用上缓存. Notice:can not use the cache because don't relay the entity.

参数:

sql - SQL select statement

map - parameter values for placeholder

返回:

List,每个元素是一行记录转换成的string数组. List, every element is string array(transform from record).

select

List<String[]> select(String sqlStr,
                    Map<String,Object> map,
                    int start,
                    int size)

selectJson

String selectJson(String sql,
                Object[] preValues)

查询结果,并以json格式返回.select and return json format result. 注意:因没有与entity关联,没有应用上缓存. Notice:can not use the cache because don't relay the entity.

参数:

sql - SQL select statement

preValues - 占位符对应的参数数组.parameter values for placeholder

返回:

返回json格式结果集.json format result .

selectJson

String selectJson(String sql,
                Object[] preValues,
                int start,
                int size)

查询结果,并以json格式返回.select and return json format result. 注意:因没有与entity关联,没有应用上缓存. Notice:can not use the cache because don't relay the entity.

参数:

sql - SQL select statement

preValues - 占位符对应的参数数组.parameter values for placeholder

start - 开始下标(从0或1开始,eg:MySQL是0,Oracle是1). start index,min value is 0 or 1(eg:MySQL is 0,Oracle is 1).

size - 结果集大小 大于等于1. fetch result size (>0).

返回:

返回json格式结果集.json format result .

selectJson

String selectJson(String sqlStr,
                Map<String,Object> map)

查询结果,并以json格式返回.select and return json format result. 注意:因没有与entity关联,没有应用上缓存. Notice:can not use the cache because don't relay the entity.

参数:

sql - SQL select statement

map - 占位符对应的参数map.parameter values for placeholder

返回:

返回json格式结果集.json format result .

selectJson

String selectJson(String sqlStr,
                Map<String,Object> map,
                int start,
                int size)

查询结果,并以json格式返回.select and return json format result. 注意:因没有与entity关联,没有应用上缓存. Notice:can not use the cache because don't relay the entity.

参数:

sqlStr - SQL select statement

map - 占位符对应的参数map.parameter values for placeholder

start - 开始下标(从0或1开始,eg:MySQL是0,Oracle是1). start index,min value is 0 or 1(eg:MySQL is 0,Oracle is 1).

size - 结果集大小 大于等于1. fetch result size (>0).

返回:

返回json格式结果集.json format result .

modify

@Deprecated
int modify(String sql,
                    Object[] preValues)

已过时。 不建议使用,因为框架不知道具体是更改了什么表,会影响缓存的正确性,从而产生缓存数据不准确的危险

操作update,insert,delete

参数:

sql - SQL select statement

preValues - 占位符对应的参数数组.parameter values for placeholder

返回:

返回成功操作的记录行数. the number of successful records.

modify

@Deprecated
int modify(String sqlStr,
                    Map<String,Object> map)

已过时。 不建议使用,因为框架不知道具体是更改了什么表,会影响缓存的正确性,从而产生缓存数据不准确的危险

操作update,insert,delete

参数:

sql - SQL select statement

map - 占位符对应的参数map.parameter values for placeholder

返回:

返回成功操作的记录行数. the number of successful records.