org.nutz.dao.impl.sql

类 SqlTemplate

java.lang.Object

org.nutz.dao.impl.sql.SqlTemplate

public class SqlTemplate
extends Object

仿照Spring JdbcTemplate实现nutz的SqlTemplate，方便sql的调用

作者:

hzl7652(hzl7652@sina.com)

构造器概要

构造器

构造器和说明
SqlTemplate()
SqlTemplate(Dao dao)

方法概要

限定符和类型	方法和说明
int	batchUpdate(String sql, List<Map<String,Object>> batchValues) 执行SQL批量更新操作（如插入，更新或删除语句）。
int	batchUpdate(String sql, Map<String,Object> vars, List<Map<String,Object>> batchValues) 执行SQL批量更新操作（如插入，更新或删除语句）。
Dao	dao()
<T> List<T>	query(String sql, Map<String,Object> params, Class<T> classOfT) 执行一个SQL查询操作，结果为一组对象。
<T> List<T>	query(String sql, Map<String,Object> params, Entity<T> entity) 执行一个SQL查询操作，结果为一组对象。
<T> List<T>	query(String sql, Map<String,Object> vars, Map<String,Object> params, Entity<T> entity) 执行一个SQL查询操作，结果为一组对象。
int	queryForInt(String sql, Map<String,Object> params) 执行一个SQL查询操作，结果为一个int形数值。
int	queryForInt(String sql, Map<String,Object> vars, Map<String,Object> params) 执行一个SQL查询操作，结果为一个int形数值。
<T> List<T>	queryForList(String sql, Map<String,Object> vars, Map<String,Object> params, Class<T> classOfT) 执行一个SQL查询操作，结果为一组对象。
long	queryForLong(String sql, Map<String,Object> params) 执行一个SQL查询操作，结果为一个long形数值。
long	queryForLong(String sql, Map<String,Object> vars, Map<String,Object> params) 执行一个SQL查询操作，结果为一个long形数值。
<T> T	queryForObject(String sql, Map<String,Object> params, Class<T> classOfT) 执行一个SQL查询操作，结果为给定对象类型的对象，适用于明确SQL查询结果的类型。
<T> T	queryForObject(String sql, Map<String,Object> params, Entity<T> entity) 执行一个SQL查询操作，结果为给定实体的对象。
<T> T	queryForObject(String sql, Map<String,Object> vars, Map<String,Object> params, Class<T> classOfT) 执行一个SQL查询操作，结果为给定对象类型的对象，适用于明确SQL查询结果的类型。
<T> T	queryForObject(String sql, Map<String,Object> vars, Map<String,Object> params, Entity<T> entity) 执行一个SQL查询操作，结果为给定实体的对象。
Record	queryForRecord(String sql, Map<String,Object> params) 执行一个SQL查询操作，结果为Record的对象。
Record	queryForRecord(String sql, Map<String,Object> vars, Map<String,Object> params) 执行一个SQL查询操作，结果为Record的对象。
List<Record>	queryRecords(String sql, Map<String,Object> vars, Map<String,Object> params) 执行一个SQL查询操作，结果为Record对象列表。
void	setDao(Dao dao)
int	update(String sql, Map<String,Object> params) 执行一个SQL更新操作（如插入，更新或删除语句）。
int	update(String sql, Map<String,Object> vars, Map<String,Object> params) 执行一个SQL更新操作（如插入，更新或删除语句）。

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

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

构造器详细资料

SqlTemplate

public SqlTemplate()

SqlTemplate

public SqlTemplate(Dao dao)

方法详细资料

setDao

public void setDao(Dao dao)

dao

public Dao dao()

update

public int update(String sql,
                  Map<String,Object> params)

执行一个SQL更新操作（如插入，更新或删除语句）。

参数:

sql - 包含变量占位符的SQL

params - 参数map,无参数时，可为null

返回:

SQL 语句所影响的行数

update

public int update(String sql,
                  Map<String,Object> vars,
                  Map<String,Object> params)

执行一个SQL更新操作（如插入，更新或删除语句）。

参数:

sql - 包含变量占位符的SQL

vars - 变量map，无参数时，可为null

params - 参数map，无参数时，可为null

返回:

SQL 语句所影响的行数

batchUpdate

public int batchUpdate(String sql,
                       List<Map<String,Object>> batchValues)

执行SQL批量更新操作（如插入，更新或删除语句）。

参数:

sql - 包含变量占位符的SQL

batchValues - 批量更新参数集合

返回:

SQL 语句所影响的行数

batchUpdate

public int batchUpdate(String sql,
                       Map<String,Object> vars,
                       List<Map<String,Object>> batchValues)

执行SQL批量更新操作（如插入，更新或删除语句）。

参数:

sql - 包含变量占位符的SQL

vars - 变量map，无参数时，可为null

batchValues - 批量更新参数集合

返回:

SQL 语句所影响的行数

queryForInt

public int queryForInt(String sql,
                       Map<String,Object> params)

执行一个SQL查询操作，结果为一个int形数值。

参数:

sql - 包含变量占位符的SQL

params - 参数map，无参数时，可为null

返回:

int数值，当查询为null时返回0

queryForInt

public int queryForInt(String sql,
                       Map<String,Object> vars,
                       Map<String,Object> params)

执行一个SQL查询操作，结果为一个int形数值。

参数:

sql - 包含变量占位符的SQL

vars - 变量map，无参数时，可为null

params - 参数map，无参数时，可为null

返回:

int数值，当查询为null时返回0

queryForLong

public long queryForLong(String sql,
                         Map<String,Object> params)

执行一个SQL查询操作，结果为一个long形数值。

参数:

sql - 包含变量占位符的SQL

params - 参数map，无参数时，可为null

返回:

long数值，当查询为null时返回0

queryForLong

public long queryForLong(String sql,
                         Map<String,Object> vars,
                         Map<String,Object> params)

执行一个SQL查询操作，结果为一个long形数值。

参数:

sql - 包含变量占位符的SQL

vars - 变量map，无参数时，可为null

params - 参数map，无参数时，可为null

返回:

long数值，当查询为null时返回0

queryForObject

public <T> T queryForObject(String sql,
                            Map<String,Object> params,
                            Class<T> classOfT)

执行一个SQL查询操作，结果为给定对象类型的对象，适用于明确SQL查询结果的类型。

参数:

sql - 包含变量占位符的SQL

params - 参数map 无参数时，可为null

classOfT - 对象类型，SQL查询结果所对应的类型，如Date.class等

返回:

对象，无查询结果时返回null

queryForObject

public <T> T queryForObject(String sql,
                            Map<String,Object> vars,
                            Map<String,Object> params,
                            Class<T> classOfT)

执行一个SQL查询操作，结果为给定对象类型的对象，适用于明确SQL查询结果的类型。

参数:

sql - 包含变量占位符的SQL

vars - 变量map，无参数时，可为null

params - 参数map，无参数时，可为null

classOfT - 对象类型，SQL查询结果所对应的类型，如Date.class等

返回:

对象，无查询结果时返回null

queryForObject

public <T> T queryForObject(String sql,
                            Map<String,Object> params,
                            Entity<T> entity)

执行一个SQL查询操作，结果为给定实体的对象。

参数:

sql - 包含变量占位符的SQL

params - 参数map，无参数时，可为null

entity - 实体类型，无参数时，可为null

返回:

对象，无查询结果时返回null

queryForObject

public <T> T queryForObject(String sql,
                            Map<String,Object> vars,
                            Map<String,Object> params,
                            Entity<T> entity)

执行一个SQL查询操作，结果为给定实体的对象。

参数:

sql - 包含变量占位符的SQL

vars - 变量map，无参数时，可为null

params - 参数map，无参数时，可为null

entity - 实体类型

返回:

对象，无查询结果时返回null

queryForRecord

public Record queryForRecord(String sql,
                             Map<String,Object> params)

执行一个SQL查询操作，结果为Record的对象。

参数:

sql - 包含变量占位符的SQL

params - 参数map，无参数时，可为null

返回:

Record对象，无查询结果时返回null

queryForRecord

public Record queryForRecord(String sql,
                             Map<String,Object> vars,
                             Map<String,Object> params)

执行一个SQL查询操作，结果为Record的对象。

参数:

sql - 包含变量占位符的SQL

vars - 变量map，无参数时，可为null

params - 参数map，无参数时，可为null

返回:

Record对象，无查询结果时返回null

query

public <T> List<T> query(String sql,
                         Map<String,Object> params,
                         Entity<T> entity)

执行一个SQL查询操作，结果为一组对象。

参数:

sql - 包含变量占位符的SQL

params - 参数map，无参数时，可为null

entity - 对象类型，无参数时，可为null

返回:

对象列表，无查询结果时返回长度为0的List对象

query

public <T> List<T> query(String sql,
                         Map<String,Object> params,
                         Class<T> classOfT)

执行一个SQL查询操作，结果为一组对象。

参数:

sql - 包含变量占位符的SQL

params - 参数map，无参数时，可为null

classOfT - 对象类类

返回:

对象列表，无查询结果时返回长度为0的List对象

query

public <T> List<T> query(String sql,
                         Map<String,Object> vars,
                         Map<String,Object> params,
                         Entity<T> entity)

执行一个SQL查询操作，结果为一组对象。

参数:

sql - 包含变量占位符的SQL

vars - 变量map，无参数时，可为null

params - 参数map，无参数时，可为null

entity - 对象类型

返回:

对象列表，无查询结果时返回长度为0的List对象

queryForList

public <T> List<T> queryForList(String sql,
                                Map<String,Object> vars,
                                Map<String,Object> params,
                                Class<T> classOfT)

执行一个SQL查询操作，结果为一组对象。

参数:

sql - 包含变量占位符的SQL

vars - 变量map，无参数时，可为null

params - 参数map，无参数时，可为null

classOfT - 对象类型

返回:

对象列表，无查询结果时返回长度为0的List对象

queryRecords

public List<Record> queryRecords(String sql,
                                 Map<String,Object> vars,
                                 Map<String,Object> params)

执行一个SQL查询操作，结果为Record对象列表。

参数:

sql - 包含变量占位符的SQL

vars - 变量map，无参数时，可为null

params - 参数map，无参数时，可为null

返回:

Record列表，无查询结果时返回长度为0的List对象