MyBatis与Spring、commons-dbcp的集成开发（二）

gaoke

用Eclipse 或 netBeans IDE工具开发，新建一个 Java Application.
将所需的jar 引入项目。
把几个属性文件放在源包下面。
第一步，编写日志配置文件 commons-logging.properties 和 log4j.properties。
第二步，编写一个关于 jdbc 的 属性文件，如 jdbc.properties。其实，这个文件不是必需的。也可以写在Spring的XML文件中，后面会理解它的用途。
第三步，编定Spring的XML配置。
在Spring的XML中，要完成以下几个功能：
1. 定义一个  dataSource 数据库连接池
2. 定义一个  sqlSessionFactory。
    如果是 WEB 应用，还应定义一个事务管理器 dataSourceTransactionManager。
那么 SpringConfig.xml 内容如下：

<beans......
......>
<bean id="propertyPlaceholder" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
<property name="location" value="jdbc.properties" />
</bean>
<!-- 定义一个 datasource 数据库连接池，这里使用了Apache DBCP，需要 commons-dbcp和commons-pool的包支持 -->
<!-- 这里的${...}，引用了 jdbc.properties中的内容，使用户不需要查找XML文件中有关JDBC的配置片段 -->
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" >
<property name="driverClassName" value="${jdbc.driver}" />
<property name="url">
<value>${jdbc.url}</value>
</property>
<property name="username">
<value>${jdbc.user}</value>
</property>
<property name="password">
<value>${jdbc.password}</value>
</property>
<property name="maxActive" value="2" />
<property name="initialSize" value="1" />
<property name="maxIdle" value="2" />
<property name="minIdle" value="1" />
<!-- 等待连接超时时间，30秒 -->
<property name="maxWait" value="30000" />
</bean>
<!-- 使用指定的 dataSource 创建 SqlSessionFactory,并且指定Mybatis的配置文件，
同时，MyBatis中的Enviroment 配置段在容器中不会生效，使用指定的 dataSource。
-->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
<!-- mapperLocations和configLocation有一个即可,
如果Mapper.xml 中使用了  typeAliases 的别名，则可以使用 configLocation，否则可任选其一 -->
<!-- 指定实体类映射文件，可以指定同时指定某一包以及子包下面的所有配置文件 -->
<!--
<property  name="mapperLocations"  value="classpath*:.../*.xml"/>
-->
<property name="configLocation" value="classpath:SqlMapConfig.xml" />
</bean>
<!-- 定义一个事务管理器 -->
<bean id="dataSourceTransactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource" />
</bean>
</beans>


从上面的 SpringConfig中看到，jdbc.properties被Spring容器读取后，作为参数赋于dataSrouce ，那也就是说，没有jdbc.properties，可以直接在XML写值。
而这个dataSource是由dbcp的BasicDataSource实现的。
继续看接下来的配置，sqlSessionFactory,它必须要有dataSource数据库连接池属性。
在例子中，使用的是configLocation。
实际上，通过 mybatis-generator生成XML，放在统一的位置，使用mapperLocations则更加方便，而不需要编写一个有关Mybatis的Mappers文件。
第四步，编写 MybatisConfig.xml，设置别名，定义参数， Mappeers。

<configuration>
<typeAliases>
<typeAlias alias="OrgType" type="MybatisTest.domain.Org_Type" />
</typeAliases>
<mappers>
<mapper resource="MybatisTest/domain/OrgTypeMapper.xml" />
<mapper resource="MybatisTest/domain/NtAcctinfoMapper.xml" />
</mappers>
</configuration>

上面这个 MybatisConfig非常简单，相比典型的文件省略很多内容，只是定义了一个别名。
列了两张表的Mapper，没有其它。如果在 Mapper文件中没有引用别名，可以把typeAliases无素也删除了。
如果数据表很多，而编写Mappers 元素也有可能出错。所以说，属性mapperLocations更加合理方便。
前面四个步骤，完成了  几个配置文件的编写。接下来需要做的是针对表的Mapper和POJO类的开发。
第五步，编写POJO 类。
Pojo类的代码不再细述，只要 javaType 和 JDBCType 是对应的，数据表的列名与POJO属性名既可以相同，也可以不同, 不列举代码了。
第六步，编写 ****Mapper.xml

<mapper namespace="aps.tables.org_type">
<resultMap id="orgTyperesult" type="MybatisTest.domain.Org_Type">
<id column="ID" property="id" />
<result column="TYPE_CODE" property="typecode" />
<result column="TYPE_NO" property="typeno" />
<result column="TYPE_VALUE" property="typevalue" />
<result column="NOTES" property="typenotes" />
</resultMap>
<select id="selectByID" parameterType="int" resultMap="orgTyperesult">
select ID, TYPE_CODE, TYPE_NO, TYPE_VALUE, NOTES from dbo.T_TYPE_ENUM where ID=#{id}
</select>
<delete id="delete" parameterType="int">
delete from T_TYPE_ENUM where ID=#{id}
</delete>
<update id="update" parameterType="OrgType" >
update dbo.T_TYPE_ENUM set TYPE_CODE=#{typecode}, TYPE_NO=#{typeno}, TYPE_VALUE=#{typevalue}, NOTES=#{typenotes}
where ID=#{id}
</update>
<insert id="insert"  parameterType="MybatisTest.domain.Org_Type" >
insert into dbo.T_TYPE_ENUM ( ID,TYPE_CODE, TYPE_NO, TYPE_VALUE, NOTES) values ( #{id}, #{typecode},#{typeno}, #{typevalue},#{typenotes})
</insert>
</mapper>


resultMap 是实现列名与属性的对应关系，这里只是最简单的示例，你可以在Reference文档中看到更复杂更加大的功能。
其它的select , insert等，是相关的SQL语句，不做过多解释。parameterType是传入的参数，resultMap和resultType是返回值的类型，如果SELECT 别名与 POJO 属性名相同，那么就可以使用 resultType ，进行自动映射转换。
#{}代表的是相应的参数，相当于 JDBC SQL 参数的 ？ 。
这样，是不是可以结束了，开始测试了？ 当然可以！也可以作进一步的封装。
先来测试一下吧。为方便起见，先写一个静态工具，用来获取SqlSession

public class MybatisUtil {
private static SqlSessionFactory factory;
static{
ApplicationContext ctx=new ClassPathXmlApplicationContext("classpath:SpringConfig.xml");
factory=(SqlSessionFactory) ctx.getBean("sqlSessionFactory");
}
public static SqlSession getSession(){
return factory.openSession();
}
public static SqlSessionFactory getSessionFactory(){
return factory;
}
}


现在可以来测试了，很简单。这里得到SqlSession后，通过Mybatis得到了Org_Type 的一个对象，又通过update更新了数据表。最后关闭连接，准确地说是释放连接，连接的打开关闭由dbcp连接池管理。

SqlSession sess=MybatisUtil.getSession();
Org_Type org=sess.selectOne("aps.tables.org_type.selectByID",20);
System.out.println(sess.update("aps.tables.org_type.update", org));
sess.close();


来看其中的"aps.tables.org_type.selectByID","aps.tables.org_type.update"，这正是Mapper.xml 文件中 namespace和数据操作 id 的 连接，这就指定了唯一的SQL语句，而后面的对象，就是参数 parameterType。
细细地可以发现，在 Mapper.xml 文件中，insert,update,delete都没有 resultType ，因为它们最终返回的都是int，是语句执行后影响的数据行。
如果 update 或 delete 执行成功，但返回的是 0，那实际上就是一条数据也没有修改或删除。
如果，你想自己直接操作JDBC，也很简单：
Statement stmt=sess.getConnection().createStatement();
stmt.execute......
初步入门完成。