org.nutz.service

类 EntityService<T>

java.lang.Object

org.nutz.service.Service

org.nutz.service.EntityService<T>

类型参数:

T - 实体类型

直接已知子类:

IdEntityService, NameEntityService

public abstract class EntityService<T>
extends Service

实体Service抽象类. 属于辅助类. 任何方法被调用前,必须确保Dao实例已经传入

作者:

wendal(wendal1985@gmail.com)

构造器概要

构造器

构造器和说明
EntityService() 本抽象类能提供一些帮助方法,减少重复写实体类型的麻烦
EntityService(Dao dao) 新建并传入Dao实例
EntityService(Dao dao, Class<T> entityType) 新建并传入Dao实例,同时指定实体类型

方法概要

限定符和类型	方法和说明
T	_clearLinks(T obj, String regex)
int	_delete(T obj)
int	_deleteLinks(T obj, String regex)
int	_deleteWith(T obj, String regex)
T	_fastInsert(T obj)
T	_fetch(T obj)
T	_fetchLinks(T obj, String regex)
T	_fetchLinks(T obj, String regex, Condition cnd)
T	_insert(T obj)
T	_insert(T t, boolean ignoreNull, boolean ignoreZero, boolean ignoreBlankStr)
T	_insert(T obj, FieldFilter filter)
T	_insertLinks(T obj, String regex)
T	_insertRelation(T obj, String regex)
T	_insertWith(T obj, String regex)
List<T>	_query(Condition cnd, Pager pager, FieldMatcher matcher)
List<T>	_query(Condition cnd, Pager pager, String regex)
int	_update(T obj)
int	_update(T obj, String regex)
int	_updateIgnoreNull(Object obj)
T	_updateLinks(T obj, String regex)
T	_updateWith(T obj, String regex)
int	clear() 全表删除
int	clear(Condition cnd) 批量删除
int	count() 全表的总记录数
int	count(Condition cnd) 根据条件统计符合条件的记录数
Entity<T>	create(boolean dropIfExists) 根据一个实体的配置信息为其创建一张表
int	deletex(Object... pks) 根据复合主键删除记录
int	each(Condition cnd, Each<T> callback) 对一组对象进行迭代，这个接口函数非常适用于很大的数据量的集合，因为你不可能把他们都读到内存里
int	each(Condition cnd, Pager pager, Each<T> callback) 遍历条件分页查询结果
boolean	exists(Object... pks) 复合主键专用
T	fetch(Condition cnd) 查出符合条件的第一条记录
T	fetchx(Object... pks) 复合主键专用
int	func(String funcName, String fieldName) 对某一个对象字段，进行计算。
int	func(String funcName, String fieldName, Condition cnd) 对某一个对象字段，进行计算。
Entity<T>	getEntity() 获取实体的Entity
Class<T>	getEntityClass() 获取实体类型
T	getObject(ResultSet rs, FieldMatcher fm) 从一个 ResultSet 中获取一个对象。
T	getObject(ResultSet rs, FieldMatcher fm, String prefix)
void	insert(Chain chain) 与 insert(String tableName, Chain chain) 一样，不过，数据表名，将取自 POJO 的数据表声明，请参看 '@Table' 注解的详细说明
Mirror<T>	mirror() 获取实体类型的反射封装类实例
List<T>	query()
List<T>	query(Condition cnd) 查询一组对象。
List<T>	query(Condition cnd, Pager pager) 根据条件分页查询
<C extends T> void	setEntityType(Class<C> classOfT) 设置新的实体类型, 极少调用
void	setExpert(T obj)
int	update(Chain chain, Condition cnd) 批量更新
int	updateRelation(String regex, Chain chain, Condition cnd) 更新@ManyMany关联表中的数据

从类继承的方法 org.nutz.service.Service

dao, setDao

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

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

构造器详细资料

EntityService

public EntityService()

本抽象类能提供一些帮助方法,减少重复写实体类型的麻烦

EntityService

public EntityService(Dao dao)

新建并传入Dao实例

参数:

dao - Dao实例

EntityService

public EntityService(Dao dao,
                     Class<T> entityType)

新建并传入Dao实例,同时指定实体类型

参数:

dao - Dao实例

entityType - 实体类型

方法详细资料

mirror

public Mirror<T> mirror()

获取实体类型的反射封装类实例

返回:

反射封装类实例

setEntityType

public <C extends T> void setEntityType(Class<C> classOfT)

设置新的实体类型, 极少调用

参数:

classOfT -

getEntity

public Entity<T> getEntity()

获取实体的Entity

返回:

实体的Entity

getEntityClass

public Class<T> getEntityClass()

获取实体类型

返回:

实体类型

clear

public int clear(Condition cnd)

批量删除

参数:

cnd - 条件

返回:

删除的条数

clear

public int clear()

全表删除

返回:

删除的条数

query

public List<T> query(Condition cnd,
                     Pager pager)

根据条件分页查询

参数:

cnd - 查询条件

pager - 分页

返回:

查询结果

each

public int each(Condition cnd,
                Pager pager,
                Each<T> callback)

遍历条件分页查询结果

参数:

cnd - 查询条件

pager - 分页

callback - 遍历回调

返回:

遍历的总条数

count

public int count(Condition cnd)

根据条件统计符合条件的记录数

参数:

cnd - 查询条件

返回:

记录数

count

public int count()

全表的总记录数

返回:

总记录数

fetch

public T fetch(Condition cnd)

查出符合条件的第一条记录

参数:

cnd - 查询条件

返回:

实体,如不存在则为null

fetchx

public T fetchx(Object... pks)

复合主键专用

参数:

pks - 键值

返回:

对象 T

exists

public boolean exists(Object... pks)

复合主键专用

参数:

pks - 键值

返回:

对象 T

update

public int update(Chain chain,
                  Condition cnd)

批量更新

参数:

chain - 设置值的键值对

cnd - 需要更新的条件语句

updateRelation

public int updateRelation(String regex,
                          Chain chain,
                          Condition cnd)

更新@ManyMany关联表中的数据

参数:

regex - 关联字段的匹配正则表达式,如果为null则代表全部

chain - 键值对

cnd - 条件语句

deletex

public int deletex(Object... pks)

根据复合主键删除记录

参数:

pks - 复合主键,必须按@Pk的声明顺序传入

返回:

删除的记录数

create

public Entity<T> create(boolean dropIfExists)

根据一个实体的配置信息为其创建一张表

参数:

dropIfExists - 如果表存在是否强制移除

返回:

实体对象

insert

public void insert(Chain chain)

与 insert(String tableName, Chain chain) 一样，不过，数据表名，将取自 POJO 的数据表声明，请参看 '@Table' 注解的详细说明

参数:

chain - 数据名值链

query

public List<T> query(Condition cnd)

查询一组对象。你可以为这次查询设定条件

参数:

cnd - WHERE 条件。如果为 null，将获取全部数据，顺序为数据库原生顺序
只有在调用这个函数的时候， cnd.limit 才会生效

返回:

对象列表

each

public int each(Condition cnd,
                Each<T> callback)

对一组对象进行迭代，这个接口函数非常适用于很大的数据量的集合，因为你不可能把他们都读到内存里

参数:

cnd - WHERE 条件。如果为 null，将获取全部数据，顺序为数据库原生顺序

callback - 处理回调

返回:

一共迭代的数量

func

public int func(String funcName,
                String fieldName)

对某一个对象字段，进行计算。

参数:

funcName - 计算函数名，请确保你的数据库是支持这个函数的

fieldName - 对象 java 字段名

返回:

计算结果

func

public int func(String funcName,
                String fieldName,
                Condition cnd)

对某一个对象字段，进行计算。

参数:

funcName - 计算函数名，请确保你的数据库是支持这个函数的

fieldName - 对象 java 字段名

cnd - 过滤条件

返回:

计算结果

getObject

public T getObject(ResultSet rs,
                   FieldMatcher fm)

从一个 ResultSet 中获取一个对象。

因为 Dao 接口可以知道一个 POJO 的映射细节，这个函数可以帮你节省一点体力。

参数:

rs - 结果集

fm - 字段过滤器

返回:

对象

getObject

public T getObject(ResultSet rs,
                   FieldMatcher fm,
                   String prefix)

_query

public List<T> _query(Condition cnd,
                      Pager pager,
                      FieldMatcher matcher)

_query

public List<T> _query(Condition cnd,
                      Pager pager,
                      String regex)

_insert

public T _insert(T obj)

_fastInsert

public T _fastInsert(T obj)

_insert

public T _insert(T obj,
                 FieldFilter filter)

_insert

public T _insert(T t,
                 boolean ignoreNull,
                 boolean ignoreZero,
                 boolean ignoreBlankStr)

_insertWith

public T _insertWith(T obj,
                     String regex)

_insertLinks

public T _insertLinks(T obj,
                      String regex)

_insertRelation

public T _insertRelation(T obj,
                         String regex)

_update

public int _update(T obj)

_update

public int _update(T obj,
                   String regex)

_updateIgnoreNull

public int _updateIgnoreNull(Object obj)

_updateWith

public T _updateWith(T obj,
                     String regex)

_updateLinks

public T _updateLinks(T obj,
                      String regex)

_delete

public int _delete(T obj)

_deleteWith

public int _deleteWith(T obj,
                       String regex)

_deleteLinks

public int _deleteLinks(T obj,
                        String regex)

_fetch

public T _fetch(T obj)

_fetchLinks

public T _fetchLinks(T obj,
                     String regex)

_fetchLinks

public T _fetchLinks(T obj,
                     String regex,
                     Condition cnd)

_clearLinks

public T _clearLinks(T obj,
                     String regex)

setExpert

public void setExpert(T obj)
               throws Exception

抛出:

Exception

query

public List<T> query()