1、什么是 MyBatis?
- MyBatis 是一款优秀的持久层框架。
- 它支持自定义 SQL、存储过程以及高级映射。
- MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
- MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录。
- MyBatis本是apache的一个开源项目iBatis,2010年这个项目由apache software foundation迁移到了google code,并且改名为MyBatis。
- 2013年11月迁移到Github。
如何获得Mybatis?
1、Maven仓库:
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.2</version>
</dependency>
2、Github:Releases · mybatis/mybatis-3 · GitHub
3、中文文档:mybatis – MyBatis 3 | 入门
什么是持久化?
数据持久化
- 持久化就是将程序的数据从瞬时状态到持久状态的转化的过程。
- 内存断电即失
- 数据库(JDBC)、IO文件持久化
为什么需要持久化?
- 重要的数据需要保存
- 内存太贵
持久层
- 完成持久化工作的代码块
- 层的界限十分明显
为什么需要Mybatis?
- 方便
- 传统JDBC代码太复杂,需要简化
- 帮助程序员将数据存入数据库中
Mybatis优点:
-
简单易学
-
灵活
-
解除sql与程序代码的耦合:通过提供DAO层,将业务逻辑和数据访问逻辑分离,使系统的设计更清晰,更易维护,更易单元测试。sql和代码的分离,提高了可维护性。
-
提供映射标签,支持对象与数据库的ORM字段关系映射。
-
提供对象关系映射标签,支持对象关系组建维护。
-
提供xml标签,支持编写动态sql
最重要的一点:使用的人多!
2、第一个Mybatis程序
思路:搭建环境-导入Mybatis-编写代码-测试!
2.1 搭建环境:
步骤:创建数据库、创建Maven项目、 编写Mybatis配置文件和工具类。
创建数据库:
CREATE DATABASE `mybatis`;
USE `mybatis`;
CREATE TABLE `user`(
`id` INT(20) NOT NULL PRIMARY KEY,
`name` VARCHAR(30) DEFAULT NULL,
`pwd` VARCHAR(30) DEFAULT NULL
)ENGINE=INNODB DEFAULT CHARSET=utf8;
INSERT INTO `user`(`id`,`name`,`pwd`) VALUES
(1,'狂神','123456'),
(2,'张三','123456'),
(3,'Johnson','123456')
创建一个普通的Maven项目,删除src文件夹,在pom.xml导入依赖:
<!-- 导入依赖 -->
<dependencies>
<!--MySQL驱动-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
<!-- Mybatis-->
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.2</version>
</dependency>
<!--junit-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
</dependencies>
创建一个module mybatis-01,
编写Mybatis的配置文件(在module-src-main-resource下新建mybatis-config.xml):
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"https://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://localhost:3306/mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
<!--每个Mapper.xml都需要在Mybatis核心配置文件中注册!-->
<mappers>
<mapper resource="com/kuang/Dao/UserMapper.xml"/>
</mappers>
</configuration>
先在idea测试连接数据库,
<!--配置Driver路径和连接MySQL的地址、账户密码--> <!--Mapper注册-->
编写Mybatis的工具类(module-src-main-java -com.kuang.utils下新建一个MybatisUtils.java):
package com.kuang.utils;
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;
//SqlSessionFactory --> SqlSession
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
//获取SqlSessionFactory对象
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
/*有了SqlSessionFactory就可以获取SqlSession的实例了,后者完全包含了面向
数据库执行SQL命令所需的所以方法 */
public static SqlSession getSqlSession() {
return sqlSessionFactory.openSession();
}
}
2.2 编写代码
步骤:创建实体类、创建接口、创建接口实现类。
- 创建一个实体类:
package com.kuang.pojo;
//实体类
public class User {
private int id;
private String name;
private String pwd;
public User() {
}
public User(int id, String name, String pwd) {
this.id = id;
this.name = name;
this.pwd = pwd;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPwd() {
return pwd;
}
public void setPwd(String pwd) {
this.pwd = pwd;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", pwd='" + pwd + '\'' +
'}';
}
}
- Dao接口:
package com.kuang.dao;
import com.kuang.pojo.User;
import java.util.List;
public interface UserDao {
List<User> getUserList();
}
- 接口实现类(同样在Dao目录下 建立—— com/kuang/dao/UserMapper.xml 文件,由原来的userDaoImpl转变了为Mapper配置文件):
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.kuang.dao.UserDao">
<select id="getUserList" resultType="com.kuang.pojo.User">
select * from mybatis.user
</select>
</mapper>
<!--nameSpace : 绑定一个对应的Dao/Mapper 接口-->
<!-- id对应方法名字-->
命名空间就是接口
id是接口的方法
resultType就是实体类的相对路径
查询语句带上 数据库和表 即mybatis.user;
这个Mapper可以理解为,定义了UserDao的实现类——getUserList,上面是名字,下面是查询语句,定义了它能干什么!
2.3 测试
Junit测试
package com.kuang.dao;
import com.kuang.pojo.User;
import com.kuang.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;
public class UserDaoTest {
@Test
public void test(){
//获得SQL Session对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//getMapper 通过反射获得了类的实例,这个实例就是接口实现类的实例
UserDao mapper = sqlSession.getMapper(UserDao.class);
List<User> userList = mapper.getUserList();
//这里调用接口实现类的实例来查询数据库
for (User user:userList) {
System.out.println(user);
}
//关闭SqlSession
sqlSession.close();
}
}
注意点1、 绑定异常:org.apache.ibatis.binding.BindingException: Type interface com.kuang.dao.UserDao is not known to the MapperRegistry(Registry注册).
解决:
- 注意不要写错,比如UserMapper.xml的
<mapper namespace="com.kuang.dao.UserDao">
和Mybatis-config.xml的<mapper resource="com/kuang/dao/UserMapper.xml"/>
- Mybatis核心配置文件必须要有下述注册:
<mappers>
<mapper resource="com/kuang/Dao/UserMapper.xml"/>
</mappers>
-----------
注意点2、初始化异常:java.lang.ExceptionInInitializerError
解决:
- 注意配置文件里不要有中文注释(比如UserMapper.xml和Mybatis-config.xml,估计只要是xml就不行),会报UTF-8 序列xxx无效引起初始化异常。彻底解决可以把idea全局编码和默认配置文件编码设置为utf-8。
- 配置路径以便程序运行时在任何地方都能查找到需要的配置文件,把下列代码添加到Maven项目(主工程)的pom.xml里面;
<!--在build中配置resources,来防止我们资源导出失败的问题-->
<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>
-------------
注意点3、数据库报错:Cause com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:Communications link failure
解决:在Mybatis-config.xml的数据库连接url后 加上
&useSSL=false
这是因为项目依赖的MySQL的版本是5.7及以上的,此类版本SSL默认为True以防止数据库被任意篡改,这里需要手动关闭。