简介
MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以对配置和原生Map使用简单的 XML 或注解，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。[1]
本文将演示Mybatis的基本用法，通过XML或接口类对数据库的增删改查。
创建Mybatis项目
1、使用Idea创建一个maven项目，依赖包内容如下
<dependencies> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.38</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.4.4</version> </dependency> </dependencies>
2、创建Mybatis配置文件
使用Idea集成开发环境，可以下载Mybatis plugin，然后可更好的使用mybatis。关于mybatis的破解过程，参考附录的mybatis plugin 破解
新建Mybatis配置文件
项目文件内容
1、在resource目录下增加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>
<properties>
<property name="jdbc.driver" value="com.mysql.jdbc.Driver" />
<property name="jdbc.user" value="aihe" />
<property name="jdbc.pass" value="123456" />
<property name="jdbc.url" value="jdbc:mysql://localhost:3306/test" />
</properties>
<settings>
<!-- Globally enables or disables any caches configured in any mapper under this configuration -->
<setting name="cacheEnabled" value="true"/>
<!-- Sets the number of seconds the driver will wait for a response from the database -->
<setting name="defaultStatementTimeout" value="3000"/>
<!-- Enables automatic mapping from classic database column names A_COLUMN to camel case classic Java property names aColumn -->
<setting name="mapUnderscoreToCamelCase" value="true"/>
<!-- Allows JDBC support for generated keys. A compatible driver is required.
This setting forces generated keys to be used if set to true,
as some drivers deny compatibility but still work -->
<setting name="useGeneratedKeys" value="true"/>
</settings>
<!--便于后面解析对象-->
<typeAliases>
<package name="me.aihe" />
</typeAliases>
<!-- Continue going here -->
<environments default="dev">
<environment id="dev">
<transactionManager type="JDBC"></transactionManager>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}" />
<property name="url" value="${jdbc.url}" />
<property name="username" value="${jdbc.user}" />
<property name="password" value="${jdbc.pass}" />
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="BlogMapper.xml" />
</mappers></configuration>2、在resource目录下增加BlogMapper.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="me.aihe.dao.BlogMapper">
<select id="selectBlog" resultType="me.aihe.Blog">
select * from Blog where id = #{id} </select>
<insert id="insertBlog" parameterType="Blog">
insert into Blog (id,title) values (#{id},#{title}) </insert>
<update id="updateBlog" parameterType="Blog">
UPDATE Blog SET title=#{title} WHERE id=#{id} </update>
<delete id="deleteBlog" parameterType="integer">
DELETE FROM BLOG WHERE id=#{id} </delete></mapper>3、新建Blog对象
package me.aihe;public class Blog { int id;
String title; public int getId() { return id;
} public void setId(int id) { this.id = id;
} public String getTitle() { return title;
} public void setTitle(String title) { this.title = title;
} @Override
public String toString() { return "Blog{" + "id=" + id + ", title='" + title + '\'' + '}';
}
}4、新建主文件，Tutorial.java，并进行测试。
当前我们的数据表内容如下
新建数据表
5、Tutorial.java文件内容如下
package me.aihe;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 java.io.IOException;import java.io.InputStream;import java.util.Random;public class Tutorial { public static void main(String[] args) {
SqlSession sqlSession = null; try {
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); // 查询数据库内容
sqlSession = sqlSessionFactory.openSession();
Blog blog = sqlSession.selectOne("me.aihe.dao.BlogMapper.selectBlog",1);
System.out.println(blog); // 插入数据库内容
Blog b = new Blog();
b.setTitle("Insert Value" + new Random().nextInt(1000)); int row = sqlSession.insert("me.aihe.dao.BlogMapper.insertBlog",b);
System.out.println(row);
sqlSession.commit(); // 更新数据库内容
b.setId(2);
row = sqlSession.update("me.aihe.dao.BlogMapper.updateBlog",b);
System.out.println(row);
sqlSession.commit(); //删除数据库内容
row = sqlSession.delete("me.aihe.dao.BlogMapper.deleteBlog",1);
System.out.println(row);
sqlSession.commit();
} catch (IOException e) {
e.printStackTrace();
}finally { if (sqlSession != null) {
sqlSession.close();
}
}
}
}最终的项目结构如下
项目结构
6、运行结果
Blog{id=1, title='Hello Mybatis'}
1
1
1查看当前数据表的内容，可见查询了id为1的数据，插入了一条心的数据，更新了id为2 的数据，删除了id为1的数据。
演示后数据表内容
总结
这篇文章主要简单的演示了通过xml配置Mybatis，对数据库的增删改查。使用接口注解的方式类似，可自行查阅。关于更多高级用法，请听下回分解。
可扩充部分
接口注解增删改查
Mybatis配置属性详细介绍
更好的组织项目结构
错误汇总
1、mybatis-config.xml属性顺序错误
Exception in thread "main" org.apache.ibatis.exceptions.PersistenceException: ### Error building SqlSession. ### Cause: org.apache.ibatis.builder.BuilderException: Error creating document instance. Cause: org.xml.sax.SAXParseException; lineNumber: 50; columnNumber: 17; 元素类型为 "configuration" 的内容必须匹配 "(properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?)"
解决方案：mybatis-config.xml文件按照(properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?)进行顺序排列。
mybatis配置顺序
2、不能找到某个类文件
Exception in thread "main" org.apache.ibatis.exceptions.PersistenceException: ### Error building SqlSession.### The error may exist in BlogMapper.xml### Cause: org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: org.apache.ibatis.builder.BuilderException: Error parsing Mapper XML. Cause: org.apache.ibatis.builder.BuilderException: Error resolving class. Cause: org.apache.ibatis.type.TypeException: Could not resolve type alias 'Blog'. Cause: java.lang.ClassNotFoundException: Cannot find class: Blog
解决方案：两者选其一即可
1、在Mapper文件的resultType中返回为全路径
解决方案1
2、添加TypeAlias
解决方案2