MyBatis之一（环境搭建）

09年的时候工作中用过ibatis，虽然说使用过，但也没有深入的全面的学习。最近在去ibatis的官网看下，现在ibatis已经改名为Mybatis，下载路径已经改变（http://code.google.com/p/mybatis/wiki/Downloads?tm=2）

现在比较空闲，借此机会好好的根据已经的ibatis了解来学习下Mybatis

1、下载Myibatis

         下载地址（http://code.google.com/p/mybatis/downloads/list?can=3&q=Product%3DMyBatis）

         下载版本：mybatis-3.1.1-bundle.zip

新手学习的时候最好下载官方的用户指南，当然英文不很好的童鞋可以找下中文翻译的版本。

2、Mysql建库表

DROP TABLE IF EXISTS `student`;
CREATE TABLE `student` (
  `Id` int(11) NOT NULL AUTO_INCREMENT,
  `NAME` varchar(100) DEFAULT NULL,
  `SEX` varchar(10) DEFAULT NULL,
  `AGE` int(2) DEFAULT NULL,
  PRIMARY KEY (`Id`)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;
    

3、Myeclipse新建工程

4、环境搭建

    （1）、mybaits的XML环境配置文件

        路径：src/config.xml

    <?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
   
   <!-- 类别名定义 -->
   <typeAliases>
		 <typeAlias type="com.mybatis.po.Student" alias="Student"/>
	</typeAliases>
	<!-- 配置Mybatis的环境，事务及数据源等等 -->
	<environments default="development">
		<environment id="development">
			<transactionManager type="JDBC" />
			<dataSource type="POOLED">
				<property name="driver" value="com.mysql.jdbc.Driver" />
				<property name="url" value="jdbc:mysql://127.0.0.1:3306/mybatis" />
				<property name="username" value="root" />
				<property name="password" value="root" />
			</dataSource>
		</environment>
	</environments>
	
	<!-- 指定映射文件或者映射类 -->
	<mappers>
		<mapper resource="com/mybatis/persistence/StudentMapper.xml" />
	</mappers>
</configuration>

（2）、创建数据库表对应的模型PO类

package com.mybatis.po;
import java.io.Serializable;

public class Student implements Serializable {
	private static final long serialVersionUID = 1L;
	private int id;
	private String name;
	private String sex;
	private int age;
	public int getId() {
		return id;
	}
	public void setId(int id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public String getSex() {
		return sex;
	}
	public void setSex(String sex) {
		this.sex = sex;
	}
	public int getAge() {
		return age;
	}
	public void setAge(int age) {
		this.age = age;
	}
	public String toString(){
		return "ID:"+this.getId()+",姓名："+this.getName()+",性别："+this.getSex()+",年龄："+this.getAge();
	}
}

 

（3）DAO层接口

       package com.mybatis.persistence;

import com.mybatis.po.Student;
public interface StudentMapper {
	/**
	 * 根据ID查询
	 * 创 建 人:  XX
	 * 创建时间:  2012-11-1 上午09:51:22  
	 * @param id
	 * @return
	 * @see [类、类#方法、类#成员]
	 */
	public Student getStudentById(Integer id);
}

  （4）映射文件（com/mybatis/persistence/StudentMapper.xml）

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="com.mybatis.persistence.StudentMapper">

	<select id="getStudentById" parameterType="int" resultType="Student">
		select * from student where id = #{id}
	</select>
	
</mapper>

   ok到这儿一个最简单的环境搭建好了。

5、我们来测试一下

      在student表中手工插入一条记录，我们来查询一下

    package com.mybatis.test;

import java.io.Reader;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Before;
import org.junit.Test;
import com.mybatis.persistence.StudentMapper;
import com.mybatis.po.Student;

public class TestStudentMapper {

	private SqlSession session=null;
	@Before
	public void setUp() throws Exception {
		String resource = "config.xml";
		Reader reader = Resources.getResourceAsReader(resource);
		SqlSessionFactory sqlMapper = new SqlSessionFactoryBuilder().build(reader);
		session = sqlMapper.openSession();
	}
	
	@Test
	public void testSelectStudent(){
		StudentMapper mapper = session.getMapper(StudentMapper.class);
		Student student =mapper.getStudentById(1);
		System.out.println(student.toString());
	}
	
}

     好了，测试正常

6、MyBatis的配置文件解析

（1）、配置文件的基本结构

configuration —— 根元素

properties —— 定义配置外在化

settings —— 一些全局性的配置

typeAliases —— 为一些类定义别名

typeHandlers —— 定义类型处理，也就是定义java类型与数据库中的数据类型之间的转换关系

objectFactory

plugins —— Mybatis的插件，插件可以修改Mybatis内部的运行规则

environments —— 配置Mybatis的环境

environment

transactionManager —— 事务管理器

dataSource —— 数据源

databaseIdProvider

mappers —— 指定映射文件或映射类

（2）、Settings

 

这些是极其重要的调整，它们会修改MyBatis在运行时的行为方式。下面这个表格描述了设置信息，它们的含义和默认值。

 

 

 

设置参数	描述	有效值	默认值
cacheEnabled	这个配置使全局的映射器启用或禁用缓存。	true | false	true
lazyLoadingEnabled	全局启用或禁用延迟加载。当禁用时，所有关联对象都会即时加载。	true | false	true
aggressiveLazyLoading	当启用时，有延迟加载属性的对象在被调用时将会完全加载任意属性。否则，每种属性将会按需要加载。	true | false	true
multipleResultSetsEnabled	允许或不允许多种结果集从一个单独的语句中返回（需要适合的驱动）。	true | false	true
useColumnLabel	使用列标签代替列名。不同的驱动在这方便表现不同。参考驱动文档或充分测试两种方法来决定所使用的驱动。	true | false	true
useGeneratedKeys	允许JDBC支持生成的键。需要适合的驱动。如果设置为true则这个设置强制生成的键被使用， 尽管一些驱动拒绝兼容但仍然有效（比如Derby）。	true | false	false
autoMappingBehavior	指定MyBatis如何自动映射列到字段/属性。PARTIAL只会自动映射简单，没有嵌套的结果。FULL会自动映射任意复杂的结果（嵌套的或其他情况）。	NONE, PARTIAL, FULL	PARTIAL
defaultExecutorType	配置默认的执行器。SIMPLE执行器没有什么特别之处。REUSE执行器重用预处理语句。BATCH执行器重用语句和批量更新	SIMPLE, REUSE, BATCH	SIMPLE
defaultStatementTimeout	设置超时时间，它决定驱动等待一个数据库响应的时间。	Any positive integer	Not Set(null)

 

 

（2）、typeAliases

     类型别名是为Java类型命名一个短的名字。它只和XML配置有关，只用来减少类完全限定名的多余部分。如：

 

 

<!-- 类别名定义 -->
   <typeAliases>
	    <typeAlias type="com.mybatis.po.Student" alias="Student"/>
  </typeAliases>

（3）Environments元素

    可以配置多个运行环境，但是每个SqlSessionFactory 实例只能选择一个运行环境。

 

 

（a）、transactionManager事务管理器

 

MyBatis 有两种事务管理类型（即type=”[JDBC|MANAGED]”）：

 

JDBC – 这个配置直接简单使用了 JDBC 的提交和回滚设置。 它依赖于从数据源得 到的连接来管理事务范围。

MANAGED – 这个配置几乎没做什么。它从来不提交或回滚一个连接。而它会让 容器来管理事务的整个生命周期(比如 Spring 或 JEE 应用服务器的上下文) 默认 情况下它会关闭连接。 然而一些容器并不希望这样, 因此如果你需要从连接中停止 它,将 closeConnection 属性设置为 false。例如：

 

<transactionManager type="MANAGED">

<property name="closeConnection" value="false"/>

</transactionManager>

 

     （b）、dataSource数据源

 

dataSource 元素使用标准的JDBC 数据源接口来配置JDBC 连接对象源。

 

MyBatis 内置了三种数据源类型：

 

UNPOOLED – 这个数据源的实现是每次被请求时简单打开和关闭连接。它有一点慢, 这是对简单应用程序的一个很好的选择, 因为它不需要及时的可用连接。 不同的数据库对这 个的表现也是不一样的, 所以对某些数据库来说配置数据源并不重要, 这个配置也是闲置的。 UNPOOLED 类型的数据源仅仅用来配置以下 5 种属性:

 

driver – 这是 JDBC 驱动的 Java 类的完全限定名(如果你的驱动包含,它也不是 数据源类)。

url – 这是数据库的 JDBC URL 地址。

username – 登录数据库的用户名。

password – 登录数据库的密码。

defaultTransactionIsolationLevel – 默认的连接事务隔离级别。

作为可选项,你可以传递数据库驱动的属性。要这样做,属性的前缀是以“driver.”开 头的,例如:

 

driver.encoding=UTF8

这 样 就 会 传 递 以 值 “ UTF8 ” 来 传 递 属 性 “ encoding ”, 它 是 通 过 DriverManager.getConnection(url,driverProperties)方法传递给数据库驱动。

 

POOLED – 这是 JDBC 连接对象的数据源连接池的实现,用来避免创建新的连接实例 时必要的初始连接和认证时间。这是一种当前 Web 应用程序用来快速响应请求很流行的方 法。

 

除了上述(UNPOOLED)的属性之外,还有很多属性可以用来配置 POOLED 数据源:

 

poolMaximumActiveConnections – 在任意时间存在的活动(也就是正在使用)连 接的数量。默认值:10

poolMaximumIdleConnections – 任意时间存在的空闲连接数。

poolMaximumCheckoutTime – 在被强制返回之前,池中连接被检查的时间。默认 值:20000 毫秒(也就是 20 秒)

poolTimeToWait – 这是给连接池一个打印日志状态机会的低层次设置,还有重新 尝试获得连接, 这些情况下往往需要很长时间 为了避免连接池没有配置时静默失 败)。默认值:20000 毫秒(也就是 20 秒)

poolPingQuery – 发送到数据的侦测查询,用来验证连接是否正常工作,并且准备 接受请求。默认是“NO PING QUERY SET” ,这会引起许多数据库驱动连接由一 个错误信息而导致失败。

poolPingEnabled – 这是开启或禁用侦测查询。如果开启,你必须用一个合法的 SQL 语句(最好是很快速的)设置 poolPingQuery 属性。默认值:false。

poolPingConnectionsNotUsedFor – 这是用来配置 poolPingQuery 多次时间被用一次。 这可以被设置匹配标准的数据库连接超时时间, 来避免不必要的侦测。 默认值: 0(也就是所有连接每一时刻都被侦测-但仅仅当 poolPingEnabled 为 true 时适用)。

JNDI – 这个数据源的实现是为了使用如 Spring 或应用服务器这类的容器, 容器可以集 中或在外部配置数据源,然后放置一个 JNDI 上下文的引用。这个数据源配置只需要两个属 性:

 

initial_context – 这 个 属 性 用 来 从 初 始 上 下 文 中 寻 找 环 境 ( 也 就 是 initialContext.lookup(initial——context) 。这是个可选属性,如果被忽略,那么 data_source 属性将会直接以 initialContext 为背景再次寻找。

data_source – 这是引用数据源实例位置的上下文的路径。它会以由 initial_context 查询返回的环境为背景来查找,如果 initial_context 没有返回结果时,直接以初始 上下文为环境来查找。

和其他数据源配置相似, 它也可以通过名为 “env.” 的前缀直接向初始上下文发送属性。 比如:

 

env.encoding=UTF8

在初始化之后,这就会以值“UTF8”向初始上下文的构造方法传递名为“encoding” 的属性。