|
|||||||||
上一个类 下一个类 | 框架 无框架 | ||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
public interface Dao
Nutz.Dao 核心接口。 封装了所有的数据库操作
方法摘要 | ||
---|---|---|
int |
clear(java.lang.Class<?> classOfT)
清除对象所有的记录 |
|
int |
clear(java.lang.Class<?> classOfT,
Condition cnd)
根据一个 WHERE 条件,清除一组对象。 |
|
int |
clear(java.lang.String tableName)
清除数据表所有记录 |
|
int |
clear(java.lang.String tableName,
Condition cnd)
根据一个 WHERE 条件,清除一组记录 |
|
|
clearLinks(T obj,
java.lang.String regex)
根据正则表达式,清除对象的关联。 |
|
int |
count(java.lang.Class<?> classOfT)
计算某个对象在数据库中有多少条记录 |
|
int |
count(java.lang.Class<?> classOfT,
Condition cnd)
根据条件,计算某个对象在数据库中有多少条记录 |
|
int |
count(java.lang.String tableName)
计算某个数据表或视图中有多少条记录 |
|
int |
count(java.lang.String tableName,
Condition cnd)
根据条件,计算某个数据表或视图中有多少条记录 |
|
|
create(java.lang.Class<T> classOfT,
boolean dropIfExists)
根据一个实体的配置信息为其创建一张表 |
|
Pager |
createPager(int pageNumber,
int pageSize)
根据数据源的类型,创建一个翻页对象 |
|
int |
delete(java.lang.Class<?> classOfT,
long id)
根据对象 ID 删除一个对象。 |
|
int |
delete(java.lang.Class<?> classOfT,
java.lang.String name)
根据对象 Name 删除一个对象。 |
|
int |
delete(java.lang.Object obj)
自动判断如何删除一个对象。 |
|
int |
deleteLinks(java.lang.Object obj,
java.lang.String regex)
根据一个正则表达式,仅删除对象所有的关联字段,并不包括对象本身。 |
|
int |
deleteWith(java.lang.Object obj,
java.lang.String regex)
将对象删除的同时,也将符合一个正则表达式的所有关联字段关联的对象统统删除 注意: Java 对象的字段会被保留,这里的删除,将只会删除数据库中的记录 关于关联字段更多信息,请参看 '@One' | '@Many' | '@ManyMany' 更多的描述 |
|
|
deletex(java.lang.Class<T> classOfT,
java.lang.Object... pks)
根据复合主键,删除一个对象。 |
|
boolean |
drop(java.lang.Class<?> classOfT)
如果一个实体的数据表存在,移除它 |
|
boolean |
drop(java.lang.String tableName)
如果一个数据表存在,移除它 |
|
|
each(java.lang.Class<T> classOfT,
Condition cnd,
Each<T> callback)
对一组对象进行迭代,这个接口函数非常适用于很大的数据量的集合,因为你不可能把他们都读到内存里 |
|
|
each(java.lang.Class<T> classOfT,
Condition cnd,
Pager pager,
Each<T> callback)
对一组对象进行迭代,这个接口函数非常适用于很大的数据量的集合,因为你不可能把他们都读到内存里 |
|
int |
each(java.lang.String tableName,
Condition cnd,
Each<Record> callback)
对一组对象进行迭代,这个接口函数非常适用于很大的数据量的集合,因为你不可能把他们都读到内存里 |
|
int |
each(java.lang.String tableName,
Condition cnd,
Pager pager,
Each<Record> callback)
对一组对象进行迭代,这个接口函数非常适用于很大的数据量的集合,因为你不可能把他们都读到内存里 |
|
void |
execute(Sql... sqls)
执行一组 Sql,这些 Sql 将会一起被提交 |
|
boolean |
exists(java.lang.Class<?> classOfT)
|
|
boolean |
exists(java.lang.String tableName)
|
|
|
fastInsert(T obj)
快速插入一个对象。 |
|
|
fetch(java.lang.Class<T> classOfT)
随便获取一个对象。 |
|
|
fetch(java.lang.Class<T> classOfT,
Condition cnd)
根据 WHERE 条件获取一个对象。 |
|
|
fetch(java.lang.Class<T> classOfT,
long id)
根据对象 ID 获取一个对象。 |
|
|
fetch(java.lang.Class<T> classOfT,
java.lang.String name)
根据对象 Name 获取一个对象。 |
|
Record |
fetch(java.lang.String tableName,
Condition cnd)
根据条件获取一个 Record 对象 |
|
|
fetch(T obj)
根据一个参考对象自动判断如何获取一个对象。 |
|
|
fetchLinks(T obj,
java.lang.String regex)
根据一个正则表达式,获取对象所有的关联字段 |
|
|
fetchx(java.lang.Class<T> classOfT,
java.lang.Object... pks)
根据复合主键,获取一个对象。 |
|
int |
func(java.lang.Class<?> classOfT,
java.lang.String funcName,
java.lang.String fieldName)
对某一个对象字段,进行计算。 |
|
int |
func(java.lang.Class<?> classOfT,
java.lang.String funcName,
java.lang.String fieldName,
Condition cnd)
对某一个对象字段,进行计算。 |
|
int |
func(java.lang.String tableName,
java.lang.String funcName,
java.lang.String colName)
对某一个数据表字段,进行计算。 |
|
int |
func(java.lang.String tableName,
java.lang.String funcName,
java.lang.String colName,
Condition cnd)
对某一个数据表字段,进行计算。 |
|
|
getEntity(java.lang.Class<T> classOfT)
|
|
int |
getMaxId(java.lang.Class<?> classOfT)
获取某个对象,最大的 ID 值。 |
|
|
getObject(java.lang.Class<T> classOfT,
java.sql.ResultSet rs,
FieldMatcher fm)
从一个 ResultSet 中获取一个对象。 |
|
void |
insert(java.lang.Class<?> classOfT,
Chain chain)
与 insert(String tableName, Chain chain) 一样,不过,数据表名,将取自 POJO 的数据表声明,请参看 '@Table' 注解的详细说明 |
|
void |
insert(java.lang.String tableName,
Chain chain)
自由的向一个数据表插入一条数据。 |
|
|
insert(T obj)
将一个对象插入到一个数据源。 |
|
|
insertLinks(T obj,
java.lang.String regex)
根据一个正则表达式,仅将对象所有的关联字段插入到数据库中,并不包括对象本身 |
|
|
insertRelation(T obj,
java.lang.String regex)
将对象的一个或者多个,多对多的关联信息,插入数据表 |
|
|
insertWith(T obj,
java.lang.String regex)
将对象插入数据库同时,也将符合一个正则表达式的所有关联字段关联的对象统统插入相应的数据库 关于关联字段更多信息,请参看 '@One' | '@Many' | '@ManyMany' 更多的描述 |
|
DatabaseMeta |
meta()
|
|
|
query(java.lang.Class<T> classOfT,
Condition cnd)
查询一组对象。 |
|
|
query(java.lang.Class<T> classOfT,
Condition cnd,
Pager pager)
查询一组对象。 |
|
java.util.List<Record> |
query(java.lang.String tableName,
Condition cnd)
查询出一组记录。 |
|
java.util.List<Record> |
query(java.lang.String tableName,
Condition cnd,
Pager pager)
查询出一组记录。 |
|
void |
run(ConnCallback callback)
这个方法试图给你最大的灵活性,因为你的 ConnCallback 实现类将得到一个 Connection 接口 的实例。 |
|
SqlManager |
sqls()
|
|
int |
update(java.lang.Class<?> classOfT,
Chain chain,
Condition cnd)
与 update(String tableName, Chain chain, Condition cnd) 一样,不过,数据表名,将取自 POJO 的数据表声明,请参看 '@Table' 注解的详细说明 |
|
int |
update(java.lang.Object obj)
更新一个对象。 |
|
int |
update(java.lang.Object obj,
java.lang.String regex)
更新对象一部分字段 |
|
int |
update(java.lang.String tableName,
Chain chain,
Condition cnd)
自由的更新多条数据 |
|
int |
updateIgnoreNull(java.lang.Object obj)
更新一个对象,并且忽略所有非 null 字段。 |
|
|
updateLinks(T obj,
java.lang.String regex)
根据一个正则表达式,仅更新对象所有的关联字段,并不包括对象本身 |
|
int |
updateRelation(java.lang.Class<?> classOfT,
java.lang.String regex,
Chain chain,
Condition cnd)
多对多关联是通过一个中间表将两条数据表记录关联起来。 |
|
|
updateWith(T obj,
java.lang.String regex)
将对象更新的同时,也将符合一个正则表达式的所有关联字段关联的对象统统更新 关于关联字段更多信息,请参看 '@One' | '@Many' | '@ManyMany' 更多的描述 |
方法详细信息 |
---|
DatabaseMeta meta()
SqlManager sqls()
SqlManager
void execute(Sql... sqls)
sqls
- 要被执行的 Sql 数组void run(ConnCallback callback)
如果你从当前连接对象中创建了ResultSet对象或者 Statement对象,请自行关闭。Nutz.Dao 的原则是:
callback
- <T> T getObject(java.lang.Class<T> classOfT, java.sql.ResultSet rs, FieldMatcher fm)
因为 Dao 接口可以知道一个 POJO 的映射细节,这个函数可以帮你节省一点体力。
classOfT
- 对象类型rs
- 结果集fm
- 字段过滤器
<T> T insert(T obj)
声明了 '@Id'的字段会在插入数据库时被忽略,因为数据库会自动为其设值。如果想手动设置,请设置 '@Id(auto=false)'
插入之前,会检查声明了 '@Default(@SQL("SELECT ..."))' 的字段,预先执行 SQL 为字段设置。
插入之后,会检查声明了 '@Next(@SQL("SELECT ..."))' 的字段,通过执行 SQL 将值取回
如果你的字段仅仅声明了 '@Id(auto=true)',没有声明 '@Next',则认为你还是想取回插入后最新的 ID 值,因为 自动为你添加类似 @Next(@SQL("SELECT MAX(id) FROM tableName")) 的设置
obj
- 要被插入的对象
它可以是:
Id
,
Default
,
Next
void insert(java.lang.String tableName, Chain chain)
tableName
- 数据表名chain
- 数据名值链void insert(java.lang.Class<?> classOfT, Chain chain)
classOfT
- 实体类型chain
- 数据名值链Table
<T> T fastInsert(T obj)
即,你必须为其设置好值,它会统一采用 batch 的方法插入
obj
- 要被插入的对象
它可以是:
<T> T insertWith(T obj, java.lang.String regex)
关于关联字段更多信息,请参看 '@One' | '@Many' | '@ManyMany' 更多的描述
obj
- 数据对象regex
- 正则表达式,描述了什么样的关联字段将被关注。如果为 null,则表示全部的关联字段都会被插入
One
,
Many
,
ManyMany
<T> T insertLinks(T obj, java.lang.String regex)
obj
- 数据对象regex
- 正则表达式,描述了什么样的关联字段将被关注。如果为 null,则表示全部的关联字段都会被插入
One
,
Many
,
ManyMany
<T> T insertRelation(T obj, java.lang.String regex)
obj
- 对象regex
- 正则表达式,描述了那种多对多关联字段将被执行该操作
ManyMany
int update(java.lang.Object obj)
并且调用这个函数前, 主键的值必须保证是有效,否则会更新失败
这个对象所有的字段都会被更新,即,所有的没有被设值的字段,都会被置成 NULL,如果遇到 NOT NULL 约束,则会引发异常。 如果想有选择的更新个别字段,请使用 org.nutz.dao.FieldFilter
如果仅仅想忽略所有的 null 字段,请使用 updateIgnoreNull 方法更新对象
obj
- 要被更新的对象
它可以是:
FieldFilter
int update(java.lang.Object obj, java.lang.String regex)
obj
- 对象regex
- 正则表达式描述要被更新的字段
int updateIgnoreNull(java.lang.Object obj)
obj
- 要被更新的对象
它可以是:
int update(java.lang.String tableName, Chain chain, Condition cnd)
tableName
- 数据表名chain
- 数据名值链。cnd
- WHERE 条件
int update(java.lang.Class<?> classOfT, Chain chain, Condition cnd)
classOfT
- 实体类型chain
- 数据名值链cnd
- WHERE 条件
Table
<T> T updateWith(T obj, java.lang.String regex)
关于关联字段更多信息,请参看 '@One' | '@Many' | '@ManyMany' 更多的描述
obj
- 数据对象regex
- 正则表达式,描述了什么样的关联字段将被关注。如果为 null,则表示全部的关联字段都会被更新
One
,
Many
,
ManyMany
<T> T updateLinks(T obj, java.lang.String regex)
obj
- 数据对象regex
- 正则表达式,描述了什么样的关联字段将被关注。如果为 null,则表示全部的关联字段都会被更新
One
,
Many
,
ManyMany
int updateRelation(java.lang.Class<?> classOfT, java.lang.String regex, Chain chain, Condition cnd)
而这个中间表可能还有其他的字段,比如描述关联的权重等
这个操作可以让你一次更新某一个对象中多个多对多关联的数据
classOfT
- 对象类型regex
- 正则表达式,描述了那种多对多关联字段将被执行该操作chain
- 针对中间关联表的名值链。cnd
- 针对中间关联表的 WHERE 条件
ManyMany
<T> java.util.List<T> query(java.lang.Class<T> classOfT, Condition cnd, Pager pager)
classOfT
- 对象类型cnd
- WHERE 条件。如果为 null,将获取全部数据,顺序为数据库原生顺序pager
- 翻页信息。如果为 null,则一次全部返回
<T> java.util.List<T> query(java.lang.Class<T> classOfT, Condition cnd)
classOfT
- 对象类型cnd
- WHERE 条件。如果为 null,将获取全部数据,顺序为数据库原生顺序
java.util.List<Record> query(java.lang.String tableName, Condition cnd, Pager pager)
tableName
- 表名 - 格式为 tableName[:idName] 比如 : t_pet 或者
t_pet:id 尤其在 SqlServer2005 的环境下,需要用 t_pet:id 的形式来指明 ID
字段,否则 不能分页cnd
- 条件 - 请注意: 你传入的 Criteria 实现必须考虑到 没有
'Entity>' 传入。即 toSql 函数的参数永远为 null。pager
- 翻页信息
Condition
java.util.List<Record> query(java.lang.String tableName, Condition cnd)
tableName
- 表名 - 格式为 tableName[:idName] 比如 : t_pet 或者
t_pet:id 尤其在 SqlServer2005 的环境下,需要用 t_pet:id 的形式来指明 ID
字段,否则 不能分页cnd
- 条件 - 请注意: 你传入的 Criteria 实现必须考虑到 没有
'Entity>' 传入。即 toSql 函数的参数永远为 null。
Condition
<T> int each(java.lang.Class<T> classOfT, Condition cnd, Pager pager, Each<T> callback)
classOfT
- 对象类型cnd
- WHERE 条件。如果为 null,将获取全部数据,顺序为数据库原生顺序pager
- 翻页信息。如果为 null,则一次全部返回callback
- 处理回调
<T> int each(java.lang.Class<T> classOfT, Condition cnd, Each<T> callback)
classOfT
- 对象类型cnd
- WHERE 条件。如果为 null,将获取全部数据,顺序为数据库原生顺序callback
- 处理回调
int each(java.lang.String tableName, Condition cnd, Pager pager, Each<Record> callback)
tableName
- 表名 - 格式为 tableName[:idName] 比如 : t_pet 或者
t_pet:id 尤其在 SqlServer2005 的环境下,需要用 t_pet:id 的形式来指明 ID
字段,否则 不能分页cnd
- WHERE 条件。如果为 null,将获取全部数据,顺序为数据库原生顺序pager
- 翻页信息。如果为 null,则一次全部返回callback
- 处理回调
int each(java.lang.String tableName, Condition cnd, Each<Record> callback)
tableName
- 表名 - 格式为 tableName[:idName] 比如 : t_pet 或者
t_pet:id 尤其在 SqlServer2005 的环境下,需要用 t_pet:id 的形式来指明 ID
字段,否则 不能分页cnd
- WHERE 条件。如果为 null,将获取全部数据,顺序为数据库原生顺序callback
- 处理回调
int delete(java.lang.Class<?> classOfT, long id)
你的对象必须在某个字段声明了注解 '@Id',否则本操作会抛出一个运行时异常
如果你设定了外键约束,没有正确的清除关联对象会导致这个操作失败
classOfT
- 对象类型id
- 对象 ID
Id
int delete(java.lang.Class<?> classOfT, java.lang.String name)
你的对象必须在某个字段声明了注解 '@Name',否则本操作会抛出一个运行时异常
如果你设定了外键约束,没有正确的清除关联对象会导致这个操作失败
classOfT
- 对象类型name
- 对象 Name
Name
<T> int deletex(java.lang.Class<T> classOfT, java.lang.Object... pks)
classOfT
- pks
- 复合主键需要的参数,必须同 '@PK'中声明的顺序一致int delete(java.lang.Object obj)
如果声明了 '@Id' 则相当于 delete(Class
如果声明了 '@Name',则相当于 delete(Class
如果声明了 '@PK',则 deletex(Class
如果没声明任何上面三个注解,则会抛出一个运行时异常
obj
- 要被删除的对象
int deleteWith(java.lang.Object obj, java.lang.String regex)
注意:
Java 对象的字段会被保留,这里的删除,将只会删除数据库中的记录
关于关联字段更多信息,请参看 '@One' | '@Many' | '@ManyMany' 更多的描述
obj
- 数据对象regex
- 正则表达式,描述了什么样的关联字段将被关注。如果为 null,则表示全部的关联字段都会被删除
One
,
Many
,
ManyMany
int deleteLinks(java.lang.Object obj, java.lang.String regex)
注意:
Java 对象的字段会被保留,这里的删除,将只会删除数据库中的记录
关于关联字段更多信息,请参看 '@One' | '@Many' | '@ManyMany' 更多的描述
obj
- 数据对象regex
- 正则表达式,描述了什么样的关联字段将被关注。如果为 null,则表示全部的关联字段都会被删除
One
,
Many
,
ManyMany
<T> T fetch(java.lang.Class<T> classOfT, long id)
你的对象必须在某个字段声明了注解 '@Id',否则本操作会抛出一个运行时异常
classOfT
- 对象类型id
- 对象 IDId
<T> T fetch(java.lang.Class<T> classOfT, java.lang.String name)
你的对象必须在某个字段声明了注解 '@Name',否则本操作会抛出一个运行时异常
classOfT
- 对象类型name
- 对象 Name
Name
<T> T fetchx(java.lang.Class<T> classOfT, java.lang.Object... pks)
classOfT
- pks
- 复合主键需要的参数,必须同 '@PK'中声明的顺序一致<T> T fetch(java.lang.Class<T> classOfT, Condition cnd)
classOfT
- 对象类型cnd
- WHERE 条件
Condition
,
Name
Record fetch(java.lang.String tableName, Condition cnd)
tableName
- 表名cnd
- 条件
<T> T fetch(java.lang.Class<T> classOfT)
classOfT
- 对象类型
<T> T fetch(T obj)
如果声明了 '@Id' 则相当于 fetch(Class
如果声明了 '@Name',则相当于 fetch(Class
如果声明了 '@PK',则 fetchx(Class
如果没声明任何上面三个注解,则会抛出一个运行时异常
obj
- 参考对象
<T> T fetchLinks(T obj, java.lang.String regex)
obj
- 数据对象regex
- 正则表达式,描述了什么样的关联字段将被关注。如果为 null,则表示全部的关联字段都会被查询
One
,
Many
,
ManyMany
int clear(java.lang.Class<?> classOfT, Condition cnd)
classOfT
- 对象类型cnd
- 查询条件,如果为 null,则全部清除
int clear(java.lang.String tableName, Condition cnd)
tableName
- cnd
-
int clear(java.lang.Class<?> classOfT)
classOfT
- 对象类型
int clear(java.lang.String tableName)
tableName
- 表名
<T> T clearLinks(T obj, java.lang.String regex)
对于 '@One' 和 '@Many',对应的记录将会删除
而 '@ManyMay' 对应的字段,只会清除关联表中的记录
obj
- 数据对象regex
- 正则表达式,描述了什么样的关联字段将被关注。如果为 null,则表示全部的关联字段都会被清除
<T> Entity<T> getEntity(java.lang.Class<T> classOfT)
classOfT
- 对象类型
int count(java.lang.Class<?> classOfT, Condition cnd)
classOfT
- 对象类型cnd
- WHERE 条件
int count(java.lang.Class<?> classOfT)
classOfT
- 对象类型
int count(java.lang.String tableName, Condition cnd)
tableName
- 表名cnd
- WHERE 条件
int count(java.lang.String tableName)
tableName
- 表名
int getMaxId(java.lang.Class<?> classOfT)
classOfT
-
int func(java.lang.Class<?> classOfT, java.lang.String funcName, java.lang.String fieldName)
classOfT
- 对象类型funcName
- 计算函数名,请确保你的数据是支持这个函数的fieldName
- 对象 java 字段名
int func(java.lang.String tableName, java.lang.String funcName, java.lang.String colName)
tableName
- 表名funcName
- 计算函数名,请确保你的数据是支持这个函数的colName
- 数据库字段名
int func(java.lang.Class<?> classOfT, java.lang.String funcName, java.lang.String fieldName, Condition cnd)
classOfT
- 对象类型funcName
- 计算函数名,请确保你的数据是支持这个函数的fieldName
- 对象 java 字段名cnd
- 过滤条件
int func(java.lang.String tableName, java.lang.String funcName, java.lang.String colName, Condition cnd)
tableName
- 表名funcName
- 计算函数名,请确保你的数据是支持这个函数的colName
- 数据库字段名cnd
- 过滤条件
Pager createPager(int pageNumber, int pageSize)
pageNumber
- 第几页 ,从 1 开始。pageSize
- 每页可以有多少条记录
boolean exists(java.lang.Class<?> classOfT)
classOfT
- 对象类型
boolean exists(java.lang.String tableName)
tableName
- 表名
<T> Entity<T> create(java.lang.Class<T> classOfT, boolean dropIfExists)
classOfT
- 实体类型dropIfExists
- 如果表存在是否强制移除
boolean drop(java.lang.Class<?> classOfT)
classOfT
- 实体类型
boolean drop(java.lang.String tableName)
tableName
- 表名
|
|||||||||
上一个类 下一个类 | 框架 无框架 | ||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |