net.ymate.platform.persistence.jdbc

接口 ISession

所有超级接口:

ISessionBase

所有已知实现类:

DefaultSession

public interface ISession
extends ISessionBase

数据库会话操作接口定义

版本:

1.0

作者:

刘镇 (suninformation@163.com) on 2011-9-21 下午01:45:36

方法概要

限定符和类型	方法和说明
<T extends IEntity> long	count(Class<T> entityClass)
<T extends IEntity> long	count(Class<T> entityClass, Where where)
<T extends IEntity> long	count(Class<T> entityClass, Where where, IShardingable shardingable)
long	count(SQL sql)
<T extends IEntity> int	delete(Class<T> entityClass, Serializable id)
<T extends IEntity> int[]	delete(Class<T> entityClass, Serializable[] ids)
<T extends IEntity> int	delete(Class<T> entityClass, Serializable id, IShardingable shardingable)
<T extends IEntity> int[]	delete(Class<T> entityClass, ShardingList<Serializable> ids)
<T extends IEntity> List<T>	delete(List<T> entities)
<T extends IEntity> List<T>	delete(ShardingList<T> entities)
<T extends IEntity> T	delete(T entity)
<T extends IEntity> T	delete(T entity, IShardingable shardingable)
int[]	executeForUpdate(BatchSQL sql)
int	executeForUpdate(SQL sql)
<T extends IEntity> IResultSet<T>	find(EntitySQL<T> entity)
<T extends IEntity> IResultSet<T>	find(EntitySQL<T> entity, IShardingable shardingable)
<T extends IEntity> IResultSet<T>	find(EntitySQL<T> entity, Page page)
<T extends IEntity> IResultSet<T>	find(EntitySQL<T> entity, Page page, IShardingable shardingable)
<T extends IEntity> T	find(EntitySQL<T> entity, Serializable id)
<T extends IEntity> T	find(EntitySQL<T> entity, Serializable id, IShardingable shardingable)
<T extends IEntity> IResultSet<T>	find(EntitySQL<T> entity, Where where)
<T extends IEntity> IResultSet<T>	find(EntitySQL<T> entity, Where where, IShardingable shardingable)
<T extends IEntity> IResultSet<T>	find(EntitySQL<T> entity, Where where, Page page)
<T extends IEntity> IResultSet<T>	find(EntitySQL<T> entity, Where where, Page page, IShardingable shardingable)
<T> IResultSet<T>	find(SQL sql, IResultSetHandler<T> handler)
<T> IResultSet<T>	find(SQL sql, IResultSetHandler<T> handler, Page page)
<T extends IEntity> IResultSet<T>	find(T entity)
<T extends IEntity> IResultSet<T>	find(T entity, Fields filter)
<T extends IEntity> IResultSet<T>	find(T entity, Fields filter, IShardingable shardingable)
<T extends IEntity> IResultSet<T>	find(T entity, Fields filter, Page page)
<T extends IEntity> IResultSet<T>	find(T entity, Fields filter, Page page, IShardingable shardingable)
<T extends IEntity> IResultSet<T>	find(T entity, IShardingable shardingable)
<T extends IEntity> IResultSet<T>	find(T entity, Page page)
<T extends IEntity> IResultSet<T>	find(T entity, Page page, IShardingable shardingable)
<T extends IEntity> T	findFirst(EntitySQL<T> entity)
<T extends IEntity> T	findFirst(EntitySQL<T> entity, IShardingable shardingable)
<T extends IEntity> T	findFirst(EntitySQL<T> entity, Where where)
<T extends IEntity> T	findFirst(EntitySQL<T> entity, Where where, IShardingable shardingable)
<T> T	findFirst(SQL sql, IResultSetHandler<T> handler)
IConnectionHolder	getConnectionHolder()
<T extends IEntity> List<T>	insert(List<T> entities)
<T extends IEntity> List<T>	insert(List<T> entities, Fields filter)
<T extends IEntity> List<T>	insert(ShardingList<T> entities)
<T extends IEntity> List<T>	insert(ShardingList<T> entities, Fields filter)
<T extends IEntity> T	insert(T entity)
<T extends IEntity> T	insert(T entity, Fields filter)
<T extends IEntity> T	insert(T entity, Fields filter, IShardingable shardingable)
<T extends IEntity> T	insert(T entity, IShardingable shardingable)
<T extends IEntity> List<T>	update(List<T> entities, Fields filter)
<T extends IEntity> List<T>	update(ShardingList<T> entities, Fields filter)
<T extends IEntity> T	update(T entity, Fields filter)
<T extends IEntity> T	update(T entity, Fields filter, IShardingable shardingable)

从接口继承的方法 net.ymate.platform.persistence.ISessionBase

close, getId, setSessionEvent

方法详细资料

getConnectionHolder

IConnectionHolder getConnectionHolder()

返回:

获取数据连接对象

find

<T> IResultSet<T> find(SQL sql,
                       IResultSetHandler<T> handler)
                throws Exception

类型参数:

T - 指定结果集数据类型

参数:

sql - SQL语句对象

handler - 结果集数据处理器

返回:

执行SQL查询，返回全部结果数据

抛出:

Exception - 可能产生的异常

find

<T> IResultSet<T> find(SQL sql,
                       IResultSetHandler<T> handler,
                       Page page)
                throws Exception

类型参数:

T - 指定结果集数据类型

参数:

sql - SQL语句对象

handler - 结果集数据处理器

page - 分页参数对象

返回:

执行SQL分页查询（执行总记录数统计）

抛出:

Exception - 可能产生的异常

find

<T extends IEntity> IResultSet<T> find(T entity)
                                throws Exception

类型参数:

T - 指定结果集数据类型

参数:

entity - 实体对象

返回:

根据实体属性值执行SQL查询，返回全部结果数据

抛出:

Exception - 可能产生的异常

find

<T extends IEntity> IResultSet<T> find(T entity,
                                       IShardingable shardingable)
                                throws Exception

抛出:

Exception

find

<T extends IEntity> IResultSet<T> find(T entity,
                                       Page page)
                                throws Exception

抛出:

Exception

find

<T extends IEntity> IResultSet<T> find(T entity,
                                       Page page,
                                       IShardingable shardingable)
                                throws Exception

抛出:

Exception

find

<T extends IEntity> IResultSet<T> find(T entity,
                                       Fields filter)
                                throws Exception

抛出:

Exception

find

<T extends IEntity> IResultSet<T> find(T entity,
                                       Fields filter,
                                       IShardingable shardingable)
                                throws Exception

抛出:

Exception

find

<T extends IEntity> IResultSet<T> find(T entity,
                                       Fields filter,
                                       Page page)
                                throws Exception

抛出:

Exception

find

<T extends IEntity> IResultSet<T> find(T entity,
                                       Fields filter,
                                       Page page,
                                       IShardingable shardingable)
                                throws Exception

抛出:

Exception

find

<T extends IEntity> IResultSet<T> find(EntitySQL<T> entity)
                                throws Exception

类型参数:

T - 指定结果集数据类型

参数:

entity - 实体查询对象

返回:

根据实体执行SQL查询，返回全部结果数据

抛出:

Exception - 可能产生的异常

find

<T extends IEntity> IResultSet<T> find(EntitySQL<T> entity,
                                       IShardingable shardingable)
                                throws Exception

抛出:

Exception

find

<T extends IEntity> IResultSet<T> find(EntitySQL<T> entity,
                                       Page page)
                                throws Exception

抛出:

Exception

find

<T extends IEntity> IResultSet<T> find(EntitySQL<T> entity,
                                       Page page,
                                       IShardingable shardingable)
                                throws Exception

抛出:

Exception

find

<T extends IEntity> IResultSet<T> find(EntitySQL<T> entity,
                                       Where where)
                                throws Exception

类型参数:

T - 指定结果集数据类型

参数:

entity - 实体对象

where - 查询条件对象

返回:

根据实体执行SQL查询，返回全部结果数据

抛出:

Exception - 可能产生的异常

find

<T extends IEntity> IResultSet<T> find(EntitySQL<T> entity,
                                       Where where,
                                       IShardingable shardingable)
                                throws Exception

抛出:

Exception

find

<T extends IEntity> IResultSet<T> find(EntitySQL<T> entity,
                                       Where where,
                                       Page page)
                                throws Exception

类型参数:

T - 指定结果集数据类型

参数:

entity - 实体对象

where - 查询条件对象

page - 分页参数对象

返回:

根据实体执行SQL分页查询

抛出:

Exception - 可能产生的异常

find

<T extends IEntity> IResultSet<T> find(EntitySQL<T> entity,
                                       Where where,
                                       Page page,
                                       IShardingable shardingable)
                                throws Exception

抛出:

Exception

find

<T extends IEntity> T find(EntitySQL<T> entity,
                           Serializable id)
                    throws Exception

类型参数:

T - 指定结果集数据类型

参数:

entity - 实体查询对象

id - 记录Id

返回:

通过ID查找指定的实体对象

抛出:

Exception - 可能产生的异常

find

<T extends IEntity> T find(EntitySQL<T> entity,
                           Serializable id,
                           IShardingable shardingable)
                    throws Exception

抛出:

Exception

findFirst

<T> T findFirst(SQL sql,
                IResultSetHandler<T> handler)
         throws Exception

类型参数:

T - 指定结果集数据类型

参数:

sql - SQL语句对象

handler - 结果集数据处理器

返回:

执行SQL查询，返回结果集中第一条数据

抛出:

Exception - 可能产生的异常

findFirst

<T extends IEntity> T findFirst(EntitySQL<T> entity,
                                Where where)
                         throws Exception

类型参数:

T - 指定结果集数据类型

参数:

entity - 实体查询对象

where - 查询条件对象

返回:

根据实体执行SQL查询，返回结果集中第一条数据

抛出:

Exception - 可能产生的异常

findFirst

<T extends IEntity> T findFirst(EntitySQL<T> entity,
                                Where where,
                                IShardingable shardingable)
                         throws Exception

抛出:

Exception

findFirst

<T extends IEntity> T findFirst(EntitySQL<T> entity)
                         throws Exception

抛出:

Exception

findFirst

<T extends IEntity> T findFirst(EntitySQL<T> entity,
                                IShardingable shardingable)
                         throws Exception

抛出:

Exception

executeForUpdate

int executeForUpdate(SQL sql)
              throws Exception

参数:

sql - SQL语句对象

返回:

执行SQL更新（如更新、插入和删除），返回此次更新影响的记录数

抛出:

Exception - 可能产生的异常

executeForUpdate

int[] executeForUpdate(BatchSQL sql)
                throws Exception

参数:

sql - 批量SQL更新语句

返回:

执行SQL批量更新（如批更新、插入和删除），返回此次更新影响的记录数

抛出:

Exception - 可能产生的异常

update

<T extends IEntity> T update(T entity,
                             Fields filter)
                      throws Exception

类型参数:

T - 指定结果集数据类型

参数:

entity - 实体查询对象

filter - 显示字段过滤集合

返回:

根据实体执行SQL更新，返回更新后的实体对象，若影响记录数为0则返回null

抛出:

Exception - 可能产生的异常

update

<T extends IEntity> T update(T entity,
                             Fields filter,
                             IShardingable shardingable)
                      throws Exception

抛出:

Exception

update

<T extends IEntity> List<T> update(List<T> entities,
                                   Fields filter)
                            throws Exception

类型参数:

T - 指定结果集数据类型

参数:

entities - 实体查询对象集合

filter - 显示字段过滤集合

返回:

根据实体执行SQL批量更新，返回更新后的实体对象集合

抛出:

Exception - 可能产生的异常

update

<T extends IEntity> List<T> update(ShardingList<T> entities,
                                   Fields filter)
                            throws Exception

抛出:

Exception

insert

<T extends IEntity> T insert(T entity)
                      throws Exception

类型参数:

T - 指定结果集数据类型

参数:

entity - 实体对象

返回:

根据实体执行记录插入，返回插入后的实体对象，若影响记录数为0则返回null

抛出:

Exception - 可能产生的异常

insert

<T extends IEntity> T insert(T entity,
                             IShardingable shardingable)
                      throws Exception

抛出:

Exception

insert

<T extends IEntity> T insert(T entity,
                             Fields filter)
                      throws Exception

抛出:

Exception

insert

<T extends IEntity> T insert(T entity,
                             Fields filter,
                             IShardingable shardingable)
                      throws Exception

抛出:

Exception

insert

<T extends IEntity> List<T> insert(List<T> entities)
                            throws Exception

类型参数:

T - 指定结果集数据类型

参数:

entities - 实体对象集合

返回:

根据实体执行记录批量插入，返回插入后的实体对象集合

抛出:

Exception - 可能产生的异常

insert

<T extends IEntity> List<T> insert(ShardingList<T> entities)
                            throws Exception

抛出:

Exception

insert

<T extends IEntity> List<T> insert(List<T> entities,
                                   Fields filter)
                            throws Exception

抛出:

Exception

insert

<T extends IEntity> List<T> insert(ShardingList<T> entities,
                                   Fields filter)
                            throws Exception

抛出:

Exception

delete

<T extends IEntity> T delete(T entity)
                      throws Exception

类型参数:

T - 指定结果集数据类型

参数:

entity - 实体对象

返回:

根据实体执行记录删除，返回删除后的实体对象，若影响记录数为0则返回null

抛出:

Exception - 可能产生的异常

delete

<T extends IEntity> T delete(T entity,
                             IShardingable shardingable)
                      throws Exception

抛出:

Exception

delete

<T extends IEntity> int delete(Class<T> entityClass,
                               Serializable id)
                        throws Exception

抛出:

Exception

delete

<T extends IEntity> int delete(Class<T> entityClass,
                               Serializable id,
                               IShardingable shardingable)
                        throws Exception

抛出:

Exception

delete

<T extends IEntity> List<T> delete(List<T> entities)
                            throws Exception

类型参数:

T - 指定结果集数据类型

参数:

entities - 实体对象集合

返回:

根据实体执行记录批量删除，返回删除后的实体对象集合

抛出:

Exception - 可能产生的异常

delete

<T extends IEntity> List<T> delete(ShardingList<T> entities)
                            throws Exception

抛出:

Exception

delete

<T extends IEntity> int[] delete(Class<T> entityClass,
                                 Serializable[] ids)
                          throws Exception

抛出:

Exception

delete

<T extends IEntity> int[] delete(Class<T> entityClass,
                                 ShardingList<Serializable> ids)
                          throws Exception

抛出:

Exception

count

<T extends IEntity> long count(Class<T> entityClass,
                               Where where)
                        throws Exception

类型参数:

T - 指定实体类型

参数:

entityClass - 实体类对象

where - 查询条件对象

返回:

计算查询结果总记录数量

抛出:

Exception - 可能产生的异常

count

<T extends IEntity> long count(Class<T> entityClass)
                        throws Exception

抛出:

Exception

count

<T extends IEntity> long count(Class<T> entityClass,
                               Where where,
                               IShardingable shardingable)
                        throws Exception

抛出:

Exception

count

long count(SQL sql)
    throws Exception

参数:

sql - SQL语句对象

返回:

计算查询结果总记录数量

抛出:

Exception - 可能产生的异常