com.litongjava.db.activerecord

类 Model<M extends Model>

java.lang.Object

com.litongjava.db.activerecord.Model<M>

所有已实现的接口:

com.litongjava.model.db.IRow<M>, Serializable

public abstract class Model<M extends Model>
extends Object
implements com.litongjava.model.db.IRow<M>, Serializable

Model.

A clever person solves a problem. A wise person avoids it A stupid person makes it.

另请参阅:

序列化表格

字段概要

字段

限定符和类型	字段和说明
static int	FILTER_BY_SAVE
static int	FILTER_BY_UPDATE

构造器概要

构造器

构造器和说明
Model()

方法概要

限定符和类型	方法和说明
String[]	_getAttrNames() Return attribute names of this model.
Map<String,Object>	_getAttrs() Return attribute Map.
Set<Map.Entry<String,Object>>	_getAttrsEntrySet() Return attribute Set.
Object[]	_getAttrValues() Return attribute values of this model.
protected Set<String>	_getModifyFlag()
protected abstract String	_getPrimaryKey()
protected Config	_getReadConfig()
protected Table	_getTable()
protected abstract String	_getTableName()
protected Class<? extends Model>	_getUsefulClass()
protected Config	_getWriteConfig()
M	_setAttrs(M model) Set attributes with other model.
M	_setAttrs(Map<String,Object> attrs) Set attributes with Map.
M	_setOrPut(Map<String,Object> map)
M	_setOrPut(Model model)
M	clear() Remove all attributes of this model.
M	dao() 将本 model 对象转化为线程安全的 dao 对象.
boolean	delete() Delete model.
boolean	deleteByField(String field, String value)
protected boolean	deleteByField(Table table, String field, String value)
boolean	deleteById() Delete model.
boolean	deleteById(Object idValue) Delete model by id.
protected boolean	deleteById(Table table, Object... idValues)
boolean	deleteByIds(Object... idValues) Delete model by composite id values.
protected com.litongjava.model.page.Page<M>	doPaginate(int pageNumber, int pageSize, Boolean isGroupBySql, String select, String sqlExceptSelect, Object... paras)
protected com.litongjava.model.page.Page<M>	doPaginateByCache(String cacheName, Object key, int pageNumber, int pageSize, Boolean isGroupBySql, String select, String sqlExceptSelect, Object... paras)
protected com.litongjava.model.page.Page<M>	doPaginateByFullSql(Config config, Connection conn, int pageNumber, int pageSize, Boolean isGroupBySql, String totalRowSql, StringBuilder findSql, Object... paras)
protected com.litongjava.model.page.Page<M>	doPaginateByFullSql(int pageNumber, int pageSize, Boolean isGroupBySql, String totalRowSql, String findSql, Object... paras)
void	each(java.util.function.Function<M,Boolean> func, String sql, Object... paras) 迭代处理每一个查询出来的 Model 对象 例子： Db.each(model -> { // 处理 model 的代码在此 // 返回 true 继续循环处理下一条数据，返回 false 立即终止循环 return true; }, sql, paras);
boolean	equals(Object o)
boolean	exists(String fields, Object... paras)
boolean	existsById(Object... paras)
boolean	existsBySql(String sql, Object... paras)
protected void	filter(int filterBy) filter () 方法将被 save()、update() 两个方法回调， 子类可通过覆盖此方法，实现类似于过滤 XSS 攻击脚本的功能
List<M>	find()
protected List<M>	find(Config config, Connection conn, String sql, Object... paras) Find model.
protected List<M>	find(Config config, Connection conn, String tableName, String columns, Row record)
protected List<M>	find(Config config, String sql, Object... paras)
List<M>	find(Config config, String tableName, Row record)
List<M>	find(com.litongjava.db.SqlPara sqlPara)
List<M>	find(String sql)
List<M>	find(String sql, Object... paras) Find model.
List<M>	find(String tableName, String columns, Row record)
List<M>	findAll()
List<M>	findByCache(String cacheName, Object key, String sql)
List<M>	findByCache(String cacheName, Object key, String sql, Object... paras) Find model by cache.
M	findById(Object idValue) Find model by id.
M	findByIdLoadColumns(Object[] idValues, String columns) Find model by composite id values and load specific columns only.
M	findByIdLoadColumns(Object idValue, String columns) Find model by id and load specific columns only.
M	findByIds(Object... idValues) Find model by composite id values.
M	findColumnsFirst(String columns)
M	findFirst()
M	findFirst(com.litongjava.db.SqlPara sqlPara)
M	findFirst(String sql)
M	findFirst(String sql, Object... paras) Find first model.
M	findFirst(String tableName, Row record)
M	findFirst(String tableName, String columns, Row record)
M	findFirstByCache(String cacheName, Object key, String sql)
M	findFirstByCache(String cacheName, Object key, String sql, Object... paras) Find first model by cache.
M	fromRow(Row row)
<T> T	get(String attr) Get attribute of any mysql type
<T> T	get(String attr, Object defaultValue) Get attribute of any mysql type.
BigDecimal	getBigDecimal(String attr) Get attribute of mysql type: decimal, numeric
BigInteger	getBigInteger(String attr) Get attribute of mysql type: unsigned bigint
Boolean	getBoolean(String attr) Get attribute of mysql type: bit, tinyint(1)
Byte	getByte(String attr)
byte[]	getBytes(String attr) Get attribute of mysql type: binary, varbinary, tinyblob, blob, mediumblob, longblob
Date	getDate(String attr) Get attribute of mysql type: date, year
Double	getDouble(String attr) Get attribute of mysql type: real, double
Float	getFloat(String attr) Get attribute of mysql type: float
Integer	getInt(String attr) Get attribute of mysql type: int, integer, tinyint(n) n > 1, smallint, mediumint
java.time.LocalDateTime	getLocalDateTime(String attr)
Long	getLong(String attr) Get attribute of mysql type: bigint, unsign int
Number	getNumber(String attr) Get attribute of any type that extends from Number
Short	getShort(String attr)
String	getSql(String key)
com.litongjava.db.SqlPara	getSqlPara(String key, Map data) 可以在模板中利用 Model 自身的属性参与动态生成 sql，例如： select * from user where nickName = #(nickName) new Account().setNickName("James").getSqlPara(...)
com.litongjava.db.SqlPara	getSqlPara(String key, Model model)
com.litongjava.db.SqlPara	getSqlPara(String key, Object... paras)
com.litongjava.db.SqlPara	getSqlParaByString(String content, Map data)
com.litongjava.db.SqlPara	getSqlParaByString(String content, Model model)
com.litongjava.db.SqlPara	getSqlParaByString(String content, Object... paras)
String	getStr(String attr) Get attribute of mysql type: varchar, char, enum, set, text, tinytext, mediumtext, longtext
Time	getTime(String attr) Get attribute of mysql type: time
Timestamp	getTimestamp(String attr) Get attribute of mysql type: timestamp, datetime
int	hashCode()
M	keep(String... attrs) Keep attributes of this model and remove other attributes.
M	keep(String attr) Keep attribute of this model and remove other attributes.
com.litongjava.model.page.Page<M>	paginate(int pageNumber, int pageSize, boolean isGroupBySql, com.litongjava.db.SqlPara sqlPara)
com.litongjava.model.page.Page<M>	paginate(int pageNumber, int pageSize, boolean isGroupBySql, String select, String sqlExceptSelect, Object... paras) 指定分页 sql 最外层以是否含有 group by 语句 举例： paginate(1, 10, true, "select *", "from user where id>?
com.litongjava.model.page.Page<M>	paginate(int pageNumber, int pageSize, com.litongjava.db.SqlPara sqlPara)
com.litongjava.model.page.Page<M>	paginate(int pageNumber, int pageSize, String select, String sqlExceptSelect)
com.litongjava.model.page.Page<M>	paginate(int pageNumber, int pageSize, String select, String sqlExceptSelect, Object... paras) Paginate.
com.litongjava.model.page.Page<M>	paginateByCache(String cacheName, Object key, int pageNumber, int pageSize, boolean isGroupBySql, String select, String sqlExceptSelect, Object... paras)
com.litongjava.model.page.Page<M>	paginateByCache(String cacheName, Object key, int pageNumber, int pageSize, String select, String sqlExceptSelect)
com.litongjava.model.page.Page<M>	paginateByCache(String cacheName, Object key, int pageNumber, int pageSize, String select, String sqlExceptSelect, Object... paras) Paginate by cache.
com.litongjava.model.page.Page<M>	paginateByFullSql(int pageNumber, int pageSize, boolean isGroupBySql, String totalRowSql, String findSql, Object... paras)
com.litongjava.model.page.Page<M>	paginateByFullSql(int pageNumber, int pageSize, String totalRowSql, String findSql, Object... paras)
M	put(Map<String,Object> map) Put map to the model without check attribute name.
M	put(Model model) Put other model to the model without check attribute name.
M	put(Row row) Put record to the model without check attribute name.
M	put(String key, Object value) Put key value pair to the model without check attribute name.
<T> List<T>	query(String sql, Object... paras)
<T> T	queryFirst(String sql, Object... paras) Execute sql query and return the first result.
Integer	queryInt(String sql, Object... paras)
Long	queryLong(String sql, Object... paras)
String	queryString(String sql, Object... paras)
M	remove(String... attrs) Remove attributes of this model.
M	remove(String attr) Remove attribute of this model.
M	removeNullValueAttrs() Remove attributes if it is null.
boolean	save() Save model.
M	set(String attr, Object value) Set attribute to model.
M	setOrPut(String attrOrNot, Object value) 如果 attrOrNot 是表中的字段则调用 set(...)
int	size()
DaoTemplate<M>	template(String key, Map data) 使用 sql 模板进行查询，可以省去 getSqlPara(...)
DaoTemplate<M>	template(String key, Model model)
DaoTemplate<M>	template(String key, Object... paras) 使用 sql 模板进行查询，可以省去 getSqlPara(...)
DaoTemplate<M>	templateByString(String content, Map data) 使用字符串变量作为 sql 模板进行查询，可省去外部 sql 文件来使用 sql 模板功能 例子： String sql = "select * from blog where id = #para(id)"; dao.templateByString(sql, Kv.by("id", 123)).find();
DaoTemplate<M>	templateByString(String content, Model model)
DaoTemplate<M>	templateByString(String content, Object... paras) 使用字符串变量作为 sql 模板进行查询，可省去外部 sql 文件来使用 sql 模板功能 例子： String sql = "select * from blog where id = #para(0)"; dao.templateByString(sql, 123).find();
Map<String,Object>	toMap()
Row	toRow() Convert model to record.
String	toString()
boolean	update() Update model.
M	use(String configName) Switching data source, dialect and all config by configName

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细资料

FILTER_BY_SAVE

public static final int FILTER_BY_SAVE

另请参阅:

常量字段值

FILTER_BY_UPDATE

public static final int FILTER_BY_UPDATE

另请参阅:

常量字段值

构造器详细资料

Model

public Model()

方法详细资料

_getPrimaryKey

protected abstract String _getPrimaryKey()

_getTableName

protected abstract String _getTableName()

dao

public M dao()

将本 model 对象转化为线程安全的 dao 对象. 为保障线程安全，转化为线程安全的 dao 对象，只能调用线程安全方法， 也即只能调用其 find 系列、paginate 系列、deleteBy 系列方法， 不能再调用其 set 系列以及 get 系列方法，更不能再调用其 save()、 update()、delete() 等方法，否则会抛出异常进行防护

 强烈建议通过 static 修饰过的 dao 对象都要调用一次 dao() 方法，
 以免新手误用造成线程安全问题，示例如下：

 public class UserService {

        private static User dao = new User().dao();

        public User getUserById(long userId) {
                return dao.findFirst("select * from `user` where id = ? limit 1", userId);
        }
 }
 

filter

protected void filter(int filterBy)

filter () 方法将被 save()、update() 两个方法回调， 子类可通过覆盖此方法，实现类似于过滤 XSS 攻击脚本的功能

参数:

filterBy - 0 表示当前正被 save() 调用, 1 表示当前正被 update() 调用

_getAttrs

public Map<String,Object> _getAttrs()

Return attribute Map.

Danger! The update method will ignore the attribute if you change it directly. You must use set method to change attribute that update method can handle it.

_getAttrsEntrySet

public Set<Map.Entry<String,Object>> _getAttrsEntrySet()

Return attribute Set.

_getAttrNames

public String[] _getAttrNames()

Return attribute names of this model.

_getAttrValues

public Object[] _getAttrValues()

Return attribute values of this model.

_setAttrs

public M _setAttrs(M model)

Set attributes with other model.

参数:

model - the Model

返回:

this Model

_setAttrs

public M _setAttrs(Map<String,Object> attrs)

Set attributes with Map.

参数:

attrs - attributes of this model

返回:

this Model

_getModifyFlag

protected Set<String> _getModifyFlag()

_getWriteConfig

protected Config _getWriteConfig()

_getReadConfig

protected Config _getReadConfig()

_getTable

protected Table _getTable()

_getUsefulClass

protected Class<? extends Model> _getUsefulClass()

use

public M use(String configName)

Switching data source, dialect and all config by configName

set

public M set(String attr,
             Object value)

Set attribute to model.

指定者:

set 在接口中 com.litongjava.model.db.IRow<M extends Model>

参数:

attr - the attribute name of the model

value - the value of the attribute

返回:

this model

抛出:

ActiveRecordException - if the attribute is not exists of the model

put

public M put(String key,
             Object value)

Put key value pair to the model without check attribute name.

指定者:

put 在接口中 com.litongjava.model.db.IRow<M extends Model>

setOrPut

public M setOrPut(String attrOrNot,
                  Object value)

如果 attrOrNot 是表中的字段则调用 set(...) 放入数据 否则调用 put(...) 放入数据

_setOrPut

public M _setOrPut(Map<String,Object> map)

_setOrPut

public M _setOrPut(Model model)

put

public M put(Map<String,Object> map)

Put map to the model without check attribute name.

指定者:

put 在接口中 com.litongjava.model.db.IRow<M extends Model>

put

public M put(Model model)

Put other model to the model without check attribute name.

put

public M put(Row row)

Put record to the model without check attribute name.

toRow

public Row toRow()

Convert model to record.

fromRow

public M fromRow(Row row)

get

public <T> T get(String attr)

Get attribute of any mysql type

指定者:

get 在接口中 com.litongjava.model.db.IRow<M extends Model>

get

public <T> T get(String attr,
                 Object defaultValue)

Get attribute of any mysql type. Returns defaultValue if null.

指定者:

get 在接口中 com.litongjava.model.db.IRow<M extends Model>

getStr

public String getStr(String attr)

Get attribute of mysql type: varchar, char, enum, set, text, tinytext, mediumtext, longtext

指定者:

getStr 在接口中 com.litongjava.model.db.IRow<M extends Model>

getInt

public Integer getInt(String attr)

Get attribute of mysql type: int, integer, tinyint(n) n > 1, smallint, mediumint

指定者:

getInt 在接口中 com.litongjava.model.db.IRow<M extends Model>

getLong

public Long getLong(String attr)

Get attribute of mysql type: bigint, unsign int

指定者:

getLong 在接口中 com.litongjava.model.db.IRow<M extends Model>

getBigInteger

public BigInteger getBigInteger(String attr)

Get attribute of mysql type: unsigned bigint

指定者:

getBigInteger 在接口中 com.litongjava.model.db.IRow<M extends Model>

getDate

public Date getDate(String attr)

Get attribute of mysql type: date, year

指定者:

getDate 在接口中 com.litongjava.model.db.IRow<M extends Model>

getLocalDateTime

public java.time.LocalDateTime getLocalDateTime(String attr)

指定者:

getLocalDateTime 在接口中 com.litongjava.model.db.IRow<M extends Model>

getTime

public Time getTime(String attr)

Get attribute of mysql type: time

指定者:

getTime 在接口中 com.litongjava.model.db.IRow<M extends Model>

getTimestamp

public Timestamp getTimestamp(String attr)

Get attribute of mysql type: timestamp, datetime

指定者:

getTimestamp 在接口中 com.litongjava.model.db.IRow<M extends Model>

getDouble

public Double getDouble(String attr)

Get attribute of mysql type: real, double

指定者:

getDouble 在接口中 com.litongjava.model.db.IRow<M extends Model>

getFloat

public Float getFloat(String attr)

Get attribute of mysql type: float

指定者:

getFloat 在接口中 com.litongjava.model.db.IRow<M extends Model>

getShort

public Short getShort(String attr)

指定者:

getShort 在接口中 com.litongjava.model.db.IRow<M extends Model>

getByte

public Byte getByte(String attr)

指定者:

getByte 在接口中 com.litongjava.model.db.IRow<M extends Model>

getBoolean

public Boolean getBoolean(String attr)

Get attribute of mysql type: bit, tinyint(1)

指定者:

getBoolean 在接口中 com.litongjava.model.db.IRow<M extends Model>

getBigDecimal

public BigDecimal getBigDecimal(String attr)

Get attribute of mysql type: decimal, numeric

指定者:

getBigDecimal 在接口中 com.litongjava.model.db.IRow<M extends Model>

getBytes

public byte[] getBytes(String attr)

Get attribute of mysql type: binary, varbinary, tinyblob, blob, mediumblob, longblob

指定者:

getBytes 在接口中 com.litongjava.model.db.IRow<M extends Model>

getNumber

public Number getNumber(String attr)

Get attribute of any type that extends from Number

指定者:

getNumber 在接口中 com.litongjava.model.db.IRow<M extends Model>

paginate

public com.litongjava.model.page.Page<M> 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 com.litongjava.model.page.Page<M> paginate(int pageNumber,
                                                  int pageSize,
                                                  String select,
                                                  String sqlExceptSelect)

另请参阅:

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

paginate

public com.litongjava.model.page.Page<M> paginate(int pageNumber,
                                                  int pageSize,
                                                  boolean isGroupBySql,
                                                  String select,
                                                  String sqlExceptSelect,
                                                  Object... paras)

指定分页 sql 最外层以是否含有 group by 语句

 举例：
 paginate(1, 10, true, "select *", "from user where id>? group by age", 123);
 

doPaginate

protected com.litongjava.model.page.Page<M> doPaginate(int pageNumber,
                                                       int pageSize,
                                                       Boolean isGroupBySql,
                                                       String select,
                                                       String sqlExceptSelect,
                                                       Object... paras)

doPaginateByFullSql

protected com.litongjava.model.page.Page<M> doPaginateByFullSql(Config config,
                                                                Connection conn,
                                                                int pageNumber,
                                                                int pageSize,
                                                                Boolean isGroupBySql,
                                                                String totalRowSql,
                                                                StringBuilder findSql,
                                                                Object... paras)
                                                         throws Exception

抛出:

Exception

doPaginateByFullSql

protected com.litongjava.model.page.Page<M> doPaginateByFullSql(int pageNumber,
                                                                int pageSize,
                                                                Boolean isGroupBySql,
                                                                String totalRowSql,
                                                                String findSql,
                                                                Object... paras)

paginateByFullSql

public com.litongjava.model.page.Page<M> paginateByFullSql(int pageNumber,
                                                           int pageSize,
                                                           String totalRowSql,
                                                           String findSql,
                                                           Object... paras)

paginateByFullSql

public com.litongjava.model.page.Page<M> paginateByFullSql(int pageNumber,
                                                           int pageSize,
                                                           boolean isGroupBySql,
                                                           String totalRowSql,
                                                           String findSql,
                                                           Object... paras)

save

public boolean save()

Save model.

deleteById

public boolean deleteById()

Delete model.

delete

public boolean delete()

Delete model.

deleteById

public boolean deleteById(Object idValue)

Delete model by id.

参数:

idValue - the id value of the model

返回:

true if delete succeed otherwise false

deleteByField

public boolean deleteByField(String field,
                             String value)

deleteByIds

public boolean deleteByIds(Object... idValues)

Delete model by composite id values.

参数:

idValues - the composite id values of the model

返回:

true if delete succeed otherwise false

deleteById

protected boolean deleteById(Table table,
                             Object... idValues)

deleteByField

protected boolean deleteByField(Table table,
                                String field,
                                String value)

update

public boolean update()

Update model.

find

public List<M> find(String tableName,
                    String columns,
                    Row record)

find

protected List<M> find(Config config,
                       Connection conn,
                       String sql,
                       Object... paras)

Find model. 警告：传入的 Connection 参数需要由传入者在 try finally 块中自行 关闭掉，否则将出现 Connection 资源不能及时回收的问题

find

public List<M> find()

find

public List<M> find(Config config,
                    String tableName,
                    Row record)

find

protected List<M> find(Config config,
                       Connection conn,
                       String tableName,
                       String columns,
                       Row record)

find

protected List<M> find(Config config,
                       String sql,
                       Object... paras)

find

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

Find model.

参数:

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

paras - the parameters of sql

返回:

the list of Model

find

public List<M> find(String sql)

另请参阅:

find(String, Object...)

findAll

public List<M> findAll()

findFirst

public M findFirst(String sql,
                   Object... paras)

Find first model. 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

返回:

Model

findFirst

public M findFirst(String sql)

参数:

sql - an SQL statement

另请参阅:

findFirst(String, Object...)

findFirst

public M findFirst()

queryFirst

public <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.

queryLong

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

queryString

public String queryString(String sql,
                          Object... paras)

queryInt

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

existsBySql

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

existsById

public boolean existsById(Object... paras)

exists

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

query

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

findColumnsFirst

public M findColumnsFirst(String columns)

findFirst

public M findFirst(String tableName,
                   String columns,
                   Row record)

findFirst

public M findFirst(String tableName,
                   Row record)

findById

public M findById(Object idValue)

Find model by id.

 Example:
 User user = User.dao.findById(123);
 

参数:

idValue - the id value of the model

findByIds

public M findByIds(Object... idValues)

Find model by composite id values.

 Example:
 User user = User.dao.findByIds(123, 456);
 

参数:

idValues - the composite id values of the model

findByIdLoadColumns

public M findByIdLoadColumns(Object idValue,
                             String columns)

Find model by id and load specific columns only.

 Example:
 User user = User.dao.findByIdLoadColumns(123, "name, age");
 

参数:

idValue - the id value of the model

columns - the specific columns to load

findByIdLoadColumns

public M findByIdLoadColumns(Object[] idValues,
                             String columns)

Find model by composite id values and load specific columns only.

 Example:
 User user = User.dao.findByIdLoadColumns(new Object[]{123, 456}, "name, age");
 

参数:

idValues - the composite id values of the model

columns - the specific columns to load

remove

public M remove(String attr)

Remove attribute of this model.

参数:

attr - the attribute name of the model

返回:

this model

remove

public M remove(String... attrs)

Remove attributes of this model.

参数:

attrs - the attribute names of the model

返回:

this model

removeNullValueAttrs

public M removeNullValueAttrs()

Remove attributes if it is null.

返回:

this model

keep

public M keep(String... attrs)

Keep attributes of this model and remove other attributes.

参数:

attrs - the attribute names of the model

返回:

this model

keep

public M keep(String attr)

Keep attribute of this model and remove other attributes.

参数:

attr - the attribute name of the model

返回:

this model

clear

public M clear()

Remove all attributes of this model.

返回:

this model

toString

public String toString()

覆盖:

toString 在类中 Object

equals

public boolean equals(Object o)

覆盖:

equals 在类中 Object

hashCode

public int hashCode()

覆盖:

hashCode 在类中 Object

findByCache

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

Find model by cache.

参数:

cacheName - the cache name

key - the key used to get data from cache

返回:

the list of Model

另请参阅:

find(String, Object...)

findByCache

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

另请参阅:

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

findFirstByCache

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

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

参数:

cacheName - the cache name

key - the key used to get data from cache

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

paras - the parameters of sql

另请参阅:

findFirst(String, Object...)

findFirstByCache

public M findFirstByCache(String cacheName,
                          Object key,
                          String sql)

另请参阅:

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

paginateByCache

public com.litongjava.model.page.Page<M> paginateByCache(String cacheName,
                                                         Object key,
                                                         int pageNumber,
                                                         int pageSize,
                                                         String select,
                                                         String sqlExceptSelect,
                                                         Object... paras)

Paginate by cache.

参数:

cacheName - the cache name

key - the key used to get date from cache

返回:

Page

另请参阅:

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

paginateByCache

public com.litongjava.model.page.Page<M> paginateByCache(String cacheName,
                                                         Object key,
                                                         int pageNumber,
                                                         int pageSize,
                                                         String select,
                                                         String sqlExceptSelect)

另请参阅:

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

paginateByCache

public com.litongjava.model.page.Page<M> paginateByCache(String cacheName,
                                                         Object key,
                                                         int pageNumber,
                                                         int pageSize,
                                                         boolean isGroupBySql,
                                                         String select,
                                                         String sqlExceptSelect,
                                                         Object... paras)

doPaginateByCache

protected com.litongjava.model.page.Page<M> doPaginateByCache(String cacheName,
                                                              Object key,
                                                              int pageNumber,
                                                              int pageSize,
                                                              Boolean isGroupBySql,
                                                              String select,
                                                              String sqlExceptSelect,
                                                              Object... paras)

getSql

public String getSql(String key)

getSqlPara

public com.litongjava.db.SqlPara getSqlPara(String key,
                                            Map data)

可以在模板中利用 Model 自身的属性参与动态生成 sql，例如： select * from user where nickName = #(nickName) new Account().setNickName("James").getSqlPara(...) 注意：由于 dao 对象上的 attrs 不允许读写，不要调用其 getSqlPara(String) 方法 public SqlPara getSqlPara(String key) { return getSqlPara(key, this.attrs); }

getSqlPara

public com.litongjava.db.SqlPara getSqlPara(String key,
                                            Object... paras)

getSqlPara

public com.litongjava.db.SqlPara getSqlPara(String key,
                                            Model model)

getSqlParaByString

public com.litongjava.db.SqlPara getSqlParaByString(String content,
                                                    Map data)

getSqlParaByString

public com.litongjava.db.SqlPara getSqlParaByString(String content,
                                                    Object... paras)

getSqlParaByString

public com.litongjava.db.SqlPara getSqlParaByString(String content,
                                                    Model model)

find

public List<M> find(com.litongjava.db.SqlPara sqlPara)

findFirst

public M findFirst(com.litongjava.db.SqlPara sqlPara)

paginate

public com.litongjava.model.page.Page<M> paginate(int pageNumber,
                                                  int pageSize,
                                                  com.litongjava.db.SqlPara sqlPara)

paginate

public com.litongjava.model.page.Page<M> paginate(int pageNumber,
                                                  int pageSize,
                                                  boolean isGroupBySql,
                                                  com.litongjava.db.SqlPara sqlPara)

each

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

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

 例子：
 Db.each(model -> {
    // 处理 model 的代码在此

    // 返回 true 继续循环处理下一条数据，返回 false 立即终止循环
    return true;
 }, sql, paras);
 

template

public DaoTemplate<M> template(String key,
                               Map data)

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

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

template

public DaoTemplate<M> template(String key,
                               Object... paras)

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

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

template

public DaoTemplate<M> template(String key,
                               Model model)

templateByString

public DaoTemplate<M> templateByString(String content,
                                       Map data)

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

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

templateByString

public DaoTemplate<M> templateByString(String content,
                                       Object... paras)

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

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

templateByString

public DaoTemplate<M> templateByString(String content,
                                       Model model)

toMap

public Map<String,Object> toMap()

指定者:

toMap 在接口中 com.litongjava.model.db.IRow<M extends Model>

size

public int size()

指定者:

size 在接口中 com.litongjava.model.db.IRow<M extends Model>