Mybatis之入门Helloworld程序

本篇我们来实现一个Mybatis的Helloworld级别的一个示例程序。

一、搭建基本环境

1、基本开发环境搭建，这里选择: eclipse j2ee 版本，mysql 5.1 ,jdk 1.8,mybatis3.2.7.jar包。这些软件工具均可以到各自的官方网站上下载。

2、建立一个名字为 MyBaits 的 dynamic web project，也就是一个java web项目。事实上我们可以直接建立java 工程，但一般MyBaits都是开发web项目，所以就建立web工程。

3、加入相关的jar包。包括Mybatis的jar包，mysql的驱动包以及其他依赖包。如下图：

4、创建mysql测试数据库Mybatis和用户表,并插入一条记录。

创建语句如下：

CREATE TABLE `user` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `userName` varchar(50) DEFAULT NULL,
  `userAge` int(11) DEFAULT NULL,
  `userAddress` varchar(200) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8

插入语句：

Insert INTO `user` VALUES ('1', 'kang', '24', 'Chengdu');



二、编写Mybatis的项目代码

基本环境搭建完毕后，可以编写项目代码。

1、设置Mybatis的配置文件

首先在MyBatis 里面创建两个源码目录，分别为 src_user,test_src, 鼠标右键点JavaResource即可创建。

之后在src_user目录下建立创建Configuration.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 alias="User" type="com.kang.mybatis.model.User" />
	</typeAliases>

	<!-- 和spring整合后 environments配置将废除 -->
	<environments default="development">
		<environment id="development">
			<!-- 使用jdbc事务管理 -->
			<transactionManager type="JDBC" />
			<!-- 数据库连接池 -->
			<dataSource type="POOLED">
				<property name="driver" value="com.mysql.jdbc.Driver" />
				<property name="url"
					value="jdbc:mysql://192.168.1.148:3306/mybatis?characterEncoding=utf-8" />
				<property name="username" value="root" />
				<property name="password" value="root" />
			</dataSource>
		</environment>
	</environments>
	<mappers>
		<mapper resource="com/kang/mybatis/model/User.xml" />
	</mappers>
</configuration>

2、建立与数据库对应的POJO类,以及映射文件

在src_user下建立package:com.kang.mybatis.model ,并在这个 package 下建立 User 类

package com.kang.mybatis.model;

public class User {

	private int id;
	private String userName;
	private String userAge;
	private String userAddress;

	public int getId() {
		return id;
	}

	public void setId(int id) {
		this.id = id;
	}

	public String getUserName() {
		return userName;
	}

	public void setUserName(String userName) {
		this.userName = userName;
	}

	public String getUserAge() {
		return userAge;
	}

	public void setUserAge(String userAge) {
		this.userAge = userAge;
	}

	public String getUserAddress() {
		return userAddress;
	}

	public void setUserAddress(String userAddress) {
		this.userAddress = userAddress;
	}

	@Override
	public String toString() {
		return "User [id=" + id + ", userName=" + userName + ", userAge=" + userAge + ", userAddress=" + userAddress
				+ "]";
	}

}

之后在同一个包下建立相应的映射文件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.kang.mybatis.models.UserMapper">
	<select id="selectUserByID" parameterType="int" resultType="com.kang.mybatis.model.User">
		select * from `user` where id = #{id}
	</select>
</mapper>

下面对这几个配置文件解释下：

Configuration.xml 是 mybatis 用来建立 sessionFactory 用的，里面主要包含了数据库连接相关东西，还有 java 类所对应的别名，比如 <typeAlias alias="User" type="com.kang.mybatis.model.User"/> 这个别名非常重要，你在 具体的类的映射中，比如User.xml 中 resultType 就是对应这里的。要保持一致，当然这里的 resultType 还有另外单独的定义方式，后面再说。

Configuration.xml 里面 的<mapper resource="com/kang/mybatis/model/User.xml"/>是包含要映射的类的xml配置文件。

在User.xml 文件里面 主要是定义各种SQL 语句，以及这些语句的参数，以及要返回的类型等。





3、开始测试

在test_src 源码目录下建立com.kang.test这个package,并建立测试类Test:

package com.kang.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 com.kang.mybatis.model.User;

public class Test {
	private static SqlSessionFactory sqlSessionFactory;
	private static Reader reader;

	static {
		try {
			reader = Resources.getResourceAsReader("Configuration.xml");
			sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

	public static SqlSessionFactory getSession() {
		return sqlSessionFactory;
	}

	public static void main(String[] args) {
		SqlSession session = sqlSessionFactory.openSession();
		try {
			User user = (User) session.selectOne("com.kang.mybatis.models.UserMapper.selectUserByID", 1);
			System.out.println(user);
		} finally {
			session.close();
		}
	}
}

4、运行结果如下：

项目总目录如下：