MyBatis环境配置及入门

1. 在本教程中，建立 java 工程，但一般都是开发 web 项目，这个系列教程最后是 web，但这里为了方便学习，本教程前面建立的都是 java 工程。
2. 将 mybatis-3.2.3.jar，mysql-connector-java-5.1.25-bin.jar 创建两个用户自定库（user libary）：mysql-connector 和 mybatis；
3. 创建 mysql 测试数据库和用户表, 注意，数据库使用的是 utf-8 编码。以解决不必要的中文乱码问题。

一、创建 java 工程

首先建立一个名字为 helloword 的 java project。选择 "file" -> "new" ->"java project"，如下图所示：

这样就创建了一个 java 工程了，我们继续下一步。接下来我们在 mybatis-start 项目中加入两个所需的程序库：mysql-connector 和 mybatis，右键点击 "mybatis-start" 项目，从弹出的菜单中选择： "build path" -> "add libaries..." ，如下图所示：

从中选择“user library"，点击“next>"，创建两个类库为：mysql-connector 和 mybatis，如下所示：

点击“user libararies..."，继续下一步，创建一个新的类库，如下图所示：

到此用户的一个类库创建完成，以相同的方式来创建另一个类库：

二、创建数据库和 user 表

创建所需的数据库和表，要创建的数据库是：h3，并在 h3 数据库创建一个表：user，如下图所示：

创建数据库：h3，使用 utf-8 编码。

接下我们创建一个表：user，并插入一条记录信息，其结构如下所示：

create table `user` (
  `id` int(10) unsigned not null auto_increment,
  `name` varchar(64) not null default '',
  `dept` varchar(254) not null default '',
  `website` varchar(254) default '',
  `phone` varchar(16) not null default '',
  primary key (`id`)
) engine=innodb auto_increment=2 default charset=latin1;

-- ----------------------------
-- records of user
-- ----------------------------
insert into `user` values ('1', 'h3', 'tech', 'http://www.h3.com', '13800009988');

三、创建 mybatis 配置文件

到此为止，前期准备工作就完成了。下面开始真正配置 mybatis-start 项目。设置 mybatis 配置文件: configure.xml, 在 src/config 目录下建立此文件，内容如下:

<?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 alias="user" type="com.h3.mybatis.models.user" />
	</typealiases>
	<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/h3" />
			    <property name="username" value="root" />
			    <property name="password" value="" />
                       </datasource>
		</environment>
	</environments>

	<mappers>
	     <!-- // power by http://www.h3.com -->
	     <mapper resource="com/h3/mybatis/models/user.xml" />
	</mappers>
</configuration>

四、创建实体类和映射文件

首先创建一个包：com.h3.mybatis.models，并在下创建与数据库表对应的 user.java 类及其映射文件：user.xml，详细如下图所示：

package com.h3.mybatis.models;

public class user {
	private int id;
	private string name;
	private string dept;
	private string phone;
	private string website;
	
	public string getwebsite() {
		return website;
	}
	public void setwebsite(string website) {
		this.website = website;
	}
	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 getdept() {
		return dept;
	}
	public void setdept(string dept) {
		this.dept = dept;
	}
	public string getphone() {
		return phone;
	}
	public void setphone(string phone) {
		this.phone = phone;
	}
	
}

同时建立这个 user 类对应的映射文件 user.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.h3.mybatis.models.usermapper">
	<select id="getuserbyid" parametertype="int" resulttype="user">
		select * from `user` where id = #{id}
    </select>
</mapper>

下面是对这几个配置文件一点解释说明：
1、配置文件 configure.xml 是 mybatis 用来建立 sessionfactory，里面主要包含了数据库连接相关内容，还有 java 类所对应的别名，比如：<typealias alias="user" type="com.h3.mybatis.models.user"/> 这个别名非常重要，在具体的类的映射中，比如：user.xml 中 resulttype 就是对应这个。要保持一致，这里的 resulttype 还有另外单独的定义方式，后面学习到我们再详细介绍说明。
2、configure.xml 里面的<mapper resource="com/h3/mybatis/models/user.xml"/>是包含要映射的类的 xml 配置文件。
3、在user.xml 文件里面主要是定义各种 sql 语句，以及这些语句的参数，以及要返回的类型等等。

五、运行程序测试结果

在 src 源码目录下建立一个类叫作：helloword, 来运行测试配置环境是否成功，具体代码如下示：

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 com.h3.mybatis.models.*;

/**
 * 
 * @author h3
 * @copyright http://www.h3.com
 * @date 2015/09/22
 */
public class helloword {
	private static sqlsessionfactory sqlsessionfactory;
	private static reader reader;

	static {
		try {
			reader = resources.getresourceasreader("config/configure.xml");
			sqlsessionfactory = new sqlsessionfactorybuilder().build(reader);
		} catch (exception e) {
			e.printstacktrace();
		}
	}
	public static sqlsessionfactory getsession() {
		return sqlsessionfactory;
	}
	/**
	 * @param args
	 */
	public static void main(string[] args) {
		// todo auto-generated method stub
		sqlsession session = sqlsessionfactory.opensession();
		try {
			user user = (user) session.selectone(
					"com.h3.mybatis.models.usermapper.getuserbyid", 1);
			if(user!=null){
				string userinfo = "名字："+user.getname()+", 所属部门："+user.getdept()+", 主页："+user.getwebsite();
				system.out.println(userinfo);
			}
		} finally {
			session.close();
		}
	}

}

现在运行这个程序，不是得到查询结果了？正确的输出结果应该如下：

名字：h3, 所属部门：tech, 主页：http://www.h3.com

恭喜你，环境搭建配置成功，在接下来章节，我们将学习 mybatis 的操作方式：增删改查。