Mybatis基础操作

Mybatis前身是Ibatis，Ibatis是apache的一个顶级开源项目。2010年迁移到Google
code，更名为Mybatis。Mybatis说起来也算的是一个基本的ORM，但是现对于Hibernate来说，就术语半自动的了，只是对数据的映射，没有涉及到sql的映射。
有了基本认识后咱们就切入正题了。

基本架构如下图



Mabytis配置，其中sqlMapConfig是全部配置文件，配置运行环境，而mapper为sql映射文件，此文件需要全局文件加载
通过mybatis环境等配置信息构造SqlSessionFactory即会话工厂
由会话工厂创建sqlSession即会话，操作数据库需要通过sqlSession进行，
mybatis底层自定义了Executor执行器接口操作数据库
Mapped Statement也是mybatis一个底层封装对象，它包装了mybatis配置信息及sql映射信息等。mapper.xml文件中一个sql对应一个Mapped
Statement对象，sql的id即是Mappedstatement的id

搭建Mybatis环境

下载mybatis，https://github.com/mybatis/mybatis-3/releases，该文档中使用的是3.2.7
需要依赖的包有
mybatis-3.2.7.jar----mybatis的核心包
lib----mybatis的依赖包

1 创建配置文件

创建log4j.properties文件，创建sqlMpaConfig.xml，因为mybatis依赖包中有log4j，所以需要配置属性文件
sqlMapConfig文件内容可以从mybatis包中说明文档中进行进行复制

sqlMapConfig 文件

<?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>

	<!-- 加载配置文件 -->
	<properties resource="db.properties"></properties>
		<!-- 懒加载配置 -->
		
	<!-- 别名定义  type类型路径 ，alias 别名-，单个别名-->
	<typeAliases >
		<!-- 批量别名定义，扫描整个包下的类，别名为类名（首字母大写或小写都可以） -->
		<package name="com.tgb.mybatis.po"/>
	</typeAliases>
	
	
	<!-- 和spring整合后 environments配置将废除 -->
	<environments default="development">
		<environment id="development">
			<!-- 使用jdbc事务管理 mybatis管理 -->
			<transactionManager type="JDBC" />
			<!-- 数据库连接池 由mybatis管理 -->
			<dataSource type="POOLED">
				<property name="driver" value="${jdbc.driver}" />
				<property name="url" value="${jdbc.url}" />
				<property name="username" value="${jdbc.username}" />
				<property name="password" value="${jdbc.password}" />
			</dataSource>
		</environment>
	</environments>

	<mappers>

	<!-- 通过mapper接口加载映射文件，必须保证 mapper接口类名和mapper.xml映射文件名称一致，并在一个目录中 -->
	<package name="com.tgb.mybatis.mapper"/>
	
	</mappers>
</configuration>

db.properties文件
该文件是配置数据库信息文件

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis
jdbc.username=root
jdbc.password=mysql

Logo4J文件

log4j.rootLogger=DEBUG, stdout
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

2 创建映射文件

映射文件的创建有两种方式，一种是ibatis原始方式，一种是mapper代理方式。问文档采用mapper代理方式
映射文件userMapper

<?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命名空间， 使用mapper代理开发，namespace 有特殊重要作用，namespace 
	等于mapper接口地址 -->
<mapper namespace="com.tgb.mybatis.mapper.UserMapper">

	<!-- 配置sql语句 -->
	<!-- 通过select 执行查询 id表示映射的slq ，成为statement 的id， 将sql语句封装到mapappedStatement对象中 -->
	<!-- 通过id查询用户表记录 #{}标识一个占位符号 #{id} 其中id表示输入的参数,参数名称id，若参数类型是简单类型，若 参数名称可以是任意，可以value或其他名称 
		parameterMap 和parameterType表示参数类型,这里指定int类型
		 resultType:指定sql输出结果的映射java对象类型，selec或指定resulType表示将单条记录映射的java对象 -->
	<select id="findUserById" parameterType="int"
		resultType="com.tgb.mybatis.po.User">
		select * from user where id=#{id}
	</select>

</mapper>

3 编写Mapper接口

UserMapper 接口

package com.tgb.mybatis.mapper; 

import com.tgb.mybatis.po.User;

/**
 * mapper接口相当于userdao
 *
 * @author hanyk
 * @version 1.0.0 , 2015年8月20日 下午7:51:44
 */
public interface UserMapper {

	
	//根据id 查询用户信息
	public User findUserById(int id)throws Exception; 
	
}

使用Mapper代理开发，只需要编写Mapper接口，不需要写实现代码，原理是mybatis内部根据接口生成代理对象，org.mybatis.spring.mapper.MapperFactoryBean

要求：
Mapper.xml文件中的namespace与mapper接口的类路径相同。
Mapper接口方法名和Mapper.xml中定义的每个statement的id相同
Mapper接口方法的输入参数类型和mapper.xml中定义的每个sql的parameterType的类型相同
Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同

测试：

private SqlSessionFactory sessionFactory;
	private String url = "SqlMapConfig.xml";

	@Before
	public void setUp() throws IOException {
		// 创建sqlsessionfacotry

		InputStream inputStream = Resources.getResourceAsStream(url);
		// 创建会话工厂
		sessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

	}

	//根据id 查询对象
	@Test
	public void testFindUserbyId() throws Exception {

		SqlSession session = sessionFactory.openSession();

		// 创建usermapper对象,自动生层代理对象
		UserMapper userMapper = session.getMapper(UserMapper.class);

		User user = userMapper.findUserById(1);
		session.close();//释放资源
		System.out.println(user);
	}

输出结果：
User [id=1, username=张宏民, sex=2,birthday=Thu Aug 20 00:00:00 CST
2015, address=廊坊市气象局]

小结：

Mybatis上手简单，主要是在于对sql语句的编写，相对于Hibernate重量级ORM框架，mybaits专注与sql本身，需要自己编写slq，适应希求变化较多的项目。