list = DB.getList("student", "select * from t_student where class='3年1班'", Student.class);
```
## 查询多条Map记录 DB.getMapList()
##
`org.rex.DB.getMapList()`方法用于查询多条记录，并返回一个java.util.List实例（无记录时返回空的List实例）。格式如下：
> **List DB.getMapList([String dataSourceId,] String sql, [Object[] | Ps | Map | Object parameter] [, int offset, int rows])**
- dataSourceId：可选，配置文件中的数据源id，不设置时使用默认数据源；
- sql：必填，待执行的SQL语句；
- parameter：可选，执行SQL时的预编译参数。根据该参数的类型不同，SQL中使用`?`或者`#{}`标记预编译参数。
- offset：可选，分页查询的起始行号；
- rows：可选，分页查询待获取的结果集条目。
例1：执行SQL，并获取结果
```java
List list = DB.getMapList("select * from t_student where class='3年1班'");
```
例2：执行带有预编译参数的SQL，当parameter参数为`Object数组`、`org.rex.db.Ps`时，SQL中使用`?`标记预编译参数
```java
List list = DB.getMapList("select * from t_student where class=?", new Object[]{"3年1班"});
List list = DB.getMapList("select * from t_student where class=?", new Ps("3年1班"));
```
例3：执行带有预编译参数的SQL，当parameter参数为`java.util.Map`、`Java对象`时，SQL中使用`#{}`标记预编译参数
```java
//map为java.util.Map类型的实例，包含名为“class”的键；obj为普通的java对象，包含名为“clazz”的成员变量
List list = DB.getMapList("select * from t_student where class=#{clazz}", map);
List list = DB.getMapList("select * from t_student where class=#{clazz}", obj);
```
例4：执行分页查询，查询第100～110条记录
```java
List list = DB.getMapList("select * from t_student where class='3年1班'", 100, 10);
```
例5：在指定数据源中执行SQL
```java
//配置文件rexdb.xml中有id为student的数据源
List list = DB.getMapList("student", "select * from t_student where class='3年1班'");
```
## 插入/更新/删除 DB.update()
##
`org.rex.DB.update()`方法用于执行插入/更新/删除操作，该接口将返回受影响的记录条数。格式如下：
> **int DB.update([String dataSourceId,] String sql [, Object[] | Ps | Map | Object parameter])**
例1：执行SQL
```java
DB.update("delete from t_student where num = 1");
```
例2：执行带有预编译参数的SQL，当parameter参数为`Object数组`、`org.rex.db.Ps`时，SQL中使用`?`标记预编译参数
```java
string sql = "insert into t_student(num, student_name, student_class,create_time) values (?, ?, ?, ?)";
DB.update(sql, new Object[]{1, "钟小强","3年1班", new Date()});
DB.update(sql, new Ps(2, "王小五", "3年1班",new Date()));
```
例3：执行带有预编译参数的SQL，当parameter参数为`java.util.Map`、`Java对象`时，SQL中使用`#{}`标记预编译参数
```java
String sql = "update t_student set student_name = #{studentName} where num = #{num}";
DB.update(sql,map);//map为java.util.Map类型的实例，包含名为“studentName”和“num”的键
DB.update(sql,new Students(1, "钟小强", null, null));//obj为普通的java对象，包含名为“studentName”和“num”的成员变量
```
例4：在指定数据源中执行SQL
```java
//配置文件rexdb.xml中有id为student的数据源
List list = DB.getMapList("student", "delete from t_student where num = 1");
```
## 批量更新 DB.batchUpdate()
##
`DB.batchUpdate()`方法用于执行批处理操作，该接口可以有效提升执行大量数据变更时的执行性能，格式如下：
> **int[] DB.batchUpdate([String datasource,] String[] sqls)**
> **int[] DB.batchUpdate([String datasource,] String sql, Object[][] | Ps[] | Map[] | Object[] | List parameter )**
例1：执行多个SQL
```java
String[] sqls = new String[]{"delete from t_student where num=1", "delete from t_student where num=2"};
DB.batchUpdate(sqls);
```
例2：执行带有预编译参数的SQL，当parameter参数元素类型为`Object数组`、`org.rex.db.Ps`时，SQL中使用`?`标记预编译参数
```java
string sql = "insert into t_student(num, student_name, student_class,create_time) values (?, ?, ?, ?)";
DB.batchUpdate(sql, new Object[][]{{1, "钟小强","3年1班", new Date()}, {2, "王小五","3年1班", new Date()}});
DB.batchUpdate(sql, new Ps[]{new Ps(3, "李小华", "3年1班", new Date()), new Ps(4, "赵小明", "3年1班", new Date())});
```
例3：执行带有预编译参数的SQL，当parameter参数元素类型为`java.util.Map`、`Java对象`时，SQL中使用`#{}`标记预编译参数
```java
String sql = "update t_student set student_name = #{studentName} where num = #{num}";
DB.batchUpdate(sql, maps);//maps为java.util.Map数组实例，数组中每个元素都包含名为“studentName”和“num”的键
DB.batchUpdate(sql, objs);//objs为Student类型的java对象实例数组，Student对象包含名为“studentName”和“num”的成员变量
```
例4：在指定数据源中执行SQL
```java
String[] sqls = new String[]{"delete from t_student where num=1", "delete from t_student where num=2"};
DB.batchUpdate("student", sqls);
```
## 事务
##
Rexdb使用编程的方式处理事务，以下接口用于事务处理：
> **void DB.beginTransaction([String dataSourceId] [,DefaultDefinition definition])** //开启事物
> **void DB.commit([String dataSourceId])** //提交事务
> **void DB.rollback([String dataSourceId])** //回滚事务
JTA事物接口如下：
> **void DB.beginJta([DefaultDefinition definition])** //开启JTA事物
> **void DB.commitJta()** //提交JTA事务
> **void DB.rollbackJta()** //回滚JTA事务
例：
```java
DB.beginTransaction();
try{
DB.update("delete from t_student where num = 1");
DB.update("delete from t_student where num = 2");
UserDao.update();//Rexdb的事物是线程级别的，同一线程且同一数据源中的事物对象共享，所以可以把原子操作分散在多个DAO中
DB.commit();
}catch(Exception e){
DB.rollback();
}
```
## 调用 DB.call()
##
`DB.call()`方法用于执行调用操作，可用于调用存储过程和函数，支持返输入、输出参数和返回值。格式如下：
> **RMap DB.call([String dataSourceId,] String sql [, Object[] | Ps | Map | Object parameter])**
例1：调用存储过程/函数
```java
DB.call("test_proc()");
```
例2：调用有输入参数的存储过程/函数
```java
DB.call("{call test_proc_in(?)", new Ps(200));
```
例3：调用有输出参数的存储过程/函数时，必须使用org.rex.db.Ps对象声明输出参数
```java
Ps ps = new Ps();
ps.addOutInt("age");
RMap result = DB.call("{call test_proc_out(?)}", ps);
int age = result.getInt("age")
```
例4：调用同时有输入输出参数的存储过程/函数，必须使用org.rex.db.Ps对象，并按照SQL中标记的顺序声明
```java
Ps ps = new Ps();
ps.add(200);
ps.addOutInt("major");
RMap result = DB.call("{call test_proc_in_out(?, ?)}", ps);
int major = result.getInt("major");
```
例5：调用即是输入参数也是输出参数的存储过程/函数，必须使用org.rex.db.Ps对象
```java
Ps ps = new Ps();
ps.addInOut("count", 10);
RMap result = DB.call("{call test_proc_inout(?)}", ps);
int count = result.getInt("count");
```
例6：调用带有返回值的存储过程/函数，返回值将按照return_1、return_2的顺序命名
```java
RMap result = DB.call("{call exdb_test_proc_return()}");
List return1 = result.getList("return_1");
```
关于调用的其它用法请参见用户手册。
## 更多
##
Rexdb还有更多功能，例如：
- 设置异常信息为中文/英文；
- 开启/关闭日志；
- 执行SQL前的语法检查；
- 自动检查连接/状态中的警告；
- 设置查询超时时间；
- 设置事物超时时间/隔离级别/自动回滚/自动的批处理事务；
- 启动动态字节码编译/反射缓存；
- 自动转换日期类型的参数；
详情请参见[Rexdb用户手册](http://db.rex-soft.org/document.php?version=1.0&doc=user-manual)。
## 附1：类 org.rex.RMap
##
类`org.rex.RMap`继承了`java.util.HashMap`，主要用于简化取值时的Java类型转换。该类有诸如`RMap.getInt(String key)`、`RMap.getDate(String key)`的方法，可以方便的获取需要的类型。当Map中存储的值类型和希望获取的类型不匹配时，也会尝试各种可能的方式进行类型转换。
例1：查询记录数
```java
int c = DB.getMap("select count(*) as c from t_student").getInt("c");
```
例2：查询数据库中的当前时间（oracle）
```java
Date now = DB.getMap("select sysdate as now from dual").getDate("now");
```
例3：获取某日期字段（SQL查询出的类型为String，RMap自动将其转换为Date类型）
```java
Date date = DB.getMap("select '2016-01-01' as date from dual").getDate("date");
```
有关该类的更多使用方法请参见[Rexdb用户手册](http://db.rex-soft.org/document.php?version=1.0&doc=user-manual)。
## 附2：类 org.rex.db.Ps
##
类 `org.rex.db.Ps`用于声明预编译参数，也可以用于获取SQL执行后的输出参数和返回值。该类提供了丰富的接口，可以快速设置执行SQL所需的参数，简化了为设置查询条件而实例化Java对象的代码。
例1：使用构造函数按顺序声明预编译参数
```java
RMap stu = DB.get("select * from t_student where class=? and num=?", new Ps("3年1班", 1));
```
例2：逐个声明预编译参数
```java
Ps ps = new Ps();
ps.add("3年1班");
ps.add(1);
RMap stu = DB.get("select * from t_student where class=? and num=?", ps);
```
例3：声明存储过程的输出参数
```java
Ps ps = new Ps();
ps.addOutInt("age");
RMap result = DB.call("{call test_proc_out(?)}", ps);
int age = result.getInt("age")
```
有关该类的更多使用方法请参见[Rexdb用户手册](http://db.rex-soft.org/document.php?version=1.0&doc=user-manual)。
## 附3：作者的一些建议
##
- 对于需求不可预计的项目、业务极其复杂的项目、采用原型法逐步迭代的项目，或是任何没有经过详细设计的项目，在开发、生产过程中都不可避免的要进行多表关联查询，同时也会有较频繁的表结构变更。这类系统建议放弃编写与数据表对应的POJO类，而是直接采用Map的方式查询和传递数据，这可以大幅降低需求变更时的编码量。当然，这还需要其它框架的配合，例如MVC、Taglib或是模板引擎对Map对象的支持。
- 而对于经过精心设计，表结构不会频繁变更，各表之间的关联查询较少的项目，建议采用查询Java对象系列接口。