MyBatis使用入门
最近项目用到了Mybatis，这个东西以前用过，不过好久不用，稍显生疏，并且当时用的是ibatis-2.x版本，现在已经更新到mybatis-3.2.0-SNAPSHOT，功能和特性有好多更新。今天下午抽了个时间重新读了下文档，发现基本特性上变化不太大。注意本文记录的是基本的内容，仅用作记录，供参考。
本文使用mybatis-3.1.1.jar包
MyBatis作为持久层框架，主要思想就是讲sql从程序中剥离出来，卸载配置文件中，实现灵活配置。
好处是将Sql和程序剥离，在不修改程序代码的情况下，通过直接修改sql来更新业务内容。
缺点是需要自行写Sql语句，这点也总是被拿来和Hibernate作对比，不过作为程序猿/媛，Sql也是修炼中的一环，个人认为这个反而应该是最大的优点才对。自己编写的Sql语句才能在性能上面有所保证，而Hibernate处理Sql优化这块还是过于依赖框架本身了。
本文作为示例教程，仅简单实现CRUD操作，更细致的操作请参考官方的文档：http://code.google.com/p/mybatis/
使用建表语句，在mysql中建立如下user表：
CREATE TABLE `user` ( `id` bigint(20) NOT NULL auto_increment, `userId` varchar(32), `userName` varchar(30) character set utf8 NOT NULL, `password` varchar(80) character set utf8 NOT NULL, `comment` varchar(250) character set utf8 default NULL,primary key(`id`) ) ENGINE=MyISAM AUTO_INCREMENT=5 DEFAULT CHARSET=utf8;
我们先看下configuration.xml配置文件，主要是配置数据库环境和mapper.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://10.11.200.226:3306/gdd?characterEncoding=UTF-8" />
<property name="username" value="root" />
<property name="password" value="1234" />
</dataSource>
</environment>
<environment id="online">
<transactionManager type="JDBC" />
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://10.11.200.226:3306/gdd?characterEncoding=UTF-8" />
<property name="username" value="root" />
<property name="password" value="1234" />
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/mybatis/application/UserDaoMapper.xml"/>
</mappers>
</configuration>
这个文件里面有development和online环境，可以再代码中选择使用不同的配置。
UserDaoMapper.xml文件，这个文件保存的是Sql语句和POJO之间映射关系。
<?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.application.UserDao">
<select id="selectAll" resultType="com.mybatis.application.User">
select * from user order by userName asc
</select>
<insert id="insert" parameterType="com.mybatis.application.User">
insert into user(userId,userName,password,comment) values(#{userId},#{userName},#{password},#{comment})
</insert>
<update id="update" parameterType="com.mybatis.application.User">
update user set userId=#{userId},password=#{password},comment=#{comment} where userName=#{userName}
</update>
<delete id="delete" parameterType="String">
delete from user where userName=#{userName}
</delete>
<select id="findUserByName" parameterType="String" resultType="com.mybatis.application.User">
select * from user where userName=#{userName} limit 1
</select>
</mapper>
其中#{userName}是传入的参数，这个参数的要求比较严格，parameterType是参数类型，resultType是查询返回的数据类型。
User POJO实体类：
package com.mybatis.application;
public class User {
private String id;
private String userId;
private String userName;
private String password;
private String comment;
public String getId () {
return id;
}
public void setId ( String id ) {
this.id = id;
}
public String getUserId () {
return userId;
}
public void setUserId ( String userId ) {
this.userId = userId;
}
public String getUserName () {
return userName;
}
public void setUserName ( String userName ) {
this.userName = userName;
}
public String getPassword () {
return password;
}
public void setPassword ( String password ) {
this.password = password;
}
public String getComment () {
return comment;
}
public void setComment ( String comment ) {
this.comment = comment;
}
}
UserDao内容，这个主要是实现功能和Sql的映射，在ibatis中，还需要UserDaoImpl实现，现在直接定好好UserDao接口，就可以直接建立Sql和功能的映射，这个还真是个方便之处。
package com.mybatis.application;
import java.util.List;
public interface UserDao {
public int insert(User user);
public int update(User user);
public int delete(String userName);
public List<User> selectAll();
public User findUserByName(String userName);
}
最早使用这个Dao的时候，还需要有实现，现在只要方法名和定义的Sql id一致即可，这个也节省好多代码量。
UserDaoTest内容，本来是想引用JUnit进行测试的，后来Eclipse MVN出了点问题，更新超慢还卡死，就不再使用Junit，但是代码尽量靠近Junit的测试风格。
package com.mybatis.application;
import java.io.IOException;
import java.io.Reader;
import java.util.Iterator;
import java.util.List;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class UserDaoTest {
private static SqlSessionFactory sqlSessionFactory;
static {
String resource = "configuration.xml";
Reader reader = null;
try {
reader = Resources.getResourceAsReader(resource);
} catch (IOException e) {
e.printStackTrace();
}
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
sqlSessionFactory = builder.build(reader);
}
public static void main(String[] args) throws Exception{
testInsert();
testQuery();
testUpdate();
testQuery();
testDelete();
testQuery();
}
public static void testInsert(){
SqlSession session = sqlSessionFactory.openSession();
UserDao userDao = session.getMapper(UserDao.class);
User user = new User();
user.setUserId("ID0001");
user.setUserName("tiancaixiangshi");
user.setPassword("ppnn18%");
user.setComment("wtf");
userDao.insert(user);
session.commit();
session.close();
}
public static void testUpdate(){
SqlSession session = sqlSessionFactory.openSession();
UserDao userDao = session.getMapper(UserDao.class);
User user = new User();
user.setUserId("ID" + System.currentTimeMillis());
user.setUserName("tiancaixiangshi");
user.setPassword("ppnn18%");
user.setComment("WTF");
userDao.update(user);
session.commit();
session.close();
}
public static void testDelete(){
SqlSession session = sqlSessionFactory.openSession();
UserDao userDao = session.getMapper(UserDao.class);
userDao.delete("tiancaixiangshi");
session.commit();
session.close();
}
public static void testQuery(){
SqlSession session = sqlSessionFactory.openSession();
UserDao userDao = session.getMapper(UserDao.class);
List<User> users = userDao.selectAll();
Iterator<User> iter = users.iterator();
while (iter.hasNext()) {
User u = iter.next();
System.out.println("userid:" + u.getUserId() + " username：" + u.getUserName() + " password：" + u.getPassword());
}
session.commit();
session.close();
}
}
在写Mapper.xml文件时，需要注意Dao类和POJO对象的完整路径，如果定义不对的话，会出现下面这两种异常情况：
Type interface XXX is not known to the MapperRegistry
Mapped Statements collection does not contain value for userName
这两个错误的话注意检查类和对象的路径，另外就是检查Sql的语句是否准确。
再说两句额外的话，MyBatis的本身定位是数据持久化框架，看官方文档，MyBatis作为IoC的一部分和Spring、Guice结合，大大减轻了开发者的工作量。如果现在的场景并没有Spring、Guice这样的框架，还想用MyBatis怎么办？其实很简单，直接使用mybatis-core部分就可以完成工作。我们需要理解框架的定位，离开Spring我们还是可以继续玩的转的。
如果选择只用Mybatis，弃掉Spring的话，需要自己管理SqlSession，实现自己的业务内容。如果离开了Spring，并不能操作MyBatis的话，就需要反思自己的知识体系了。
本文的内容比较简单，仅作为参考吧，其中需要注意的地方还是有一些的。
相关推荐
mybatis在持久层框架中还是比较火的，一般项目都是基于ssm。虽然mybatis可以直接在xml中...《MyBatis-Plus入门文档》主要介绍了MyBatis-Plus入门使用，以及关于mybatis-plus的更多介绍及特性，感兴趣的可以下载学习一下
《Spring MVC+MyBatis开发从入门到项目实战》适用于拥有Java基础的软件开发人员学习框架开发，也适用于大中专院校在校师生学习开发技术，以及软件从业实习生提升框架开发技术水平，也可作为高等院校计算机及相关专业...
本资源主要讲解Spring MVC和MyBatis的开发，从入门到项目实战，涵盖了开发环境搭建、JDK安装与配置、MyEclipse的安装与使用、第一个Java类的编写、MyBatis技术入门、传统JDBC开发模式的缺陷、MyBatis的介绍、MyBatis...
mybatis
mybatis入门案例mybatis入门案例mybatis入门案例mybatis入门案例mybatis入门案例mybatis入门案例mybatis入门案例mybatis入门案例mybatis入门案例mybatis入门案例mybatis入门案例mybatis入门案例mybatis入门案例...
SpringMVC+MyBatis开发从入门到实践源码，包含各个章节代码和所需的jar包。导入myeclipse10即可运行
MyBatis3入门到精通教程，比较经典，通俗易懂，讲的很实用，一看就懂。
MyBatis入门 MyBatis是一个优秀的持久层框架，使用XML将SQL与程序解耦，便于维护。MyBatis学习简单，执行高效，是JDBC的延伸。MyBatis提供了数据库增删改查的便捷操作，极大提高了开发效率、统一的编码规则、利于...
mybatis学习-入门（1）-单独使用mybatis
MyBatis入门到精通，PDF，新手不错的学习资料。完整版的文档。
MyBatis从入门MyBatis从入门MyBatis从入门MyBatis从入门MyBatis从入门
MyBatis-Plus（简称 MP）是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。
MyBatis3（入门教程）讲述的是MtBatis的基础用法,内容不错.拿来分享
mybatis实战教程(mybatis in action)之一：开发环境搭建 .....................................................mybatis实战教程(mybatis in action)之九:mybatis 代码生成工具的使用 ......................... 41
mybatis入门程序 用户的增、删、改、查 mybatis开发dao两种方法： ① :原始dao开发方法（程序需要编写dao接口和dao实现类）（掌握） ② :mybaits的mapper(代理)接口（相当于dao接口）代理开发方法（掌握）第二...
SpringMVC+mybatis入门项目：旅游网站
MyBatis 是一款优秀的持久层框架：它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML...此次是： Mybatis的入门项目的创建流程
【Spring+MyBatis+MySQL实战入门】一、MyBatis操作入门的源码
Mybatis入门
MyBatis框架的学习(二)——MyBatis架构与入门