MyBatis入门
1.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。
###创建一个maven项目
叫MybatisStudy,删除src目录,作为一个主项目,再里面创建一个子项目mudle
下载MyBatis
1、maven仓库
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>x.x.x</version>
</dependency>
2、Github:https://github.com/mybatis/mybatis-3
3、中文文档:https://mybatis.org/mybatis-3/zh/getting-started.html
2、环境搭建
2.0 创建数据库
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,'zhangsan','123456'),
(2,'lsii','123456'),
(3,'wangwu','123456')
2.1、新建项目
1、 新建一个普通的maven项目
叫MybatisStudy,删除src目录,作为一个主项目,再里面创建一个子项目mudle,名叫mybatis-01;
2、导入maven依赖
打开文件夹下的pom.xml文件夹,在里面添加以下代码。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.yu</groupId>
<artifactId>Mybatis-Study</artifactId>
<packaging>pom</packaging>
<version>1.0-SNAPSHOT</version>
<modules>
<module>mybatis-01</module>
</modules>
<!--导入依赖-->
<dependencies>
<!--MySQL驱动-->
<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
<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.5</version>
</dependency>
<!--junit驱动-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13</version>
</dependency>
</dependencies>
</project>
在添加代码导入jar包的时候可能会遇到出现mysql或者mybatis显示红色。可能是以下原因:1.由于maven是国外的,而国内与国外之间有一道墙,所以导致jar包下载不成功;解决办法,需要在conf/settings.xml中更改代码,网上有很多,我写的也有maven的配置就不介绍了。2、由于导入的jar包的版本过于新,而在阿里云镜像中还没有,所以需要再阿里云maven镜像仓库中查找所需要的框架的导入代码,进行配置;maven阿里云镜像仓库网址https://maven.aliyun.com/mvn/search。
2.2、创建一个模块
- 在mybatis-01项目中编写mybatis的核心配置文件,在resources文件中,创建一个mybatis-config.xml文件,并且与上面进行同样的操作,配置pom.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://localhost:3306/mybatis?useSSL=true&useUnicode=true&"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<!-- 找到创建的sql语句的xml文件 -->
<mappers>
<mapper resource="com/yu/dao/UserMapper.xml"/>
</mappers>
</configuration>
- 编写User接口
public interface UserDao {
public List<User> getUserList();
}
- 编写mybatis工具类()
package com.yu.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;
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static{
try {
//使用mybatis第一步,获取sqlSessionFactory对象
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
//既然有了SqlSessionFactory,顾名思义,我们就可以从中获得SqlSessiond 的示例了。
//SqlSession完全包含了面向数据库执行sql命令的所有方法
public static SqlSession getSqlSession () {
return sqlSessionFactory.openSession();
}
}
2.3、编写代码
- 实体类
package com.yu.pojo;
public class User {
private int id;
private String name;
private String pwd;
//alt+insert快捷键可以快速生成代码
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.yu.dao;
import com.yu.pojo.User;
import java.util.List;
public interface UserDao {
List<User> getUserList();
}
- 接口实现类由原来的UserDaoImpl转变为一个Mapper.xml的配置文件(UserMapper.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="com.yu.dao.UserDao">
<select id="getUserList" resultType="com.yu.pojo.User">
select * from mybatis.user;
</select>
</mapper>
- 原本的接口实现类为(现在被上面的UserMapper.xml文件代替,本类不需要写):
public class UserDaoImpl implements UserDao {
public List<User> getUserList() {
//此类可以不写,就没有实现
return null;
}
}
3、遇到的报错
3.1、没有导入UserMapper.xml文件
- 报错
org.apache.ibatis.binding.BindingException: Type interface com.yu.dao.UserDao is not known to the MapperRegistry.
Process finished with exit code -1
- 解决办法
<mappers>
<mapper resource="com/yu/dao/UserMapper.xml"/>
</mappers>
3.2、测试类中没有找到UserMapper.xml文件
由于Maver中,约定大于配置,所以无法自动把src文件下的xml文件和properties文件传入到测试文件夹中。
- 解决办法
在所有的pom.xml中加入以下代码块:
<build>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
</resources>
</build>
3.3、此时还有可能报错
如果还是报错,那么第二步,在你的Mybatis配置文件中mybatis-config-xml,将注释去掉即可。