org.nutz.service

Class EntityService<T>

java.lang.Object

org.nutz.service.Service

org.nutz.service.EntityService<T>

Type Parameters:

T - 实体类型

Direct Known Subclasses:

IdEntityService, NameEntityService

public abstract class EntityService<T>
extends Service

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

Author:

wendal(wendal1985@gmail.com)

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
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关联表中的数据

Methods inherited from class org.nutz.service.Service

dao, setDao

Methods inherited from class java.lang.Object

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

Constructor Detail

EntityService

public EntityService()

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

EntityService

public EntityService(Dao dao)

新建并传入Dao实例

Parameters:

dao - Dao实例

EntityService

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

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

Parameters:

dao - Dao实例

entityType - 实体类型

Method Detail

mirror

public Mirror<T> mirror()

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

Returns:

反射封装类实例

setEntityType

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

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

Parameters:

classOfT -

getEntity

public Entity<T> getEntity()

获取实体的Entity

Returns:

实体的Entity

getEntityClass

public Class<T> getEntityClass()

获取实体类型

Returns:

实体类型

clear

public int clear(Condition cnd)

批量删除

Parameters:

cnd - 条件

Returns:

删除的条数

clear

public int clear()

全表删除

Returns:

删除的条数

query

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

根据条件分页查询

Parameters:

cnd - 查询条件

pager - 分页

Returns:

查询结果

each

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

遍历条件分页查询结果

Parameters:

cnd - 查询条件

pager - 分页

callback - 遍历回调

Returns:

遍历的总条数

count

public int count(Condition cnd)

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

Parameters:

cnd - 查询条件

Returns:

记录数

count

public int count()

全表的总记录数

Returns:

总记录数

fetch

public T fetch(Condition cnd)

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

Parameters:

cnd - 查询条件

Returns:

实体,如不存在则为null

fetchx

public T fetchx(Object... pks)

复合主键专用

Parameters:

pks - 键值

Returns:

对象 T

exists

public boolean exists(Object... pks)

复合主键专用

Parameters:

pks - 键值

Returns:

对象 T

update

public int update(Chain chain,
                  Condition cnd)

批量更新

Parameters:

chain - 设置值的键值对

cnd - 需要更新的条件语句

updateRelation

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

更新@ManyMany关联表中的数据

Parameters:

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

chain - 键值对

cnd - 条件语句

deletex

public int deletex(Object... pks)

根据复合主键删除记录

Parameters:

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

Returns:

删除的记录数

create

public Entity<T> create(boolean dropIfExists)

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

Parameters:

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

Returns:

实体对象

insert

public void insert(Chain chain)

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

Parameters:

chain - 数据名值链

query

public List<T> query(Condition cnd)

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

Parameters:

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

Returns:

对象列表

each

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

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

Parameters:

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

callback - 处理回调

Returns:

一共迭代的数量

func

public int func(String funcName,
                String fieldName)

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

Parameters:

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

fieldName - 对象 java 字段名

Returns:

计算结果

func

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

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

Parameters:

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

fieldName - 对象 java 字段名

cnd - 过滤条件

Returns:

计算结果

getObject

public T getObject(ResultSet rs,
                   FieldMatcher fm)

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

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

Parameters:

rs - 结果集

fm - 字段过滤器

Returns:

对象

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

Throws:

Exception

query

public List<T> query()