MyBatis持久层框架
Maven Repository: MyBatis (mvnrepository.com)
本是apache的开源项目iBatis,2010年迁移到google code,并改名MyBatis,2013年迁移到GitHub
数据持久化,即将程序的数据在持久状态和瞬时状态转化的过程
内存:断电即失
为什么使用?
1.方便,传统JDBC代码过于复杂,帮助程序员将数据存入到数据库
2.Sql和代码的分离,提供可维护性
3.提供映射标签,支持对象与数据库orm字段关系映射
4.提供对象关系映射标签,支持对象关系组建维护
5.提供xml标签,支持编写动态sql
使用案例
- 创建Maven项目父工程,删除src包,导入mysql、mybatis、junit的依赖
- 创建Module-Maven
- 子工程中的resource中创建xml核心配置文件,即连接数据库以及对Mapper.xml的映射,构建SqlSessionFactory
- 创建实体类POJO(User)
- 创建工具类,从SqlSessionFactory中获取SqlSession(即操作数据库的对象)
6.创建UserMapper接口
7.如果是JDBC即继续创建实现类实现接口的方法,mybatis使用xml(即UserMapper.xml)实现
类名和方法名一定要和接口保持一致!!
8.编写测试类:
- 首先使用工具类的getSqlSession返回SqlSession类型的操作数据库的对象
- UserMapper mapper = sqlSession.getMapper(UserMapper.class);
- 调用mapper的自己编写的操作数据库的方法(这些方法由xml文件编写的sql语进行执行)
可能遇到的问题(即注意点)
1.配置文件没有注册
2.绑定接口错误
解决方法:在mybatis-config.xml中,mapper不能去掉
每一个Mapper.xml(即实现Mapper接口的xml文件【里面即对数据库的操作方法】)都需要在Mybatis核心配置文件中注册
3.方法名不对
即Mapper接口和对应的xml文件中的id一定要一致
4.Maven导出资源问题
一般来说我们创建的xml文件放入resource文件夹中,但是该项目中,我们将UserMapper.xml放入src中
Cause: org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: java.io.IOException: Could not find resource com/wang/dao/UserMapper.xml
导致出现无法找到该UserMapper.xml(配置文件中写了映射,但是未找到该文件)
于是在父pom.xml依赖中写上,在build中配置resource,来防止我们资源到处失败的问题
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
</resources>
</build>
5.xml注解格式错误
Cause: org.apache.ibatis.builder.BuilderException: Error creating document instance. Cause: com.sun.org.apache.xerces.internal.impl.io.MalformedByteSequenceException: 1 字节的 UTF-8 序列的字节 1 无效。
由于我们从Mybatis的官网入门文档中复制xml文件格式是
我们将中文注解全部删除或者,将编码改为GBK或者UTF8即可
作用域
- SqlSessionFactoryBuilder:该类可以被实例化、使用和丢弃,一旦创建SqlSessionFactory就不再需要它。最佳作用域是方法作用域
- SqlSessionFactory:一旦被创建就也应该在应用的运行期间一直存在,没有任何理由丢弃或重新创建另一个实例。最简单的方式就是单例模式或者静态单例模式,最佳作用域是应用作用域
- SqlSession,每个线程都应该有自己的SqlSession实例,不是线程安全的因此不能被共享,最佳作用域是请求或方法作用域,绝不可以将其实例引用放入类的静态域或者一个类的实例变量。每次收到HTTP请求就可以打开一个SqlSession返回一个响应然后关闭,关闭操作很重要!
增删改查的实现
有了以上例子,增删改查的功能很简单即可实现,只需要动接口类和实现接口的xml文件
public interface UserMapper {
List<User> getAllUser();
User getUserById(int id);
int addUser(User user);
int updateUser(User user);
int deleteUser(int id);
}
<?xml version="1.0" encoding="GBK" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace绑定一个Dao接口-->
<mapper namespace="com.wang.dao.UserMapper">
<!-- 查询语句-->
<select id="getAllUser" resultType="com.wang.pojo.User">
select * from user
</select>
<select id="getUserById" resultType="com.wang.pojo.User" parameterType="int">
select * from user where id=#{id}
</select>
<insert id="addUser" parameterType="com.wang.pojo.User">
insert into User(id,name,pwd) values (#{id},#{name},#{pwd})
</insert>
<update id="updateUser" parameterType="com.wang.pojo.User">
update user set name=#{name},pwd=#{pwd} where id=#{id}
</update>
<delete id="deleteUser" parameterType="int">
delete from user where id=#{id}
</delete>
</mapper>
package com.wang.dao;
import com.wang.pojo.User;
import com.wang.utils.MyBatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;
public class UserTest {
@Test
public void test(){
//获得操作数据库的对象
//执行sql语句
try (SqlSession sqlSession = MyBatisUtils.getSqlSession()) {
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List<User> user = mapper.getAllUser();
for (User u : user
) {
System.out.println(u);
}
} catch (Exception e) {
e.printStackTrace();
}
}
@Test
public void test2(){
//获得操作数据库的对象
//执行sql语句
try (SqlSession sqlSession = MyBatisUtils.getSqlSession()) {
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
System.out.println(mapper.getUserById(1));
} catch (Exception e) {
e.printStackTrace();
}
//关闭
}
@Test
public void addTest(){
//获得操作数据库的对象
//执行sql语句
try (SqlSession sqlSession = MyBatisUtils.getSqlSession()) {
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user1 = new User(4,"lu","123456");
System.out.println(mapper.addUser(user1));
sqlSession.commit();
} catch (Exception e) {
e.printStackTrace();
}
//关闭
}
@Test
public void updateTest(){
//获得操作数据库的对象
//执行sql语句
try (SqlSession sqlSession = MyBatisUtils.getSqlSession()) {
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user1 = new User(5,"wangwang","123456");
if(mapper.getUserById(user1.getId())!=null){
System.out.println(mapper.updateUser(user1));
sqlSession.commit();
}else System.out.println("用户不存在");
} catch (Exception e) {
e.printStackTrace();
}
//关闭
}
@Test
public void deleteTest(){
//获得操作数据库的对象
//执行sql语句
try (SqlSession sqlSession = MyBatisUtils.getSqlSession()) {
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
if(mapper.getUserById(4)!=null){
System.out.println(mapper.deleteUser(4));
sqlSession.commit();
}else System.out.println("用户不存在");
} catch (Exception e) {
e.printStackTrace();
}
//关闭
}
}