DBAgent (onecode-database 1.0.5 API)

java.lang.Object
- com.ds.common.database.DBAgent

```
public class DBAgent
extends Object
```
Title: 常用代码打包

Description:

这个类作为进行数据库操作的代理，它能进行的数据库操作有select、update、insert和delete。具体操作步骤如下：
1.实例化一个DBAgent
    DBAgent dba = new DBAgent();
2.执行sql脚本
    int status = dba.execute("select * from ...");
其中status返回值为-1表示执行失败，如果为select查询,返回1表示成功.如果为其他类型数据库操作,则返回发生影响的结果数.
3.得到sql执行结果
如果为查询操作，调用getQueryResult()获得结果集
    ResultSet rs = dba.getQueryResult();
如果为其他操作，调用getUpdateResult()获得发生效果的记录数
    int result = dba.getUpdateResult();
4.关闭
    dba.close();

以上所有的数据库操作任何时候都不会抛出异常，因此在调用时不必进行异常捕捉。是否发生错误可以通过execute()方法的返回值进行判断。

如果SQL语句为PrepareStatement类型，则需要通过调用setParamVector()方法初始化输入参数。

该类还支持事务处理。在实例化DBAgent时传入是否自动提交参数，true为自动提交，此时不能手工控制事务；为false时需要手工控制数据库事务，此时可以调用的事务控制方法有rollback(),commit()

Copyright: Copyright (c) 2006

Company: www.justdos.net

版本:

2.0

作者:

wenzhang li

字段概要

字段
限定符和类型	字段和说明
`protected List`	`batchedSql`
`protected String`	`configKey`
`protected Connection`	`conn`
`protected List`	`params`
`protected HashSet`	`psSet`
`protected ResultSet`	`query_result`
`protected int`	`rows`
`protected String`	`SQLString`
`protected int`	`update_result`

构造器概要

构造器
限定符	构造器和说明
`protected`	`DBAgent()`
	`DBAgent(String configKey)` 默认构造函数，启用自动提交。
	`DBAgent(String configKey, boolean isAutoCommit)` 构造函数，接收参数为是否进行自动提交。
	`DBAgent(String configKey, Connection conn)` 构造函数，启用自动提交。
	`DBAgent(String configKey, Connection conn, boolean isAutoCommit)` 构造函数，接收参数为是否进行自动提交。

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`addBatch(String sql)` 添加Batch
`void`	`clearBatch()` 清除Batch
`void`	`close()` 释放数据库连接
`void`	`commit()` 事务提交。
`int`	`execute()` 执行sql脚本
`int`	`execute(String sqlString)` 执行sql脚本
`int`	`executeBatch()` 执行Batch
`Connection`	`getConn()` 取得DBBean内的连接，可能是null
`List`	`getParams()`
`ResultSet`	`getQueryResult()` 获得查询结果集
`int`	`getRows()` 得到结果集的记录数
`String`	`getSQLString()`
`int`	`getUpdateResult()` 获得更改的记录数
`void`	`rollback()` 事务回滚。
`void`	`setParams(List params)`
`void`	`setSQLString(String SQLString)`

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - conn
```
protected Connection conn
```
  - query_result
```
protected ResultSet query_result
```
  - update_result
```
protected int update_result
```
  - SQLString
```
protected String SQLString
```
  - params
```
protected List params
```
  - rows
```
protected int rows
```
  - psSet
```
protected HashSet psSet
```
  - batchedSql
```
protected List batchedSql
```
  - configKey
```
protected String configKey
```
- 构造器详细资料
  - DBAgent
```
protected DBAgent()
```
  - DBAgent
```
public DBAgent(String configKey)
        throws SQLException,
               com.ds.common.JDSException
```
    默认构造函数，启用自动提交。并自动创建一个新的数据库连接Connnection
    
    抛出:
    
    SQLException
    
    com.ds.common.JDSException
  - DBAgent
```
public DBAgent(String configKey,
               Connection conn)
        throws SQLException,
               com.ds.common.JDSException
```
    构造函数，启用自动提交。如果传入的连接为null，则自动创建一个新的数据库连接
    
    参数:
    
    conn - - 数据库连接
    
    抛出:
    
    SQLException
    
    com.ds.common.JDSException
  - DBAgent
```
public DBAgent(String configKey,
               boolean isAutoCommit)
        throws SQLException,
               com.ds.common.JDSException
```
    构造函数，接收参数为是否进行自动提交。自动创建一个新的数据库连接
    
    参数:
    
    isAutoCommit - - 是否使用自动提交
    
    抛出:
    
    SQLException
    
    com.ds.common.JDSException
  - DBAgent
```
public DBAgent(String configKey,
               Connection conn,
               boolean isAutoCommit)
        throws SQLException,
               com.ds.common.JDSException
```
    构造函数，接收参数为是否进行自动提交。如果传入的连接为null，则自动创建一个新的数据库连接
    
    参数:
    
    conn - - 数据库连接
    
    isAutoCommit - - 是否使用自动提交
    
    抛出:
    
    SQLException
    
    com.ds.common.JDSException
- 方法详细资料
  - execute
```
public int execute(String sqlString)
```
    执行sql脚本
    
    返回:
    
    -1表示执行失败
    如果为select查询,返回1表示成功.
    如果为其他类型数据库操作,则返回发生影响的结果数.
  - execute
```
public int execute()
```
    执行sql脚本
    
    返回:
    
    -1表示执行失败
    如果为select查询,返回1表示成功.
    如果为其他类型数据库操作,则返回发生影响的结果数.
  - getSQLString
```
public String getSQLString()
```
    返回:
    
    获得准备执行的sql语句
  - getParams
```
public List getParams()
```
    返回:
    
    封装到Vector中的参数列表。添加参数的顺序需要和sql语句中的'?'出现的顺序一致。
  - setSQLString
```
public void setSQLString(String SQLString)
```
    参数:
    
    SQLString - 设置准备执行的sql语句
  - setParams
```
public void setParams(List params)
```
    参数:
    
    paramVector - 封装到Vector中的参数列表。添加参数的顺序需要和sql语句中的'?'出现的顺序一致。
  - getQueryResult
```
public ResultSet getQueryResult()
```
    获得查询结果集
    
    返回:
    
    查询结果集
  - getUpdateResult
```
public int getUpdateResult()
```
    获得更改的记录数
    
    返回:
    
    更改的记录数
  - close
```
public void close()
```
    释放数据库连接
  - getRows
```
public int getRows()
```
    得到结果集的记录数
  - commit
```
public void commit()
```
    事务提交。只在自动提交设置为false时生效。
  - rollback
```
public void rollback()
```
    事务回滚。只在自动提交设置为false时生效。
  - clearBatch
```
public void clearBatch()
```
    清除Batch
  - addBatch
```
public void addBatch(String sql)
```
    添加Batch
    
    参数:
    
    sql - 要添加到Batch中的sql
  - executeBatch
```
public int executeBatch()
```
    执行Batch
    
    返回:
    
    -1表示执行失败
    如果成功,则返回发生影响的记录数.
  - getConn
```
public Connection getConn()
```
    取得DBBean内的连接，可能是null
    
    返回:

类 DBAgent

字段概要

构造器概要

方法概要

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

字段详细资料

conn

query_result

update_result

SQLString

params

rows

psSet

batchedSql

configKey

构造器详细资料

DBAgent

DBAgent

DBAgent

DBAgent

DBAgent

方法详细资料

execute

execute

getSQLString

getParams

setSQLString

setParams

getQueryResult

getUpdateResult

close

getRows

commit

rollback

clearBatch

addBatch

executeBatch

getConn