一、什么是MyBatis?
MyBatis是一个优秀的持久层框架,它对jdbc的操作数据库的过程进行封装,使开发者只需要关注 SQL 本身,而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。
Mybatis通过xml或注解的方式将要执行的各种statement(statement、preparedStatemnt)配置起来,并通过java对象和statement中的sql进行映射生成最终执行的sql语句,最后由mybatis框架执行sql并将结果映射成java对象并返回。
二、它相对JDBC的好处
1、使用传统方式JDBC访问数据库:
(1)使用JDBC访问数据库有大量重复代码(比如注册驱动、获取连接、获取传输器、释放资源等)
(2)JDBC自身没有连接池,会频繁的创建连接和关闭连接,效率低
(3)SQL是写死在程序中,一旦修改SQL,需要对类重新编译。
(4)对查询SQL执行后返回的ResultSet对象,需要手动处理,有时会特别麻烦
2、使用mybatis框架访问数据库:
(1)Mybatis对JDBC对了封装,可以简化JDBC代码。
(2)Mybatis支持连接池(也可以配置其他的连接池),因此可以提高程序的效率
(3)Mybatis是将SQL配置在mapper文件中,修改SQL只是修改配置文件,类不需要重新编译。
(4)对查询SQL执行后返回的ResultSet对象,Mybatis会帮我们处理,转换成Java对象。
三、使用MyBatis过程
1.我们先准备一个数据库,创建表和数据(员工表emp)
2.创建工程,导入所需jar包、创建测试类
3.导入mysql驱动包
4.引用所有jar包( build path)
5.创建com.aaa.test.TestMybatis测试类,并提供findAll方法(查询emp表中所有的员工信息)
6.添加sqlMapConfig.xml文件
--1、在src目录下,创建sqlMapConfig.xml文件 (MyBatis的核心配置文件)
--2、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">
<!-- MyBatis的全局配置文件 -->
<configuration >
</configuration>
7.编写Emp实体类
--实现Emp类: 提供私有属性以及对应的getter方法、setter方法,并重写toString方法
8.添加EmpMapper.xml文件**
--1、在src/com/aaa/pojo目录下,创建EmpMapper.xml文件(实体类的映射文件)
--2、EmpMapper.xml文件配置如下:
EmpMapper文件头信息如下:
<?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一般指定为当前文件的所在包路径+文件名(将来是接口名)
在程序中通过[ **namespace**+ **id** ]定位到执行哪一条SQL语句
-->
<mapper namespace=*""*>
</mapper>
9.实现测试类,并测试
public void findAll() throws IOException{
//1.读取sqlMapConfig.xml文件,获取连接数据库的基本信息
InputStream in = Resources.getResourceAsStream("sqlMapConfig.xml");
//2.创建SqlSessionFactory工厂对象,
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(in);
//3.通过工厂获取一个SqlSession对象(用于执行SQL及返回结果)
SqlSession session = factory.openSession();
//4.执行查询操作,查询emp表中的所有记录
String sqlId = "com.aaa.pojo.EmpMapper.findAll";
List<Emp> emplist = session.selectList( sqlId );
//5.打印list集合
for(Emp emp : emplist){
System.out.println(emp);
}
}
**由于这次使用数据都需要用到上述前三个过程,因此我们可以把其抽取出来**
private SqlSessionFactory factory;
private SqlSession session = null;
//Before 在每次执行@Test方法之前都会执行
//当前这个方法
@Before
public void init() throws Exception {
//1. 读取sqlMapConfig.xml文件,获取配置信息
InputStream in = Resources.getResourceAsStream("sqlMapConfig.xml");
//2. 通过配置信息,创建一个sqlSessionFactory对象
factory = new SqlSessionFactoryBuilder().build(in);
//3. 通过工厂获取selSession对象
session = factory.openSession();
}
四、MyBatis入门细节
1、pojo(Plain Ordinary Java Object): 简单的Java对象,实际就是普通JavaBean,也叫做实体类,用于封装一类信息。例如:提供Emp类,用于封装和用户相关的属性信息,比如id员工编号、name员工姓名、job员工职位、salary薪资等。再例如:提供Product类,用于封装和商品相关的属性信息,比如id商品编号、name商品名称、price单价等。
而属性一般是私有的,因此我们还会提供属性相关的setter和getter方法。
我们一般会把实体类,放在pojo目录下,而和实体类相关的mapper文件,也放在相同的目录下(Maven工程除外)
2、EmpMapper.xml:Emp实体类的映射文件,和Emp类放在同一目录下(Maven工程除外)
3、sqlMapConfig.xml:mybatis的全局配置文件,很多配置信息都会在这里进行配置,比如事务、连接数据库基本信息,连接池(数据源)等配置
4、lib及下的jar包:将所需jar包拷贝过来后,还需要引用jar包到工程,也就是选中jar包,右键 --> Build Path --> Add to Build Path即可!
五、错误信息
例如:
### Error querying database. Cause: org.apache.ibatis.executor.ExecutorException: A query was run and no Result Maps were found for the Mapped Statement 'com.aaa.pojo.EmpMapper.findAll'. It's likely that neither a Result Type nor a Result Map was specified.
### The error may exist in com/aaa/pojo/EmpMapper.xml
### The error may involve defaultParameterMap
### The error occurred while setting parameters
### SQL: select * from emp
修改错误:com/aaa/pojo/EmpMapper.xml中的r.findAll的resultType信息出错。