第一个Mybatis程序
思路:搭建环境-->导入Mybatis-->编写代码-->测试!
以下的学习根据Mybatis的官网
2.1、搭建环境
搭建数据库:
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,'李四','123890')
新建项目
- 新建一个普通的maven项目:Mybatis-Study(作为父工程)
- 删除src目录:
- 导入依赖:
<!--导入依赖-->
<dependencies>
<!--mysql驱动-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.19</version>
</dependency>
<!--mybatis-->
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<!--junit-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
</dependencies>
2.2、创建一个模块
- 编写Mybatis的核心配置文件(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核心配置文件-->
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8&serverTimezone=UTC"/>
<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>
注意:
-
在xml中的&符号需要用(&加上amp;)转义才行,这里的mappers标签如果不写是个坑需注意
-
这个核心配置文件里的配置需要自己按自己实际的环境来配置
-
其中数据库连接url的后面的参数解释:useSSL:安全,
useUnicode和characterEncoding作用:指定字符的编码、解码格式例如:mysql数据库用的是gbk编码,而项目数据用的是utf-8编码。
这时候如果添加了useUnicode=true&characterEncoding=UTF-8 ,
那么作用有如下两个方面:-
存数据时:数据库在存放项目数据的时候会先用UTF-8格式将数据解码成字节码,然后再将解码后的字节码重新使用GBK编码存放到数据库中。
-
取数据时:在从数据库中取数据的时候,数据库会先将数据库中的数据按GBK格式解码成字节码,然后再将解码后的字节码重新按UTF-8格式编码数据,最后再将数据返回给客户端。
serverTimezone:设置时区
-
- 编写Mybatis工具类
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,顾名思义,我们可以从中获得 SqlSession 的实例。
// SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession();
}
}
2.3、编写代码
-
实体类
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接口
public interface UserDao { List<User> getUserList(); }
-
接口实现类
这里需要注意,以前我们这里用JDBC的做法是直接实现上面的Dao接口
如下:public class UserDaoImpl implements UserDao { //这是以前JDBC的做法 @Override public List<User> getUserList() { /** * 连接数据库,得到connection对象以及prearedStatement对象 * ............. */ String sql = "select * from mybatis.user"; //执行SQL //结果集 ResultSet return null; } }
现在我们是直接写一个UserMapper.xml文件与UserDao接口进行绑定(相当于实现了Dao接口的意思)
如下:
<?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等于绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.kuang.dao.UserDao">
<!--select查询语句-->
<select id="getUserList" resultType="com.kuang.pojo.User">
select * from mybatis.user;
</select>
</mapper>
注意:1. 这里的namespace等于绑定一个对应的Dao/Mapper接口
2. id对应Dao接口的方法名,resultType对应Dao接口方法的返回类型(注意是全限定类名)
3.这里有个套路是在xml的标签中在里面打空格符号会有相关标签属性名的提示
2.4 、测试
-
junit测试:
public class UserDaoTest { @Test public void test(){ //第一步:获得sqlSession对象 SqlSession sqlSession = MybatisUtils.getSqlSession(); try{ //方式一:getMapper执行SQL UserDao userDao = sqlSession.getMapper(UserDao.class); List<User> userList = userDao.getUserList(); //方式二:这种方法不推荐使用 //List<User> userList = sqlSession.selectList("com.kuang.dao.UserDao.getUserList"); for (User user : userList) { System.out.println(user); } }catch (Exception e){ e.printStackTrace(); }finally { //关闭sqlSession sqlSession.close(); } /** * org.apache.ibatis.binding.BindingException: * Type interface com.kuang.dao.UserDao * is not known to the MapperRegistry. * 这个错需要在mybatis核心配置文件中注册mapper文件 */ /** * The error may exist in com/kuang/dao/UserMapper.xml * * 找不到这个xml,这是maven导出资源问题,加上配置就行 */ } }
注意点:
org.apache.ibatis.binding.BindingException:Type interface com.kuang.dao.UserDao
is not known to the MapperRegistry.
报这个错是因为没有在核心配置文件mybatis-config.xml中注册mappers
The error may exist in com/kuang/dao/UserMapper.xml
报这个错是因为UserMapper.xml文件不是放在resource目录下面,在编译时没有将其打包在target目录下面
注意:当时我的target目录没有显示,需要勾上这个设置就能显示
回到上面,既然target目录对应的包下面没有UserMapper.xml文件,
这时我们在父工程的pom.xml需加下面的配置即可
下面配置的意思是不光resources下面的配置文件能编译打包,src/main/java目录下的也可以:
<!--在build中配置resources,来防止我们资源导出失败的问题-->
<build>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.xml</include>
<include>**/*.properties</include>
</includes>
<filtering>true</filtering>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.xml</include>
<include>**/*.properties</include>
</includes>
<filtering>true</filtering>
</resource>
</resources>
</build>
我还遇到个1字节的UTF8序列问题,也是需要在父工程的pom.xml中加上如下配置就行,你们没有可以忽略:
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
好,总结一下以后会碰到的问题(包括上面提到的):
- 配置文件没有注册
- 绑定接口错误
- 方法名不对
- 返回类型不对
- maven导出资源问题
码云地址:https://gitee.com/mo18/Mybatis-Study.git 这篇文章在mybatis-01模块!