org.teasoft.bee.osql

Interface BeeSql

public interface BeeSql

The interface of operating database with SQL statement directly.
The SQL string in this interface is the SQL statement that DB can recognize.
BeeSql is the underlying interface used by Bee framework, and it is not
recommended for users to use it directly.

Since:

1.0

Author:

Kingstar Create on 2013-6-30 22:05:36

Method Summary

Modifier and Type	Method and Description
int	batch(String[] sqls) Submits a batch of commands to the database.
int	batch(String[] sqls, int batchSize) Submits a batch of commands to the database.
long	insertAndReturnId(String sql) insert and return the value of primary key.
int	modify(String sql) Operate update,insert,delete.
<T> List<T>	moreTableSelect(String sql, T entity) According to SQL query more table data, data type is consistent with entity type.
List<String[]>	select(String sql) Select and transform every record to string array.
<T> List<T>	select(String sql, Class<T> entityClass) According to SQL query data, data type is consistent with entity type.
String	selectFun(String sql) Select result with function.
String	selectJson(String sql) Select and return json format result.
List<Map<String,Object>>	selectMapList(String sql) Select and transform every record to Map.
ResultSet	selectRs(String sql) select ResultSet.After using the returned ResultSet results, call HoneyContext.clearConnForSelectRs() to close the connection.
<T> List<T>	selectSomeField(String sql, Class<T> entityClass) Select some field.

Method Detail

select

<T> List<T> select(String sql,
                   Class<T> entityClass)

According to SQL query data, data type is consistent with entity type.

Parameters:

sql - SQL select statement

entityClass - The entity class corresponding to table and can not be null. (update in v2.0)

Returns:

List can contain more than one entity.

selectSomeField

<T> List<T> selectSomeField(String sql,
                            Class<T> entityClass)

Select some field.

Parameters:

sql - SQL select statement

entityClass - The entity class corresponding to table and can not be null. (update in v2.0)

Returns:

List entity which just has some field.

selectFun

String selectFun(String sql)

Select result with function. SQL function: max,min,avg,sum,count.

Parameters:

sql - SQL select statement

Returns:

The value of function statistics.
If the result set of statistics is empty,the count return 0,the other return empty string.

select

List<String[]> select(String sql)

Select and transform every record to string array.

Parameters:

sql - SQL select statement

Returns:

List, every element is string array(transform from record).

selectJson

String selectJson(String sql)

Select and return json format result.

Parameters:

sql - SQL select statement

Returns:

json format result .

modify

int modify(String sql)

Operate update,insert,delete. corresponding to Jdbc executeUpdate method.

Parameters:

sql - SQL statement to execute

Returns:

the number of affected successfully records.

insertAndReturnId

long insertAndReturnId(String sql)

insert and return the value of primary key.

Parameters:

sql - SQL statement to execute

Returns:

the value of primary key.

batch

int batch(String[] sqls)

Submits a batch of commands to the database.

Parameters:

sqls - Array of SQL statements to execute

Returns:

Affected rows.

batch

int batch(String[] sqls,
          int batchSize)

Submits a batch of commands to the database.

Parameters:

sqls - Array of SQL statements to execute

batchSize - the size of commands in a batch

Returns:

Affected rows.

moreTableSelect

<T> List<T> moreTableSelect(String sql,
                            T entity)

According to SQL query more table data, data type is consistent with entity type.

Parameters:

sql - SQL select statement

entity - The entity corresponding to table and can not be null.

Returns:

List can contain more than one entity.

Since:

1.7

selectMapList

List<Map<String,Object>> selectMapList(String sql)

Select and transform every record to Map.

Parameters:

sql - SQL select statement

Returns:

List, every element is a Map(transform from record).

Since:

1.9

selectRs

ResultSet selectRs(String sql)

select ResultSet.After using the returned ResultSet results, call HoneyContext.clearConnForSelectRs() to close the connection.

Parameters:

sql - SQL select statement

Returns:

ResultSet