mybatis入门之Helloworld

Mybatis是一款优秀的持久层框架，支持定制化SQL、存储过程以及高级映射。

特点：

1、简单易学：只有一个jar包（很小），无任何第三方依赖，

2、灵活：sql语句写在xml配置文件里，便于统一管理和优化，

3、解除sql与代码的耦合：提高了可维护性。

首先从github上下载mybatis，下载地址：https://github.com/mybatis/mybatis-3

从浏览器上打开上面的地址后，看到下图，

点击 图中红框框，进入到下一页，如图：

一个是开发包mybatis.zip ,一个是源码包source code，下载下来以后，解压后如下图：

我们发现已有mybatis只有一个jar包，果然是小巧。

下面我们开始搭建我们的mybatis

新建一个java项目，项目结构如图：

导入mybatis-3.4.4.jar、mysql-connector-java-5.1.42-bin.jar、log4j-1.2.17.jar包

导入log4j-1.2.17.jar包是为了看日志使用。

Employee代码如：

package com.mybatis.model;

public class Employee {
	
	private Integer id ;
	private String lastName ;
	private String email ;
	private String gender ;
	public Integer getId() {
		return id;
	}
	public void setId(Integer id) {
		this.id = id;
	}
	public String getLastName() {
		return lastName;
	}
	public void setLastName(String lastName) {
		this.lastName = lastName;
	}
	public String getEmail() {
		return email;
	}
	public void setEmail(String email) {
		this.email = email;
	}
	public String getGender() {
		return gender;
	}
	public void setGender(String gender) {
		this.gender = gender;
	}
	@Override
	public String toString() {
		return "Employee [id=" + id + ", lastName=" + lastName + ", email="
				+ email + ", gender=" + gender + "]";
	}
	
	
}

我使用的是mysql数据库，新建一个mybatis名称的数据库，执行下面的代码，创建数据库表和添加数据：

DROP TABLE IF EXISTS `tb1_employee`;
CREATE TABLE `tb1_employee` (
  `id` int(11) NOT NULL auto_increment,
  `last_name` varchar(255) default NULL,
  `gender` varchar(20) default NULL,
  `email` varchar(255) default NULL,
  PRIMARY KEY  (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;

INSERT INTO `tb1_employee` VALUES ('1','tom','0','123@qq.com');

log4j.xml代码：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
 
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
 
 <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
   <param name="Encoding" value="UTF-8" />
   <layout class="org.apache.log4j.PatternLayout">
    <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m  (%F:%L) \n" />
   </layout>
 </appender>
 <logger name="java.sql">
   <level value="debug" />
 </logger>
 <logger name="org.apache.ibatis">
   <level value="info" />
 </logger>
 <root>
   <level value="debug" />
   <appender-ref ref="STDOUT" />
 </root>
</log4j:configuration>

EmployeeMapper.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">
<!-- 
	namespace:名称空间；
	id：唯一标识；
	resultType:返回值类型；
	#{id}:从传递过来的参数中取出id值
 -->
<mapper namespace="com.mybatis.model.Employee">
	<select id="selectEmp" resultType="com.mybatis.model.Employee">
		select id , last_name lastName , email , gender from tb1_employee where id = #{id}
	</select>
</mapper>

mybatis-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>
	<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://localhost:3306/mybatis" />
				<property name="username" value="root" />
				<property name="password" value="input your passowrd" />
			</dataSource>
		</environment>
	</environments>
	
	<!-- 将我们写好的sql映射文件一定要注册到全局配置文件中 -->
	<mappers>
		<mapper resource="./conf/EmployeeMapper.xml" />
	</mappers>
</configuration>

MybatisTest.java代码：

package com.mybatis.test;

import java.io.IOException;
import java.io.InputStream;

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.Test;

import com.mybatis.model.Employee;

public class MybatisTest {

	/**
	 * 1、根据xml配置文件常见SqlSessionFactory
	 * 2、
	 * @throws IOException
	 */
	@Test
	public void test() throws IOException {
		String resource = "conf/mybatis-config.xml";
		InputStream inputStream = Resources.getResourceAsStream(resource);
		SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
		//2、获取sqlSession实例，能直接执行已经映射的sql语句
		SqlSession session = sqlSessionFactory.openSession() ;
		/**
		 * sql的唯一标识：EmployeeMapper.xml中的 namespace+id
		 * 执行sql要调用的参数：
		 */
		try{
			Employee e = session.selectOne("com.mybatis.model.Employee.selectEmp", 1) ;
			System.out.println(e);
		}finally {
			session.close();
		}
	}

}

需要说明的是MybatisTest.java是一个Junit Test Case，如图：

运行test测试代码，控制台打印如图：

到此为止，说明mybatis已经搭建成功了。