iBatis开发详解（3）---详细配置
iBatis的简单增删改查操作非常容易掌握，下面我们来看看iBatis的详细配置。虽然iBatis小巧灵活，但是其可扩展性也非常强。iBatis的核心配置文件就是SqlMapConfig.xml了，下面我们来看看iBatis的核心配置结构。
SqlMapConfig配置文件在前面我们知道要配置JDBC连接，SqlMap映射文件等信息，当然这都是非常基本的配置，现在我们要探究一下SqlMapConfig的详细配置。主要包括以下内容：
<properties>元素的配置，它提供了允许在主配置文件之外的一个“名值对”列表，可以将其中的配置信息加载进来，而这些配置信息可以放在任何一个地方。使用properties元素，其中有两个属性，分别是：resource和url。
使用resource属性时，类加载器会从类路径开始定位该资源；而使用url属性时，则是用java.net.URL类来处理的，提供一个有效的URL即可。之前的示例中，我们使用了resource属性来配置数据库连接信息，如：
<properties resource="jdbc.properties" />
<settings>元素的配置，这个元素即设置iBatis的全局配置信息。下面我们逐一来看其中可配置的属性信息。
lazyLoadingEnabled，从名字即可看出是否进行延迟加载。通俗来说，延迟加载就是只加载必要信息而推迟加载其他未明确请求的数据，这里要和Hibernate中延迟加载区分开。那也就是说，除非绝对必须，否则程序加载的数据越少越好。iBatis默认使用了延迟加载，即不配置时也是默认为true的。
cacheModelsEnabled，这是数据缓存的配置，缓存可以提高程序的性能，这是显而易见的。和延迟加载一样，缓存也是默认启用的。
enhancementEnabled，该配置是来说明是否使用cglib中那些优化的类来提高延迟加载的性能，默认值为true，也就是启用。但是之前的示例中，并没有在lib中加入cglib的类库，那么iBatis没有在类路径上发现cglib时，该功能也就不能起作用了。这里多说一点，对于增强框架，除非必须，尽量避免使用。
useStatementNamespaces，该配置说明是否使用语句的命名空间，默认是不使用的，但是在大型应用时，使用命名空间来作为限定就比较清楚了。使用方法是在<sql-map>标记上加namespace属性即可，在程序中就使用“命名空间.SQL映射语句”这种语法来执行。
settings还可以设置maxRequests，maxSessions和maxTransactions信息，但它们都已经被废弃了，也就是说我们可以不用设置它们，使用默认的就可以了。如果必须要进行设置，那就要保证maxRequests大于maxSessions，而maxSessions要大于maxTransactions。
下面我们来看<typeAlias>元素，就是起别名，很容易理解，我们不想使用过长的类名时，可以用它来起个别名，之后我们使用别名就可以了。比如：
<typeAlias alias="User" type="ibatis.model.User" />
iBatis已经为我们设置了一些类型的别名，我们就可以直接使用了，比如事务管理器的JDBC,JTA和EXTERNAL；数据类型的string,byte,long,short,int等；数据源工厂的SIMPLE,DBCP,JNDI；高速缓存控制器的FIFO,LRU,MEMORY,OSCACHE和XML结果类型的DOM,domCollection,Xml,XmlCollection，它们是可以直接使用的。
transactionManager元素，没错，它就是来做事务的。iBatis内置的事务管理器有JDBC,JTA和EXTERNAL。EXTERNAL表示事务管理器是应用程序本身负责，而不是iBatis。使用type属性就能在transactionManager元素中配置事务管理器了。比如：
<transactionManager type="JDBC"></transactionManager>
在transactionManager元素中还可以继续配置<properties>元素和<dataSource>元素。properties元素用于指定transactionManager的配置项，而后者用于配置数据源工厂，默认提供三种SIMPLE,DBCP和JNDI。
typeHandler元素，即类型处理器，用于将数据库中的数据类型转换成应用程序中使用的数据类型。假如数据库中不支持布尔值，那么只能以0/1来代表，而Java应用程序中支持布尔值，这里就需要一个类型处理的过程。使用时需要创建两个类，一个是类型处理类，一个是类型处理回调类。iBatis预先设置了大量的类型处理器，如果不是必须，为了程序的简单，那么尽量不要使用。
最后来看一下sqlMap元素，它就是配置SQL语句的了，是我们最常用到的一个标签。可以使用namespace来确定一个命名空间，这在之前已经说到了，可以将同一流程的SQL语句写在一起，放到一个命名空间下，在程序中使用更加清晰。在sqlMap之中，就是对数据库具体操作的实现了，包括增删改查等标记。
下面是iBatis的配置关系图：可以加深对iBatis的理解。 
API的查询：
先说点基础的内容，iBatis并不是真正意义上的ORM，官方文档中称其为dataMapper，是数据映射器，也就是一种映射查询工具。iBatis不是万能的，在某些它不能处理的问题时，不能放弃使用JDBC API，那才是根本中的根本。
在iBatis中，建议使用JavaBean，因为我们是面向对象的设计，那么在系统设计时肯定创建了很多刻画具体对象的类，使用JavaBean就可以直接操作getter方法来获取内容。就像是hibernate中的PO一样。下面来说一种如何获取Bean中属性名称和属性类型的方法，这在开发时可能会用到。
先定义一个JavaBean，刻画用户模型吗，如下：
package ibatis.model;
public class User implements java.io.Serializable {
private Integer userId;
private String userName;
private String password;
private String mobile;
private String email;
public User() {
super();
}
public User(Integer userId, String userName, String password,
String mobile, String email) {
super();
this.userId = userId;
this.userName = userName;
this.password = password;
this.mobile = mobile;
this.email = email;
}
// 省略getter和setter方法
@Override
public String toString() {
return "User [email=" + email + ", mobile=" + mobile + ", password="
+ password + ", userId=" + userId + ", userName=" + userName
+ "]";
}
}
public static void main(String[] args) {
try {
PropertyDescriptor[] pd = Introspector.getBeanInfo(User.class).getPropertyDescriptors();
for (int i = 0; i < pd.length; i++) {
System.out.println(pd[i].getName() + " ("
+ pd[i].getPropertyType().getName() + ")");
}
} catch (IntrospectionException e) {
e.printStackTrace();
}
}
class (java.lang.Class)
email (java.lang.String)
mobile (java.lang.String)
password (java.lang.String)
userId (java.lang.Integer)
userName (java.lang.String)
接下来，我们来说一下三个常用的查询方法，它们的命名和Spring的JdbcTemplate/SqlMapClientTemplate很像，但是要区分开。
首先是queryForObject()方法，它返回数据库查询的一条结果，并放入到Java对象中，这里的一条记录可以是一个JavaBean，也可以是Java的集合类型。它可以根据<select>标签中配置的resultClass属性来确定的，如果不指定resultClass属性，那么查询结果就是null了，因为iBatis不知道怎么处理这个结果，而且我们也没有配置结果映射（resultMap）。
首先我们根据上面的User类型，将resultClass设置为User，代码如下：
<sqlMap namespace="User">
<typeAlias alias="User" type="ibatis.model.User" />
<select id="getUserByName" parameterClass="java.lang.String"
resultClass="User">
select *
from users
where USERNAME=#VARCHAR#
</select>
</sqlMap>
System.out
.println(sqlMap.queryForObject("User.getUserByName", "sarin").getClass().getName());
queryForObject()的另外一个重载方法是Object queryForObject(String id, Object parameter, Object resultObject) throws Exception，这种方法是为对象不能轻易创建的情况使用的（如没有默认的构造方法的对象），那么使用前面那种格式就会抛出异常，就需要使用这种方法，看下面代码：（这里去掉User类中的默认构造方法）
User user=new User(null, null, null, null, null);
user = (User) sqlMap.queryForObject("User.getUserByName", "sarin",
user);
System.out.println(user);
第二个方法是queryForMap()方法，返回结果可以是一条，也可以是多条。它的方法签名有两种形式：第一种是Map queryForMap(String id, Object parameter, String key) throws SQLException，第二种是再多一个参数String value。前面两个参数好理解，就是select标签的id和传入的参数，而后面的key和value是什么意思呢？key指定了Map中存储的键，而value确定了存储的值，不设置value时则存储查询的一个对象，如下面代码（此时已经将select的resultClass设置为hashmap了）：
Map map = sqlMap.queryForMap("User.getAllUsers", null,"userId");
System.out.println(map);
{1={email=gmail@gmail.com, userId=1, userName=sarin, password=123, mobile=15940912345}, 2={email=gmail@gmail.com, userId=2, userName=sarin, password=123, mobile=15940912345}}
System.out.println(map.keySet().iterator().next().getClass());
System.out.println(map.get(1).getClass());
Map map = sqlMap.queryForMap("User.getAllUsers", null, "userId",
"mobile");
System.out.println(map);
下面来看queryForList()方法，同样，该方法的方法签名也有两类形式：第一类是queryForList(String id, Object parameter) throws SQLException，或者不需要参数，这很好理解了。看个例子：（SqlMap中的resultClass设置为hashmap）
List users = sqlMap.queryForList("User.getAllUsers");
System.out.println(users);
[{email=gmail@gmail.com, userId=1, userName=sarin, password=123, mobile=15940912345}, {email=gmail@gmail.com, userId=2, userName=sarin, password=123, mobile=15940912345}]
[User [email=gmail@gmail.com, mobile=15940912345, password=123, userId=1, userName=nanlei], User [email=gmail@gmail.com, mobile=15940912345, password=123, userId=2, userName=sarin]]