EntityService (Nutz 1.r.57 API)

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实例,同时指定实体类型

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`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(Condition cnd)` 查询一组对象。
`List<T>`	`query(Condition cnd, Pager pager)` 根据条件分页查询
`<C extends T> void`	`setEntityType(Class<C> classOfT)` 设置新的实体类型, 极少调用
`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)
```

类 EntityService<T>

构造器概要

方法概要

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

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

构造器详细资料

EntityService

EntityService

EntityService

方法详细资料

mirror

setEntityType

getEntity

getEntityClass

clear

clear

query

each

count

count

fetch

fetchx

exists

update

updateRelation

deletex

create

insert

query

each

func

func

getObject

getObject