com.litongjava.db.activerecord

类 Db

java.lang.Object

com.litongjava.db.activerecord.Db

public class Db
extends Object

Db. Powerful database query and update tool box.

构造器概要

构造器

构造器和说明
Db()

方法概要

限定符和类型	方法和说明
static int[]	batch(List<String> sqlList, int batchSize)
static int[]	batch(String sql, Object[][] paras, int batchSize)
static int[]	batch(String sql, String columns, List modelOrRecordList, int batchSize)
static int[]	batchDelete(String tableName, List<? extends Record> recordList, int batchSize)
static int[]	batchSave(List<? extends Model> modelList, int batchSize)
static int[]	batchSave(String tableName, List<? extends Record> recordList, int batchSize)
static int[]	batchUpdate(List<? extends Model> modelList, int batchSize)
static int[]	batchUpdate(String tableName, List<? extends Record> recordList, int batchSize)
static int[]	batchUpdate(String tableName, String primaryKey, List<? extends Record> recordList, int batchSize)
static Long	count(String sql)
static Long	countTable(String table)
static int	delete(String sql)
static int	delete(String sql, Object... paras) Execute delete sql statement.
static boolean	delete(String tableName, Record record)
static boolean	delete(String tableName, String primaryKey, Record record) Delete record.
static boolean	deleteById(String tableName, Object idValue) Delete record by id with default primary key.
static boolean	deleteById(String tableName, String primaryKey, Object idValue)
static boolean	deleteByIds(String tableName, Record record) Example: boolean succeed = Db.delete("user", user);
static boolean	deleteByIds(String tableName, String primaryKey, Object... idValues) Delete record by ids.
static void	each(java.util.function.Function<Record,Boolean> func, String sql, Object... paras) 迭代处理每一个查询出来的 Record 对象 例子： Db.each(record -> { // 处理 record 的代码在此 // 返回 true 继续循环处理下一条数据，返回 false 立即终止循环 return true; }, sql, paras);
static Object	execute(ICallback callback)
static boolean	exists(String tableName, String fields, Object... paras)
static boolean	existsBySql(String sql, Object... paras)
static <T> List<T>	find(Class<T> clazz, SqlPara sqlPara)
static <T> List<T>	find(Class<T> clazz, String sql)
static <T> List<T>	find(Class<T> clazz, String sql, Object... paras)
static List<Record>	find(SqlPara sqlPara)
static List<Record>	find(String sql)
static List<Record>	find(String sql, Object... paras)
static <T> List<T>	findAll(Class<T> clazz, String tableName)
static List<Record>	findAll(String tableName)
static <T> List<T>	findByCache(Class<T> clazz, String cacheName, Object key, String sql)
static <T> List<T>	findByCache(Class<T> clazz, String cacheName, Object key, String sql, Object... paras)
static List<Record>	findByCache(String cacheName, Object key, String sql)
static List<Record>	findByCache(String cacheName, Object key, String sql, Object... paras) Find Record by cache.
static List<Record>	findByColumn(String tableName, String column, String value)
static <T> T	findById(Class<T> clazz, String tableName, Object idValue)
static <T> T	findById(Class<T> clazz, String tableName, String primaryKey, Object idValue)
static Record	findById(String tableName, Object idValue) Find record by id with default primary key.
static Record	findById(String tableName, String primaryKey, Object idValue)
static <T> T	findByIds(Class<T> clazz, String tableName, String primaryKey, Object... idValues)
static Record	findByIds(String tableName, String primaryKey, Object... idValues) Find record by ids.
static <T> List<T>	findColumnsAll(Class<T> clazz, String tableName, String columns)
static List<Record>	findColumnsAll(String tableName, String columns)
static <T> T	findColumnsById(Class<T> clazz, String tableName, String columns, Object idValue)
static Record	findColumnsById(String tableName, String columns, int idValue)
static <T> T	findColumnsByIds(Class<T> clazz, String tableName, String columns, String primaryKey, Object... idValues)
static Record	findColumnsByIds(String tableName, String columns, String primaryKey, Object... idValues)
static <T> T	findFirst(Class<T> clazz, SqlPara sqlPara)
static <T> T	findFirst(Class<T> clazz, String sql)
static <T> T	findFirst(Class<T> clazz, String sql, Object... paras)
static Record	findFirst(SqlPara sqlPara)
static Record	findFirst(String sql)
static Record	findFirst(String sql, Object... paras) Find first record.
static <T> T	findFirstByCache(Class<T> clazz, String cacheName, Object key, String sql)
static <T> T	findFirstByCache(Class<T> clazz, String cacheName, Object key, String sql, Object... paras)
static Record	findFirstByCache(String cacheName, Object key, String sql)
static Record	findFirstByCache(String cacheName, Object key, String sql, Object... paras) Find first record by cache.
static List<Record>	findWithJsonField(String sql, String[] jsonFields, Object... paras)
static String	getSql(String key)
static SqlPara	getSqlPara(String key, Map data)
static SqlPara	getSqlPara(String key, Model model)
static SqlPara	getSqlPara(String key, Object... paras)
static SqlPara	getSqlPara(String key, Record record)
static SqlPara	getSqlParaByString(String content, Map data)
static SqlPara	getSqlParaByString(String content, Object... paras)
static void	initReplicas(List<Config> replicaConfigs)
static <T> Page<T>	paginate(Class<T> clazz, int pageNumber, int pageSize, boolean isGroupBySql, SqlPara sqlPara)
static <T> Page<T>	paginate(Class<T> clazz, int pageNumber, int pageSize, boolean isGroupBySql, String select, String sqlExceptSelect)
static <T> Page<T>	paginate(Class<T> clazz, int pageNumber, int pageSize, boolean isGroupBySql, String select, String sqlExceptSelect, Object... paras)
static <T> Page<T>	paginate(Class<T> clazz, int pageNumber, int pageSize, SqlPara sqlPara)
static <T> Page<T>	paginate(Class<T> clazz, int pageNumber, int pageSize, String select, String sqlExceptSelect)
static <T> Page<T>	paginate(Class<T> clazz, int pageNumber, int pageSize, String select, String sqlExceptSelect, Object... paras)
static Page<Record>	paginate(int pageNumber, int pageSize, boolean isGroupBySql, SqlPara sqlPara)
static Page<Record>	paginate(int pageNumber, int pageSize, boolean isGroupBySql, String select, String sqlExceptSelect)
static Page<Record>	paginate(int pageNumber, int pageSize, boolean isGroupBySql, String select, String sqlExceptSelect, Object... paras)
static Page<Record>	paginate(int pageNumber, int pageSize, SqlPara sqlPara)
static Page<Record>	paginate(int pageNumber, int pageSize, String select, String sqlExceptSelect)
static Page<Record>	paginate(int pageNumber, int pageSize, String select, String sqlExceptSelect, Object... paras) Paginate.
static <T> Page<T>	paginateByCache(Class<T> clazz, String cacheName, Object key, int pageNumber, int pageSize, boolean isGroupBySql, SqlPara sqlPara)
static <T> Page<T>	paginateByCache(Class<T> clazz, String cacheName, Object key, int pageNumber, int pageSize, boolean isGroupBySql, String select, String sqlExceptSelect)
static <T> Page<T>	paginateByCache(Class<T> clazz, String cacheName, Object key, int pageNumber, int pageSize, boolean isGroupBySql, String select, String sqlExceptSelect, Object... paras)
static <T> Page<T>	paginateByCache(Class<T> clazz, String cacheName, Object key, int pageNumber, int pageSize, SqlPara sqlPara)
static <T> Page<T>	paginateByCache(Class<T> clazz, String cacheName, Object key, int pageNumber, int pageSize, String select, String sqlExceptSelect)
static <T> Page<T>	paginateByCache(Class<T> clazz, String cacheName, Object key, int pageNumber, int pageSize, String select, String sqlExceptSelect, Object... paras)
static Page<Record>	paginateByCache(String cacheName, Object key, int pageNumber, int pageSize, boolean isGroupBySql, SqlPara sqlPara)
static Page<Record>	paginateByCache(String cacheName, Object key, int pageNumber, int pageSize, boolean isGroupBySql, String select, String sqlExceptSelect)
static Page<Record>	paginateByCache(String cacheName, Object key, int pageNumber, int pageSize, boolean isGroupBySql, String select, String sqlExceptSelect, Object... paras)
static Page<Record>	paginateByCache(String cacheName, Object key, int pageNumber, int pageSize, SqlPara sqlPara)
static Page<Record>	paginateByCache(String cacheName, Object key, int pageNumber, int pageSize, String select, String sqlExceptSelect)
static Page<Record>	paginateByCache(String cacheName, Object key, int pageNumber, int pageSize, String select, String sqlExceptSelect, Object... paras) Paginate by cache.
static <T> Page<T>	paginateByCacheByFullSql(Class<T> clazz, String cacheName, Object cacheKey, int pageNumber, int pageSize, boolean isGroupBySql, String totalRowSql, String findSql, Object... paras)
static <T> Page<T>	paginateByCacheByFullSql(Class<T> clazz, String cacheName, Object cacheKey, int pageNumber, int pageSize, String totalRowSql, String findSql, Object... paras)
static Page<Record>	paginateByCacheByFullSql(String cacheName, Object key, int pageNumber, int pageSize, boolean isGroupBySql, String totalRowSql, String findSql, Object... paras)
static Page<Record>	paginateByCacheByFullSql(String cacheName, Object key, int pageNumber, int pageSize, String totalRowSql, String findSql, Object... paras)
static <T> Page<T>	paginateByFullSql(Class<T> clazz, int pageNumber, int pageSize, boolean isGroupBySql, String totalRowSql, String findSql, Object... paras)
static <T> Page<T>	paginateByFullSql(Class<T> clazz, int pageNumber, int pageSize, String totalRowSql, String findSql, Object... paras)
static Page<Record>	paginateByFullSql(int pageNumber, int pageSize, boolean isGroupBySql, String totalRowSql, String findSql, Object... paras)
static Page<Record>	paginateByFullSql(int pageNumber, int pageSize, String totalRowSql, String findSql, Object... paras)
static <T> List<T>	query(String sql)
static <T> List<T>	query(String sql, Object... paras)
static BigDecimal	queryBigDecimal(String sql)
static BigDecimal	queryBigDecimal(String sql, Object... paras)
static BigInteger	queryBigInteger(String sql)
static BigInteger	queryBigInteger(String sql, Object... paras)
static Boolean	queryBoolean(String sql)
static Boolean	queryBoolean(String sql, Object... paras)
static Byte	queryByte(String sql)
static Byte	queryByte(String sql, Object... paras)
static byte[]	queryBytes(String sql)
static byte[]	queryBytes(String sql, Object... paras)
static <T> T	queryColumn(String sql)
static <T> T	queryColumn(String sql, Object... paras) Execute sql query just return one column.
static Date	queryDate(String sql)
static Date	queryDate(String sql, Object... paras)
static Double	queryDouble(String sql)
static Double	queryDouble(String sql, Object... paras)
static <T> T	queryFirst(String sql)
static <T> T	queryFirst(String sql, Object... paras) Execute sql query and return the first result.
static Float	queryFloat(String sql)
static Float	queryFloat(String sql, Object... paras)
static Integer	queryInt(String sql)
static Integer	queryInt(String sql, Object... paras)
static List<String>	queryListString(String sql)
static List<String>	queryListString(String sql, Object... params)
static java.time.LocalDateTime	queryLocalDateTime(String sql)
static java.time.LocalDateTime	queryLocalDateTime(String sql, Object... paras)
static Long	queryLong(String sql)
static Long	queryLong(String sql, Object... paras)
static Number	queryNumber(String sql)
static Number	queryNumber(String sql, Object... paras)
static Short	queryShort(String sql)
static Short	queryShort(String sql, Object... paras)
static String	queryStr(String sql)
static String	queryStr(String sql, Object... paras)
static Time	queryTime(String sql)
static Time	queryTime(String sql, Object... paras)
static Timestamp	queryTimestamp(String sql)
static Timestamp	queryTimestamp(String sql, Object... paras)
static boolean	save(Record r)
static boolean	save(String tableName, Record record)
static boolean	save(String tableName, Record record, String[] jsonFields)
static boolean	save(String tableName, String primaryKey, Record record) Save record.
static boolean	save(String tableName, String primaryKey, Record record, String[] jsonFields)
static DbTemplate	template(String key, Map data) 使用 sql 模板进行查询，可以省去 Db.getSqlPara(...)
static DbTemplate	template(String key, Object... paras) 使用 sql 模板进行查询，可以省去 Db.getSqlPara(...)
static DbTemplate	templateByString(String content, Map data) 使用字符串变量作为 sql 模板进行查询，可省去外部 sql 文件来使用 sql 模板功能 例子： String sql = "select * from blog where id = #para(id)"; Db.templateByString(sql, Kv.by("id", 123).find();
static DbTemplate	templateByString(String content, Object... paras) 使用字符串变量作为 sql 模板进行查询，可省去外部 sql 文件来使用 sql 模板功能 例子： String sql = "select * from blog where id = #para(0)"; Db.templateByString(sql, 123).find();
static boolean	tx(IAtom atom) Execute transaction with default transaction level.
static boolean	tx(int transactionLevel, IAtom atom)
static Future<Boolean>	txInNewThread(IAtom atom) 主要用于嵌套事务场景 实例：https://jfinal.com/feedback/4008 默认情况下嵌套事务会被合并成为一个事务，那么内层与外层任何地方回滚事务 所有嵌套层都将回滚事务，也就是说嵌套事务无法独立提交与回滚 使用 txInNewThread(...)
static Future<Boolean>	txInNewThread(int transactionLevel, IAtom atom)
static int	update(Config config, Connection conn, String sql, Object... paras) Execute sql update
static int	update(SqlPara sqlPara)
static int	update(String sql)
static boolean	update(String tableName, Record record) Update record with default primary key.
static boolean	update(String tableName, String primaryKey, Record record) Update Record.
static boolean	update(String tableName, String primaryKey, Record record, String[] jsonFields)
static int	updateBySql(String sql, Object... paras) Execute update, insert or delete sql statement.
static DbPro	use()
static DbPro	use(String configName)
static DbPro	useReplica()
static DbPro	useReplica(int i)
static DbPro	useReplica(String configName)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Db

public Db()

方法详细资料

initReplicas

public static void initReplicas(List<Config> replicaConfigs)

use

public static DbPro use(String configName)

use

public static DbPro use()

useReplica

public static DbPro useReplica(String configName)

useReplica

public static DbPro useReplica()

useReplica

public static DbPro useReplica(int i)

save

public static boolean save(Record r)

save

public static boolean save(String tableName,
                           String primaryKey,
                           Record record)

Save record.

 Example:
 Record userRole = new Record().set("user_id", 123).set("role_id", 456);
 Db.save("user_role", "user_id, role_id", userRole);
 

参数:

tableName - the table name of the table

primaryKey - the primary key of the table, composite primary key is separated by comma character: ","

record - the record will be saved

true - if save succeed otherwise false

save

public static boolean save(String tableName,
                           Record record)

另请参阅:

save(String, String, Record)

save

public static boolean save(String tableName,
                           Record record,
                           String[] jsonFields)

参数:

tableName -

record -

jsonFields -

返回:

save

public static boolean save(String tableName,
                           String primaryKey,
                           Record record,
                           String[] jsonFields)

update

public static int update(Config config,
                         Connection conn,
                         String sql,
                         Object... paras)
                  throws SQLException

Execute sql update

抛出:

SQLException

update

public static int update(SqlPara sqlPara)

参数:

sqlPara -

返回:

updateBySql

public static int updateBySql(String sql,
                              Object... paras)

Execute update, insert or delete sql statement.

参数:

sql - an SQL statement that may contain one or more '?' IN parameter placeholders

paras - the parameters of sql

返回:

either the row count for INSERT, UPDATE, or DELETE statements, or 0 for SQL statements that return nothing

update

public static int update(String sql)

参数:

sql - an SQL statement

另请参阅:

#update(String, Object...)

update

public static boolean update(String tableName,
                             String primaryKey,
                             Record record)

Update Record.

 Example: Db.update("user_role", "user_id, role_id", record);
 

参数:

tableName - the table name of the Record save to

primaryKey - the primary key of the table, composite primary key is separated by comma character: ","

record - the Record object

true - if update succeed otherwise false

update

public static boolean update(String tableName,
                             String primaryKey,
                             Record record,
                             String[] jsonFields)

参数:

tableName -

primaryKey -

record -

返回:

update

public static boolean update(String tableName,
                             Record record)

Update record with default primary key.

 Example: Db.update("user", record);
 

另请参阅:

update(String, String, Record)

deleteById

public static boolean deleteById(String tableName,
                                 Object idValue)

Delete record by id with default primary key.

 Example: Db.deleteById("user", 15);
 

参数:

tableName - the table name of the table

idValue - the id value of the record

返回:

true if delete succeed otherwise false

deleteById

public static boolean deleteById(String tableName,
                                 String primaryKey,
                                 Object idValue)

参数:

tableName -

primaryKey -

idValue -

返回:

deleteByIds

public static boolean deleteByIds(String tableName,
                                  String primaryKey,
                                  Object... idValues)

Delete record by ids.

 Example: Db.deleteByIds("user", "user_id", 15);
 Db.deleteByIds("user_role", "user_id, role_id", 123, 456);
 

参数:

tableName - the table name of the table

primaryKey - the primary key of the table, composite primary key is separated by comma character: ","

idValues - the id value of the record, it can be composite id values

返回:

true if delete succeed otherwise false

delete

public static boolean delete(String tableName,
                             String primaryKey,
                             Record record)

Delete record.

 Example:
 boolean succeed = Db.delete("user", "id", user);
 

参数:

tableName - the table name of the table

primaryKey - the primary key of the table, composite primary key is separated by comma character: ","

record - the record

返回:

true if delete succeed otherwise false

deleteByIds

public static boolean deleteByIds(String tableName,
                                  Record record)

 Example:
 boolean succeed = Db.delete("user", user);
 

另请参阅:

delete(String, String, Record)

delete

public static boolean delete(String tableName,
                             Record record)

delete

public static int delete(String sql,
                         Object... paras)

Execute delete sql statement.

参数:

sql - an SQL statement that may contain one or more '?' IN parameter placeholders

paras - the parameters of sql

返回:

the row count for DELETE statements, or 0 for SQL statements that return nothing

delete

public static int delete(String sql)

参数:

sql - an SQL statement

另请参阅:

delete(String, Object...)

query

public static <T> List<T> query(String sql,
                                Object... paras)

另请参阅:

#query(String, String, Object...)

query

public static <T> List<T> query(String sql)

参数:

sql - an SQL statement

另请参阅:

query(String, Object...)

queryFirst

public static <T> T queryFirst(String sql,
                               Object... paras)

Execute sql query and return the first result. I recommend add "limit 1" in your sql.

参数:

sql - an SQL statement that may contain one or more '?' IN parameter placeholders

paras - the parameters of sql

返回:

Object[] if your sql has select more than one column, and it return Object if your sql has select only one column.

queryFirst

public static <T> T queryFirst(String sql)

参数:

sql - an SQL statement

另请参阅:

queryFirst(String, Object...)

queryColumn

public static <T> T queryColumn(String sql,
                                Object... paras)

Execute sql query just return one column.

类型参数:

T - the type of the column that in your sql's select statement

参数:

sql - an SQL statement that may contain one or more '?' IN parameter placeholders

paras - the parameters of sql

返回:

T

queryColumn

public static <T> T queryColumn(String sql)

queryStr

public static String queryStr(String sql,
                              Object... paras)

queryStr

public static String queryStr(String sql)

queryInt

public static Integer queryInt(String sql,
                               Object... paras)

queryInt

public static Integer queryInt(String sql)

queryLong

public static Long queryLong(String sql,
                             Object... paras)

queryLong

public static Long queryLong(String sql)

queryDouble

public static Double queryDouble(String sql,
                                 Object... paras)

queryDouble

public static Double queryDouble(String sql)

queryFloat

public static Float queryFloat(String sql,
                               Object... paras)

queryFloat

public static Float queryFloat(String sql)

queryBigDecimal

public static BigDecimal queryBigDecimal(String sql,
                                         Object... paras)

queryBigDecimal

public static BigDecimal queryBigDecimal(String sql)

queryBigInteger

public static BigInteger queryBigInteger(String sql,
                                         Object... paras)

queryBigInteger

public static BigInteger queryBigInteger(String sql)

queryBytes

public static byte[] queryBytes(String sql,
                                Object... paras)

queryBytes

public static byte[] queryBytes(String sql)

queryDate

public static Date queryDate(String sql,
                             Object... paras)

queryDate

public static Date queryDate(String sql)

queryLocalDateTime

public static java.time.LocalDateTime queryLocalDateTime(String sql,
                                                         Object... paras)

queryLocalDateTime

public static java.time.LocalDateTime queryLocalDateTime(String sql)

queryTime

public static Time queryTime(String sql,
                             Object... paras)

queryTime

public static Time queryTime(String sql)

queryTimestamp

public static Timestamp queryTimestamp(String sql,
                                       Object... paras)

queryTimestamp

public static Timestamp queryTimestamp(String sql)

queryBoolean

public static Boolean queryBoolean(String sql,
                                   Object... paras)

queryBoolean

public static Boolean queryBoolean(String sql)

queryShort

public static Short queryShort(String sql,
                               Object... paras)

queryShort

public static Short queryShort(String sql)

queryByte

public static Byte queryByte(String sql,
                             Object... paras)

queryByte

public static Byte queryByte(String sql)

queryNumber

public static Number queryNumber(String sql,
                                 Object... paras)

queryNumber

public static Number queryNumber(String sql)

find

public static List<Record> find(String sql)

参数:

sql - the sql statement

返回:

find

public static <T> List<T> find(Class<T> clazz,
                               String sql)

类型参数:

T -

参数:

clazz -

sql -

返回:

find

public static List<Record> find(String sql,
                                Object... paras)

参数:

sql -

paras -

返回:

findWithJsonField

public static List<Record> findWithJsonField(String sql,
                                             String[] jsonFields,
                                             Object... paras)

find

public static <T> List<T> find(Class<T> clazz,
                               String sql,
                               Object... paras)

类型参数:

T -

参数:

clazz -

sql -

paras -

返回:

findAll

public static List<Record> findAll(String tableName)

参数:

tableName -

返回:

findAll

public static <T> List<T> findAll(Class<T> clazz,
                                  String tableName)

类型参数:

T -

参数:

clazz -

tableName -

返回:

findColumnsAll

public static List<Record> findColumnsAll(String tableName,
                                          String columns)

参数:

tableName -

columns -

返回:

findColumnsAll

public static <T> List<T> findColumnsAll(Class<T> clazz,
                                         String tableName,
                                         String columns)

类型参数:

T -

参数:

clazz -

tableName -

columns -

返回:

findFirst

public static Record findFirst(String sql,
                               Object... paras)

Find first record. I recommend add "limit 1" in your sql.

参数:

sql - an SQL statement that may contain one or more '?' IN parameter placeholders

paras - the parameters of sql

返回:

the Record object

findFirst

public static <T> T findFirst(Class<T> clazz,
                              String sql,
                              Object... paras)

类型参数:

T -

参数:

clazz -

sql -

paras -

返回:

findFirst

public static Record findFirst(String sql)

参数:

sql - an SQL statement

另请参阅:

findFirst(String, Object...)

findFirst

public static <T> T findFirst(Class<T> clazz,
                              String sql)

类型参数:

T -

参数:

clazz -

sql -

返回:

findById

public static Record findById(String tableName,
                              Object idValue)

Find record by id with default primary key.

 Example:
 Record user = Db.findById("user", 15);
 

参数:

tableName - the table name of the table

idValue - the id value of the record

findById

public static <T> T findById(Class<T> clazz,
                             String tableName,
                             Object idValue)

类型参数:

T -

参数:

clazz -

tableName -

idValue -

返回:

findColumnsById

public static <T> T findColumnsById(Class<T> clazz,
                                    String tableName,
                                    String columns,
                                    Object idValue)

类型参数:

T -

参数:

clazz -

tableName -

columns -

idValue -

返回:

findColumnsById

public static Record findColumnsById(String tableName,
                                     String columns,
                                     int idValue)

参数:

tableName -

columns -

idValue -

返回:

findById

public static Record findById(String tableName,
                              String primaryKey,
                              Object idValue)

参数:

tableName -

primaryKey -

idValue -

返回:

findById

public static <T> T findById(Class<T> clazz,
                             String tableName,
                             String primaryKey,
                             Object idValue)

类型参数:

T -

参数:

clazz -

tableName -

primaryKey -

idValue -

返回:

findByIds

public static Record findByIds(String tableName,
                               String primaryKey,
                               Object... idValues)

Find record by ids.

 Example:
 Record user = Db.findByIds("user", "user_id", 123);
 Record userRole = Db.findByIds("user_role", "user_id, role_id", 123, 456);
 

参数:

tableName - the table name of the table

primaryKey - the primary key of the table, composite primary key is separated by comma character: ","

idValues - the id value of the record, it can be composite id values

findByIds

public static <T> T findByIds(Class<T> clazz,
                              String tableName,
                              String primaryKey,
                              Object... idValues)

findColumnsByIds

public static Record findColumnsByIds(String tableName,
                                      String columns,
                                      String primaryKey,
                                      Object... idValues)

参数:

tableName -

columns -

primaryKey -

idValues -

返回:

findColumnsByIds

public static <T> T findColumnsByIds(Class<T> clazz,
                                     String tableName,
                                     String columns,
                                     String primaryKey,
                                     Object... idValues)

类型参数:

T -

参数:

clazz -

tableName -

columns -

primaryKey -

idValues -

返回:

findByColumn

public static List<Record> findByColumn(String tableName,
                                        String column,
                                        String value)

paginate

public static Page<Record> paginate(int pageNumber,
                                    int pageSize,
                                    SqlPara sqlPara)

参数:

pageNumber -

pageSize -

sqlPara -

返回:

paginate

public static Page<Record> paginate(int pageNumber,
                                    int pageSize,
                                    boolean isGroupBySql,
                                    SqlPara sqlPara)

参数:

pageNumber -

pageSize -

isGroupBySql -

sqlPara -

返回:

paginate

public static Page<Record> paginate(int pageNumber,
                                    int pageSize,
                                    String select,
                                    String sqlExceptSelect)

参数:

pageNumber -

pageSize -

select -

sqlExceptSelect -

返回:

paginate

public static Page<Record> paginate(int pageNumber,
                                    int pageSize,
                                    boolean isGroupBySql,
                                    String select,
                                    String sqlExceptSelect)

参数:

pageNumber -

pageSize -

isGroupBySql -

select -

sqlExceptSelect -

返回:

paginate

public static Page<Record> paginate(int pageNumber,
                                    int pageSize,
                                    String select,
                                    String sqlExceptSelect,
                                    Object... paras)

Paginate.

参数:

pageNumber - the page number

pageSize - the page size

select - the select part of the sql statement

sqlExceptSelect - the sql statement excluded select part

paras - the parameters of sql

返回:

the Page object

paginate

public static Page<Record> paginate(int pageNumber,
                                    int pageSize,
                                    boolean isGroupBySql,
                                    String select,
                                    String sqlExceptSelect,
                                    Object... paras)

参数:

pageNumber -

pageSize -

isGroupBySql -

select -

sqlExceptSelect -

paras -

返回:

paginateByFullSql

public static Page<Record> paginateByFullSql(int pageNumber,
                                             int pageSize,
                                             String totalRowSql,
                                             String findSql,
                                             Object... paras)

参数:

pageNumber -

pageSize -

totalRowSql -

findSql -

paras -

返回:

paginateByFullSql

public static Page<Record> paginateByFullSql(int pageNumber,
                                             int pageSize,
                                             boolean isGroupBySql,
                                             String totalRowSql,
                                             String findSql,
                                             Object... paras)

参数:

pageNumber -

pageSize -

isGroupBySql -

totalRowSql -

findSql -

paras -

返回:

paginate

public static <T> Page<T> paginate(Class<T> clazz,
                                   int pageNumber,
                                   int pageSize,
                                   SqlPara sqlPara)

类型参数:

T -

参数:

clazz -

pageNumber -

pageSize -

sqlPara -

返回:

paginate

public static <T> Page<T> paginate(Class<T> clazz,
                                   int pageNumber,
                                   int pageSize,
                                   boolean isGroupBySql,
                                   SqlPara sqlPara)

类型参数:

T -

参数:

clazz -

pageNumber -

pageSize -

isGroupBySql -

sqlPara -

返回:

paginate

public static <T> Page<T> paginate(Class<T> clazz,
                                   int pageNumber,
                                   int pageSize,
                                   String select,
                                   String sqlExceptSelect)

类型参数:

T -

参数:

clazz -

pageNumber -

pageSize -

select -

sqlExceptSelect -

返回:

paginate

public static <T> Page<T> paginate(Class<T> clazz,
                                   int pageNumber,
                                   int pageSize,
                                   boolean isGroupBySql,
                                   String select,
                                   String sqlExceptSelect)

类型参数:

T -

参数:

clazz -

pageNumber -

pageSize -

isGroupBySql -

select -

sqlExceptSelect -

返回:

paginate

public static <T> Page<T> paginate(Class<T> clazz,
                                   int pageNumber,
                                   int pageSize,
                                   String select,
                                   String sqlExceptSelect,
                                   Object... paras)

类型参数:

T -

参数:

clazz -

pageNumber -

pageSize -

select -

sqlExceptSelect -

paras -

返回:

paginate

public static <T> Page<T> paginate(Class<T> clazz,
                                   int pageNumber,
                                   int pageSize,
                                   boolean isGroupBySql,
                                   String select,
                                   String sqlExceptSelect,
                                   Object... paras)

类型参数:

T -

参数:

clazz -

pageNumber -

pageSize -

isGroupBySql -

select -

sqlExceptSelect -

paras -

返回:

paginateByFullSql

public static <T> Page<T> paginateByFullSql(Class<T> clazz,
                                            int pageNumber,
                                            int pageSize,
                                            String totalRowSql,
                                            String findSql,
                                            Object... paras)

参数:

pageNumber -

pageSize -

totalRowSql -

findSql -

paras -

返回:

paginateByFullSql

public static <T> Page<T> paginateByFullSql(Class<T> clazz,
                                            int pageNumber,
                                            int pageSize,
                                            boolean isGroupBySql,
                                            String totalRowSql,
                                            String findSql,
                                            Object... paras)

参数:

pageNumber -

pageSize -

isGroupBySql -

totalRowSql -

findSql -

paras -

返回:

paginateByCache

public static Page<Record> paginateByCache(String cacheName,
                                           Object key,
                                           int pageNumber,
                                           int pageSize,
                                           SqlPara sqlPara)

参数:

cacheName -

key -

pageNumber -

pageSize -

sqlPara -

返回:

paginateByCache

public static Page<Record> paginateByCache(String cacheName,
                                           Object key,
                                           int pageNumber,
                                           int pageSize,
                                           boolean isGroupBySql,
                                           SqlPara sqlPara)

参数:

cacheName -

key -

pageNumber -

pageSize -

isGroupBySql -

sqlPara -

返回:

paginateByCache

public static Page<Record> paginateByCache(String cacheName,
                                           Object key,
                                           int pageNumber,
                                           int pageSize,
                                           String select,
                                           String sqlExceptSelect,
                                           Object... paras)

Paginate by cache.

参数:

cacheName -

key -

pageNumber -

pageSize -

select -

sqlExceptSelect -

paras -

返回:

paginateByCache

public static Page<Record> paginateByCache(String cacheName,
                                           Object key,
                                           int pageNumber,
                                           int pageSize,
                                           boolean isGroupBySql,
                                           String select,
                                           String sqlExceptSelect,
                                           Object... paras)

参数:

cacheName -

key -

pageNumber -

pageSize -

isGroupBySql -

select -

sqlExceptSelect -

paras -

返回:

paginateByCache

public static Page<Record> paginateByCache(String cacheName,
                                           Object key,
                                           int pageNumber,
                                           int pageSize,
                                           String select,
                                           String sqlExceptSelect)

参数:

cacheName -

key -

pageNumber -

pageSize -

select -

sqlExceptSelect -

返回:

paginateByCache

public static Page<Record> paginateByCache(String cacheName,
                                           Object key,
                                           int pageNumber,
                                           int pageSize,
                                           boolean isGroupBySql,
                                           String select,
                                           String sqlExceptSelect)

参数:

cacheName -

key -

pageNumber -

pageSize -

isGroupBySql -

select -

sqlExceptSelect -

返回:

paginateByCacheByFullSql

public static Page<Record> paginateByCacheByFullSql(String cacheName,
                                                    Object key,
                                                    int pageNumber,
                                                    int pageSize,
                                                    String totalRowSql,
                                                    String findSql,
                                                    Object... paras)

参数:

pageNumber -

pageSize -

totalRowSql -

findSql -

paras -

返回:

paginateByCacheByFullSql

public static Page<Record> paginateByCacheByFullSql(String cacheName,
                                                    Object key,
                                                    int pageNumber,
                                                    int pageSize,
                                                    boolean isGroupBySql,
                                                    String totalRowSql,
                                                    String findSql,
                                                    Object... paras)

参数:

pageNumber -

pageSize -

isGroupBySql -

totalRowSql -

findSql -

paras -

返回:

paginateByCache

public static <T> Page<T> paginateByCache(Class<T> clazz,
                                          String cacheName,
                                          Object key,
                                          int pageNumber,
                                          int pageSize,
                                          boolean isGroupBySql,
                                          String select,
                                          String sqlExceptSelect)

类型参数:

T -

参数:

clazz -

cacheName -

key -

pageNumber -

pageSize -

isGroupBySql -

select -

sqlExceptSelect -

返回:

paginateByCache

public static <T> Page<T> paginateByCache(Class<T> clazz,
                                          String cacheName,
                                          Object key,
                                          int pageNumber,
                                          int pageSize,
                                          boolean isGroupBySql,
                                          SqlPara sqlPara)

类型参数:

T -

参数:

clazz -

cacheName -

key -

pageNumber -

pageSize -

isGroupBySql -

sqlPara -

返回:

paginateByCache

public static <T> Page<T> paginateByCache(Class<T> clazz,
                                          String cacheName,
                                          Object key,
                                          int pageNumber,
                                          int pageSize,
                                          SqlPara sqlPara)

类型参数:

T -

参数:

clazz -

cacheName -

key -

pageNumber -

pageSize -

sqlPara -

返回:

paginateByCache

public static <T> Page<T> paginateByCache(Class<T> clazz,
                                          String cacheName,
                                          Object key,
                                          int pageNumber,
                                          int pageSize,
                                          String select,
                                          String sqlExceptSelect)

类型参数:

T -

参数:

clazz -

cacheName -

key -

pageNumber -

pageSize -

select -

sqlExceptSelect -

返回:

paginateByCache

public static <T> Page<T> paginateByCache(Class<T> clazz,
                                          String cacheName,
                                          Object key,
                                          int pageNumber,
                                          int pageSize,
                                          String select,
                                          String sqlExceptSelect,
                                          Object... paras)

类型参数:

T -

参数:

clazz -

cacheName -

key -

pageNumber -

pageSize -

select -

sqlExceptSelect -

paras -

返回:

paginateByCache

public static <T> Page<T> paginateByCache(Class<T> clazz,
                                          String cacheName,
                                          Object key,
                                          int pageNumber,
                                          int pageSize,
                                          boolean isGroupBySql,
                                          String select,
                                          String sqlExceptSelect,
                                          Object... paras)

类型参数:

T -

参数:

clazz -

cacheName -

key -

pageNumber -

pageSize -

isGroupBySql -

select -

sqlExceptSelect -

paras -

返回:

paginateByCacheByFullSql

public static <T> Page<T> paginateByCacheByFullSql(Class<T> clazz,
                                                   String cacheName,
                                                   Object cacheKey,
                                                   int pageNumber,
                                                   int pageSize,
                                                   String totalRowSql,
                                                   String findSql,
                                                   Object... paras)

类型参数:

T -

参数:

clazz -

cacheName -

cacheKey -

pageNumber -

pageSize -

totalRowSql -

findSql -

paras -

返回:

paginateByCacheByFullSql

public static <T> Page<T> paginateByCacheByFullSql(Class<T> clazz,
                                                   String cacheName,
                                                   Object cacheKey,
                                                   int pageNumber,
                                                   int pageSize,
                                                   boolean isGroupBySql,
                                                   String totalRowSql,
                                                   String findSql,
                                                   Object... paras)

类型参数:

T -

参数:

clazz -

cacheName -

cacheKey -

pageNumber -

pageSize -

isGroupBySql -

totalRowSql -

findSql -

paras -

返回:

execute

public static Object execute(ICallback callback)

另请参阅:

#execute(String, ICallback)

tx

public static boolean tx(IAtom atom)

Execute transaction with default transaction level.

另请参阅:

tx(int, IAtom)

tx

public static boolean tx(int transactionLevel,
                         IAtom atom)

txInNewThread

public static Future<Boolean> txInNewThread(IAtom atom)

主要用于嵌套事务场景 实例：https://jfinal.com/feedback/4008 默认情况下嵌套事务会被合并成为一个事务，那么内层与外层任何地方回滚事务 所有嵌套层都将回滚事务，也就是说嵌套事务无法独立提交与回滚 使用 txInNewThread(...) 方法可以实现层之间的事务控制的独立性 由于事务处理是将 Connection 绑定到线程上的，所以 txInNewThread(...) 通过建立新线程来实现嵌套事务的独立控制

txInNewThread

public static Future<Boolean> txInNewThread(int transactionLevel,
                                            IAtom atom)

findByCache

public static List<Record> findByCache(String cacheName,
                                       Object key,
                                       String sql,
                                       Object... paras)

Find Record by cache.

参数:

cacheName - the cache name

key - the key used to get date from cache

返回:

the list of Record

另请参阅:

find(String, Object...)

findByCache

public static <T> List<T> findByCache(Class<T> clazz,
                                      String cacheName,
                                      Object key,
                                      String sql,
                                      Object... paras)

findByCache

public static List<Record> findByCache(String cacheName,
                                       Object key,
                                       String sql)

另请参阅:

findByCache(String, Object, String, Object...)

findByCache

public static <T> List<T> findByCache(Class<T> clazz,
                                      String cacheName,
                                      Object key,
                                      String sql)

findFirstByCache

public static Record findFirstByCache(String cacheName,
                                      Object key,
                                      String sql,
                                      Object... paras)

Find first record by cache. I recommend add "limit 1" in your sql.

参数:

cacheName - the cache name

key - the key used to get date from cache

sql - an SQL statement that may contain one or more '?' IN parameter placeholders

paras - the parameters of sql

返回:

the Record object

另请参阅:

findFirst(String, Object...)

findFirstByCache

public static <T> T findFirstByCache(Class<T> clazz,
                                     String cacheName,
                                     Object key,
                                     String sql,
                                     Object... paras)

findFirstByCache

public static Record findFirstByCache(String cacheName,
                                      Object key,
                                      String sql)

另请参阅:

findFirstByCache(String, Object, String, Object...)

findFirstByCache

public static <T> T findFirstByCache(Class<T> clazz,
                                     String cacheName,
                                     Object key,
                                     String sql)

batch

public static int[] batch(String sql,
                          Object[][] paras,
                          int batchSize)

另请参阅:

DbPro.batch(String, Object[][], int)

batch

public static int[] batch(String sql,
                          String columns,
                          List modelOrRecordList,
                          int batchSize)

另请参阅:

DbPro.batch(String, String, List, int)

batch

public static int[] batch(List<String> sqlList,
                          int batchSize)

另请参阅:

DbPro.batch(List, int)

batchSave

public static int[] batchSave(List<? extends Model> modelList,
                              int batchSize)

另请参阅:

DbPro.batchSave(List, int)

batchSave

public static int[] batchSave(String tableName,
                              List<? extends Record> recordList,
                              int batchSize)

另请参阅:

DbPro.batchSave(String, List, int)

batchDelete

public static int[] batchDelete(String tableName,
                                List<? extends Record> recordList,
                                int batchSize)

batchUpdate

public static int[] batchUpdate(List<? extends Model> modelList,
                                int batchSize)

另请参阅:

DbPro.batchUpdate(List, int)

batchUpdate

public static int[] batchUpdate(String tableName,
                                String primaryKey,
                                List<? extends Record> recordList,
                                int batchSize)

另请参阅:

DbPro.batchUpdate(String, String, List, int)

batchUpdate

public static int[] batchUpdate(String tableName,
                                List<? extends Record> recordList,
                                int batchSize)

另请参阅:

DbPro.batchUpdate(String, List, int)

getSql

public static String getSql(String key)

getSqlPara

public static SqlPara getSqlPara(String key,
                                 Record record)

getSqlPara

public static SqlPara getSqlPara(String key,
                                 Model model)

getSqlPara

public static SqlPara getSqlPara(String key,
                                 Map data)

getSqlPara

public static SqlPara getSqlPara(String key,
                                 Object... paras)

getSqlParaByString

public static SqlPara getSqlParaByString(String content,
                                         Map data)

getSqlParaByString

public static SqlPara getSqlParaByString(String content,
                                         Object... paras)

find

public static List<Record> find(SqlPara sqlPara)

参数:

sqlPara -

返回:

find

public static <T> List<T> find(Class<T> clazz,
                               SqlPara sqlPara)

类型参数:

T -

参数:

clazz -

sqlPara -

返回:

findFirst

public static Record findFirst(SqlPara sqlPara)

参数:

sqlPara -

返回:

findFirst

public static <T> T findFirst(Class<T> clazz,
                              SqlPara sqlPara)

类型参数:

T -

参数:

clazz -

sqlPara -

返回:

each

public static void each(java.util.function.Function<Record,Boolean> func,
                        String sql,
                        Object... paras)

迭代处理每一个查询出来的 Record 对象

 例子：
 Db.each(record -> {
    // 处理 record 的代码在此
    
    // 返回 true 继续循环处理下一条数据，返回 false 立即终止循环
    return true;
 }, sql, paras);
 

template

public static DbTemplate template(String key,
                                  Map data)

使用 sql 模板进行查询，可以省去 Db.getSqlPara(...) 调用

 例子：
 Db.template("blog.find", Kv.by("id", 123).find();
 

template

public static DbTemplate template(String key,
                                  Object... paras)

使用 sql 模板进行查询，可以省去 Db.getSqlPara(...) 调用

 例子：
 Db.template("blog.find", 123).find();
 

templateByString

public static DbTemplate templateByString(String content,
                                          Map data)

使用字符串变量作为 sql 模板进行查询，可省去外部 sql 文件来使用 sql 模板功能

 例子：
 String sql = "select * from blog where id = #para(id)";
 Db.templateByString(sql, Kv.by("id", 123).find();
 

templateByString

public static DbTemplate templateByString(String content,
                                          Object... paras)

使用字符串变量作为 sql 模板进行查询，可省去外部 sql 文件来使用 sql 模板功能

 例子：
 String sql = "select * from blog where id = #para(0)";
 Db.templateByString(sql, 123).find();
 

existsBySql

public static boolean existsBySql(String sql,
                                  Object... paras)

exists

public static boolean exists(String tableName,
                             String fields,
                             Object... paras)

参数:

tableName -

fields -

paras -

返回:

count

public static Long count(String sql)

countTable

public static Long countTable(String table)

queryListString

public static List<String> queryListString(String sql)

queryListString

public static List<String> queryListString(String sql,
                                           Object... params)