Interface ExtService<T extends Serializable>

Type Parameters:
T - 实体类型，必须实现Serializable接口
All Known Subinterfaces:
EntityService<T>, IdEntityService<T>, IdNameEntityService<T>, NameEntityService<T>
All Known Implementing Classes:
BaseService, IdBaseService, IdNameBaseService, NameBaseService
public interface ExtService<T extends Serializable>
扩展服务接口，提供通用的数据库操作方法。
Author:
kerbores(kerbores@gmail.com)

  • Field Details

  • Method Details

    • dao

      org.nutz.dao.Dao dao()
      获取dao实例
      Returns:
      dao实例

    • query

      List<T> query(org.nutz.dao.Condition cnd)
      根据条件查询列表
      Parameters:
      cnd - 条件
      Returns:
      数据列表

    • getEntityType

      Class<T> getEntityType()
      获取泛型类型class
      Returns:
      泛型class

    • clear

      int clear(org.nutz.dao.Condition cnd)
      根据条件删除
      Parameters:
      cnd - 条件
      Returns:
      删除的数据记录数

    • getEntity

      org.nutz.dao.entity.Entity<T> getEntity()
      获取泛型的Entity描述
      Returns:
      Entity描述

    • query

      List<T> query(org.nutz.dao.Condition cnd, org.nutz.dao.pager.Pager pager)
      根据条件进行分页查询
      Parameters:
      cnd - 条件
      pager - 分页
      Returns:
      数据列表

    • count

      int count(org.nutz.dao.Condition cnd)
      根据条件进行计数
      Parameters:
      cnd - 条件
      Returns:
      数量

    • getDefaultPageSize

      default int getDefaultPageSize()
      默认分页大小
      Returns:
      分页大小,默认15

    • insert

      default T insert(T t)
      保存实体
      Parameters:
      t - 待保存实体
      Returns:
      保存后的实体, 根据配置可能将产生 id 等其他属性

    • insert

      default List<T> insert(List<T> ts)
      保存数据
      Parameters:
      ts - 数据列表
      Returns:
      存入后的数据列表,结果返回 @see Dao.fastInsert(Object)

    • save

      default T save(T obj, org.nutz.dao.FieldFilter filter)
      保存对象指定字段
      Parameters:
      obj - 待保存对象
      filter - 字段过滤器
      Returns:
      保存后的对象

    • save

      default void save(String tableName, org.nutz.dao.Chain chain)
      保存
      Parameters:
      tableName - 表名
      chain - 数据链

    • save

      default void save(Class<?> classOfT, org.nutz.dao.Chain chain)
      保存
      Parameters:
      classOfT - 类
      chain - 数据链

    • save

      default T save(T t, boolean ignoreNull, boolean ignoreZero, boolean ignoreBlankStr)
      保存
      Parameters:
      t - 数据对象
      ignoreNull - 是否忽略空值
      ignoreZero - 是否忽略零值
      ignoreBlankStr - 是否忽略空字符串
      Returns:
      保存后的对象

    • insertWith

      default T insertWith(T obj, String regex)
      保存指定字段
      Parameters:
      obj - 待保存对象
      regex - 字段正则
      Returns:
      保存后的对象

    • insertLinks

      default T insertLinks(T obj, String regex)
      保存关联数据
      Parameters:
      obj - 对象
      regex - 管理字段正则
      Returns:
      保存后的对象

    • insertRelation

      default T insertRelation(T obj, String regex)
      插入中间表
      Parameters:
      obj - 对象
      regex - 正则
      Returns:
      保存后的对象

    • all

      default List<T> all()
      查询全部
      Returns:
      对象列表

    • list

      default List<T> list(org.nutz.dao.Condition cnd)
      根据条件查询
      Parameters:
      cnd - 条件
      Returns:
      对象列表

    • list

      default List<T> list(org.nutz.dao.Condition condition, int currentPage, int pageSize)
      分页查询
      Parameters:
      condition - 条件
      currentPage - 当前页码
      pageSize - 页面大小
      Returns:
      对象列表

    • list

      default List<T> list(org.nutz.dao.Condition condition, int currentPage)
      分页查询
      Parameters:
      condition - 条件
      currentPage - 页码
      Returns:
      对象列表

    • list

      default List<T> list(org.nutz.dao.sql.Sql sql)
      执行sql并返回对象列表
      Parameters:
      sql - 待执行sql
      Returns:
      对象列表

    • list

      default <E> List<E> list(org.nutz.dao.sql.Sql sql, Class<E> clazz)
      执行sql并返回对象列表
      Type Parameters:
      E - 类型泛型
      Parameters:
      sql - 待执行sql
      clazz - 返回的类型
      Returns:
      对象列表

    • listAsRecord

      default List<Record> listAsRecord(org.nutz.dao.sql.Sql sql)
      执行sql并返回记录列表
      Parameters:
      sql - 待执行sql
      Returns:
      数据记录列表

    • listAsString

      default List<String> listAsString(org.nutz.dao.sql.Sql sql)
      执行sql并返回单个字符串字段列表
      Parameters:
      sql - 待执行sql
      Returns:
      字符串列表

    • listAsInteger

      default List<Integer> listAsInteger(org.nutz.dao.sql.Sql sql)
      执行sql并返回单个Integer字段列表
      Parameters:
      sql - 待执行sql
      Returns:
      Integer列表

    • listAsLong

      default List<Long> listAsLong(org.nutz.dao.sql.Sql sql)
      执行sql并返回单个Long字段列表
      Parameters:
      sql - 待执行sql
      Returns:
      Long列表

    • listAsBoolean

      default List<Boolean> listAsBoolean(org.nutz.dao.sql.Sql sql)
      执行sql并返回单个Boolean字段列表
      Parameters:
      sql - 待执行sql
      Returns:
      Boolean列表

    • listAsMap

      default List<org.nutz.lang.util.NutMap> listAsMap(org.nutz.dao.sql.Sql sql)
      执行sql并返回map列表,列别名作为key
      Parameters:
      sql - 待执行sql
      Returns:
      数据记录列表

    • fetchByField

      default T fetchByField(String field, Object value)
      根据指定字段查询(仅限唯一属性,非唯一属性返回第一个满足条件的数据)
      Parameters:
      field - 字段
      value - 值
      Returns:
      单个对象

    • fetchAsRecord

      default Record fetchAsRecord(org.nutz.dao.sql.Sql sql)
      执行sql并返回记录
      Parameters:
      sql - 待执行sql
      Returns:
      数据记录对象

    • fetch

      default T fetch(org.nutz.dao.sql.Sql sql)
      执行sql并返回对象
      Parameters:
      sql - 待执行sql
      Returns:
      数据对象

    • fetch

      default <E> E fetch(org.nutz.dao.sql.Sql sql, Class<E> clazz)
      执行sql并返回对象
      Type Parameters:
      E - 对象类型
      Parameters:
      sql - 待执行sql
      clazz - 类型
      Returns:
      数据对象

    • executDeleteOrUpdateSql

      default int executDeleteOrUpdateSql(org.nutz.dao.sql.Sql sql)
      执行删除或者更新语句
      Parameters:
      sql - 待执行sql
      Returns:
      如果当前语句为 DELETE | UPDATE | INSERT，返回执行后所影响的记录数。否则返回 -1

    • executCountSql

      default int executCountSql(org.nutz.dao.sql.Sql sql)
      执行count sql
      Parameters:
      sql - 待执行sql,请确保sql为count且仅返回一列count数
      Returns:
      数量

    • searchByPage

      default Pagination<T> searchByPage(int page)
      分页查询
      Parameters:
      page - 页码
      Returns:
      分页数据对象

    • searchByPage

      default Pagination<T> searchByPage(int page, org.nutz.dao.Condition condition)
      分页查询
      Parameters:
      page - 页码
      condition - 条件
      Returns:
      分页对象

    • searchByPage

      default Pagination<T> searchByPage(int page, int pageSize, org.nutz.dao.Condition condition)
      根据条件分页查询
      Parameters:
      page - 页码
      pageSize - 页面大小
      condition - 条件
      Returns:
      分页数据对象

    • searchByPage

      default Pagination<T> searchByPage(int page, OrderBy orderBy)
      分页查询,带排序
      Parameters:
      page - 页码
      orderBy - 排序
      Returns:
      分页数据对象

    • searchByPage

      default Pagination<T> searchByPage(int page, int pageSize, OrderBy orderBy)
      分页查询,带排序
      Parameters:
      page - 页码
      pageSize - 分页大小
      orderBy - 排序
      Returns:
      分页数据对象

    • searchByPage

      default Pagination<T> searchByPage(int page, org.nutz.dao.Cnd cnd, OrderBy orderBy)
      分页查询,带排序
      Parameters:
      page - 页码
      cnd - 条件
      orderBy - 排序条件
      Returns:
      分页数据对象

    • searchByPage

      default Pagination<T> searchByPage(int page, int pageSize, org.nutz.dao.Cnd cnd, OrderBy orderBy)
      根据条件分页查询,带排序
      Parameters:
      page - 页码
      pageSize - 页面大小
      cnd - 查询条件
      orderBy - 排序
      Returns:
      分页数据对象

    • searchByKeyAndPage

      default Pagination<T> searchByKeyAndPage(String key, int page, org.nutz.dao.Cnd cnd, String... fields)
      根据条件及关键词进行分页查询
      Parameters:
      key - 关键词
      page - 页码
      cnd - 条件
      fields - 关键词匹配的字段列表
      Returns:
      分页数据对象

    • searchByKeyAndPage

      default Pagination<T> searchByKeyAndPage(String key, int page, int pageSize, org.nutz.dao.Cnd cnd, String... fields)
      根据条件及关键词进行分页查询
      Parameters:
      key - 关键词
      page - 页码
      pageSize - 页面大小
      cnd - 条件
      fields - 关键词匹配的字段列表
      Returns:
      分页数据对象

    • searchByKeyAndPage

      default Pagination<T> searchByKeyAndPage(String key, int page, OrderBy orderBy, String... fields)
      根据条件及关键词进行分页查询,带排序
      Parameters:
      key - 关键词
      page - 页码
      orderBy - 排序
      fields - 关键词匹配的字段列表
      Returns:
      页数据对象

    • searchByKeyAndPage

      default Pagination<T> searchByKeyAndPage(String key, int page, org.nutz.dao.Cnd cnd, OrderBy orderBy, String... fields)
      根据条件及关键词进行分页查询,带排序
      Parameters:
      key - 关键词
      page - 页码
      cnd - 查询条件
      orderBy - 排序
      fields - 关键词匹配的字段列表
      Returns:
      页数据对象

    • searchByKeyAndPage

      default Pagination<T> searchByKeyAndPage(int page, int pageSize, OrderBy orderBy, String key, String... fields)
      根据条件及关键词进行分页查询,带排序
      Parameters:
      page - 页码
      pageSize - 分页大小
      orderBy - 排序
      key - 关键词
      fields - 关键词匹配的字段列表
      Returns:
      页数据对象

    • searchByKeyAndPage

      default Pagination<T> searchByKeyAndPage(String key, int page, int pageSize, org.nutz.dao.Cnd cnd, OrderBy orderBy, String... fields)
      根据条件及关键词进行分页查询,带排序
      Parameters:
      key - 关键词
      page - 页码
      pageSize - 分页大小
      cnd - 查询条件
      orderBy - 排序
      fields - 关键词匹配的字段列表
      Returns:
      页数据对象

    • searchByKeyAndPage

      default Pagination<T> searchByKeyAndPage(String key, int page, int pageSize, org.nutz.dao.Condition condition)
      根据关键字和分页条件进行搜索
      Parameters:
      key - 搜索关键字
      page - 页码，从1开始
      pageSize - 每页大小
      condition - 搜索条件
      Returns:
      分页搜索结果

    • searchByKeyAndPage

      default Pagination<T> searchByKeyAndPage(String key, int page, int pageSize, String... fields)
      关键词搜索
      Parameters:
      key - 关键词
      page - 页码
      pageSize - 页面大小
      fields - 检索字段列表
      Returns:
      分页对象

    • searchByKeyAndPage

      default Pagination<T> searchByKeyAndPage(String key, int page, String... fields)
      关键词搜索
      Parameters:
      key - 关键词
      page - 页码
      fields - 检索字段列表
      Returns:
      分页对象

    • update

      default int update(T obj)
      更新对象
      Parameters:
      obj - 待更新对象
      Returns:
      影响的记录条数

    • updateFields

      default int updateFields(T obj, String regex)
      更新字段的指定字段
      Parameters:
      obj - 待更新对象
      regex - 字段正则
      Returns:
      影响的记录条数

    • updateIgnoreNull

      default int updateIgnoreNull(T obj)
      更新对象的非空字段
      Parameters:
      obj - 待更新对象
      Returns:
      影响的记录条数

    • updateWith

      default T updateWith(T obj, String regex)
      使用正则表达式更新对象
      Parameters:
      obj - 需要更新的对象
      regex - 用于匹配更新条件的正则表达式
      Returns:
      更新后的对象

    • updateLinks

      default T updateLinks(T obj, String regex)
      更新对象的链接信息
      Parameters:
      obj - 需要更新链接的对象
      regex - 用于匹配和更新链接的正则表达式
      Returns:
      更新后的对象

    • update

      default boolean update(T t, String... fields)
      更新对象的指定字段,使用id或者主键作为条件
      Parameters:
      t - 待更新对象
      fields - 字段列表
      Returns:
      是否更新成功

    • makeChain

      default org.nutz.dao.Chain makeChain(T t, String[] fields)
      创建一个链式对象，用于处理实体对象的字段匹配和数据访问操作
      Parameters:
      t - 实体对象，用于创建链式对象的数据源
      fields - 字段数组，指定需要匹配的字段名称
      Returns:
      Chain 链式对象，封装了实体对象、字段匹配器和数据访问对象的功能

    • getCnd

      default org.nutz.dao.Condition getCnd(T t)
      根据对象获取查询条件
      Parameters:
      t - 输入的对象实例
      Returns:
      返回基于对象ID字段或Name字段构建的等于条件

    • update

      default int update(T t, org.nutz.dao.Condition cnd, String... fields)
      根据条件更新数据
      Parameters:
      t - 更新目标数据样本
      cnd - 条件
      fields - 待更新的字段列表
      Returns:
      影响的记录条数

    • update

      default int update(T t, org.nutz.dao.Condition cnd)
      根据条件更新数据
      Parameters:
      t - 更新目标数据样本
      cnd - 条件
      Returns:
      影响的记录条数

    • clear

      default int clear()
      清除全部数据
      Returns:
      记录条数

    • clearLinks

      default T clearLinks(T obj, String regex)
      删除关联数据
      Parameters:
      obj - 对象
      regex - 正则
      Returns:
      是否删除成功

    • delete

      default int delete(T obj)
      删除对象
      Parameters:
      obj - 待删除对象
      Returns:
      影响的记录条数

    • deleteWith

      default int deleteWith(T obj, String regex)
      根据正则表达式删除关联对象
      Parameters:
      obj - 主对象
      regex - 正则表达式，用于匹配需要删除的关联属性
      Returns:
      影响的记录条数

    • deleteLinks

      default int deleteLinks(T obj, String regex)
      删除对象的关联链接
      Parameters:
      obj - 需要删除链接的对象实例
      regex - 用于匹配链接的正则表达式
      Returns:
      删除的链接数量

    • createSql

      default org.nutz.dao.sql.Sql createSql(String key)
      创建sql对象
      Parameters:
      key - sqlManager中的sql key
      Returns:
      Sql 对象

    • sql

      default org.nutz.dao.sql.Sql sql(String key)
      创建sql对象
      Parameters:
      key - sqlManager中的sql key
      Returns:
      Sql 对象

    • entity

      default <E> org.nutz.dao.entity.Entity<E> entity(Class<E> clazz)
      获取entity
      Type Parameters:
      E - 类型
      Parameters:
      clazz - entity字节码
      Returns:
      entity实例

    • excute

      default org.nutz.dao.sql.Sql excute(org.nutz.dao.sql.Sql sql)
      执行sql
      Parameters:
      sql - 待执行sql
      Returns:
      执行后的sql对象

    • max

      default int max(String field, org.nutz.dao.Cnd condition)
      最大值
      Parameters:
      field - 字段
      condition - 条件
      Returns:
      满足条件的字段最大值

    • min

      default int min(String field, org.nutz.dao.Cnd condition)
      最小值
      Parameters:
      field - 字段
      condition - 条件
      Returns:
      满足条件的字段最小值

    • avg

      default int avg(String field, org.nutz.dao.Cnd condition)
      平均值
      Parameters:
      field - 字段
      condition - 条件
      Returns:
      满足条件的字段平均值

    • sum

      default int sum(String field, org.nutz.dao.Cnd condition)
      求和
      Parameters:
      field - 字段
      condition - 条件
      Returns:
      满足条件的字段求和值

    • max

      default int max(String field)
      最大值
      Parameters:
      field - 字段
      Returns:
      字段最大值

    • min

      default int min(String field)
      最小值
      Parameters:
      field - 字段
      Returns:
      字段最小值

    • avg

      default int avg(String field)
      平均值
      Parameters:
      field - 字段
      Returns:
      字段平均值

    • sum

      default int sum(String field)
      求和
      Parameters:
      field - 字段
      Returns:
      字段求和值