com.jfinal.plugin.activerecord

类 Db

java.lang.Object

com.jfinal.plugin.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 boolean	delete(String tableName, Record record) Example: boolean succeed = Db.delete("user", user);
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) Delete record by id.
static Object	execute(ICallback callback)
static List<Record>	find(String sql)
static List<Record>	find(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 Record	findById(String tableName, Object idValue) Find record by id with default primary key.
static Record	findById(String tableName, String primaryKey, Object... idValue) Find record by id.
static Record	findFirst(String sql)
static Record	findFirst(String sql, Object... paras) Find first record.
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 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)
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> 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 Boolean	queryBoolean(String sql)
static Boolean	queryBoolean(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 Long	queryLong(String sql)
static Long	queryLong(String sql, Object... paras)
static Number	queryNumber(String sql)
static Number	queryNumber(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(String tableName, Record record)
static boolean	save(String tableName, String primaryKey, Record record) Save record.
static boolean	tx(IAtom atom) Execute transaction with default transaction level.
static boolean	tx(int transactionLevel, IAtom atom)
static int	update(String sql)
static int	update(String sql, Object... paras) Execute update, insert or delete sql statement.
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 DbPro	use(String configName)

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

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

构造器详细资料

Db

public Db()

方法详细资料

use

public static DbPro use(String configName)

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

返回:

List

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)

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)

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)

queryNumber

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

queryNumber

public static Number queryNumber(String sql)

update

public static int update(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...)

find

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

另请参阅:

#find(String, String, Object...)

find

public static List<Record> find(String sql)

参数:

sql - the sql statement

另请参阅:

#find(String, String, Object...)

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 Record findFirst(String sql)

参数:

sql - an SQL statement

另请参阅:

findFirst(String, Object...)

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 Record findById(String tableName,
                              String primaryKey,
                              Object... idValue)

Find record by id.

 Example:
 Record user = Db.findById("user", "user_id", 123);
 Record userRole = Db.findById("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: ","

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

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)

Delete record by id.

 Example: Db.deleteById("user", "user_id", 15);
 Db.deleteById("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: ","

idValue - 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

delete

public static boolean delete(String tableName,
                             Record record)

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

另请参阅:

delete(String, String, Record)

paginate

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

另请参阅:

#paginate(String, int, int, String, String, Object...)

paginate

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

另请参阅:

#paginate(String, int, int, String, String, Object...)

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)

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,
                             Record record)

Update record with default primary key.

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

另请参阅:

update(String, String, Record)

execute

public static Object execute(ICallback callback)

另请参阅:

#execute(String, ICallback)

tx

public static boolean tx(int transactionLevel,
                         IAtom atom)

tx

public static boolean tx(IAtom atom)

Execute transaction with default transaction level.

另请参阅:

tx(int, IAtom)

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 List<Record> findByCache(String cacheName,
                                       Object key,
                                       String sql)

另请参阅:

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

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 Record findFirstByCache(String cacheName,
                                      Object key,
                                      String sql)

另请参阅:

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

paginateByCache

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

Paginate by cache.

返回:

Page

另请参阅:

paginate(int, int, String, String, Object...)

paginateByCache

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

另请参阅:

paginateByCache(String, Object, int, int, String, String, Object...)

batch

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

另请参阅:

#batch(String, String, Object[][], int)

batch

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

另请参阅:

#batch(String, String, String, List, int)

batch

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

另请参阅:

#batch(String, List, int)