Mybatis入门-01-第一个程序
MyBatis
一、入门
1.前言
https://mybatis.org/mybatis-3/zh/index.html
mybatis3有比较丰富的中文官方文档,一切应该以文档为主。
参考视频:狂神说Java-Mybatis
作为一款优秀的持久层框架,MyBatis几乎免除了所有的JDBC代码,十分方便。
但是由于文档某些时候阅读起来确实有一定的门槛,因此对其做一定的笔记也是必要的。
前置内容:
- Java
- maven
- MySQL
- JDBC
- JavaWeb中持久化层的一些知识,如POJO
环境:
- Java11
- IDEA 2019.3.3
- MySQL8
- mybatis3
2.入门
2.1 路径
本文使用Maven创建Mybais项目,项目路径如下。
在IDEA创建Maven项目后,将其src删去,同时在该项目下创建Module即可,这时IDLE会自动在两个pom.xml中写入两者的关系,即在父pom.xml中写入:
<modules> <module>mybatis-01</module> </modules>
在子pom.xml中写入:
<parent> <artifactId>MyBaitsLearn</artifactId> <groupId>com.duzhuan</groupId> <version>1.0-SNAPSHOT</version> </parent>
这是一种使用习惯,父pom.xml的配置子pom.xml可以继承。
如果不明文标出,一般认为下面对于pom.xml的操作都是对父pom.xml的操作。
2.2 依赖
<!--jdbc-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.19</version>
</dependency>
<!--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.12</version>
<scope>test</scope>
</dependency>
确认这个子项目里有依赖。
2.3 创建数据库
create database if not exists `mybatis`;
use `mybatis`;
create table if not exists `User`(
`id` INT(20) not null primary key,
`name` VARCHAR(20) default null,
`pwd` varchar(20) default null
)ENGINE=INNODB default CHARSET = UTF8;
insert into `User`(`id`,`name`,`pwd`)
values (1,'admin','123456'),
(2,'Jax','123456'),
(3,'Jinx','123455'),
(4,'Query','123456'),
(5,'biubiu','123456');
2.4 POJO
路径
代码
package com.duzhuan.pojo;
/**
* @Autord: HuangDekai
* @Date: 2020/9/9 14:11
* @Version: 1.0
* @since: jdk11
*/
public class User {
private int id;
private String name;
private String password;
public User() {
}
public User(int id, String name, String password) {
this.id = id;
this.name = name;
this.password = password;
}
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 getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", password='" + password + '\'' +
'}';
}
}
2.5 简配配置文件
路径
简单解析
<?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="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
</configuration>
xml文件头不提。
所有的配置都应该在<configuration>
标签内。这是一个可以暂且用来展示功能的配置文件,很显然的是现在没有任何功能。而且与官网复制下来的相比,缺少了mappers
及其子标签。
先一行一行看,<environments>
标签,显然,可以配置多套环境,default
表示的是默认是使用哪套环境。通过观看<enviroments>
可以看到有id
属性,显然,<envireonments default="environment的id"
。
transactionManager
,事务管理器,具体可查看官网文档-配置-事务管理器,这里只需要让transactionManager
的值为JDBC
。
dataSource
,数据源。大多数 MyBatis 应用程序会按示例中的例子来配置数据源。虽然数据源配置是可选的,但如果要启用延迟加载特性,就必须配置数据源。有三种内建的数据源类型(也就是 type="[UNPOOLED|POOLED|JNDI]
")。之后深入了解可以通过查询文档,这里使用POOLED
,即使用连接池,其默认设置链接数量是10,暂不深入了解。
关于properties
:
driver
– 这是 JDBC 驱动的 Java 类全限定名(并不是 JDBC 驱动中可能包含的数据源类)。url
– 这是数据库的 JDBC URL 地址。username
– 登录数据库的用户名。password
– 登录数据库的密码。
因此,若是要简单地使用配置文件,可以先如下设置:
<?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&characterEncoding=utf8&serverTimezone=UTC"/>
<property name="username" value="root"/>
<property name="password" value="qq123456"/>
</dataSource>
</environment>
</environments>
</configuration>
其中&
是在xml中&的转义字符。
2.6 UserMapper
路径
相当于JavaWeb里的UserDao接口,在MyBatis中称其为Mapper。
UserMapper代码为:
package com.duzhuan.dao;
import com.duzhuan.pojo.User;
import java.util.List;
/**
* @Autord: HuangDekai
* @Date: 2020/9/9 19:42
* @Version: 1.0
* @since: jdk11
*/
public interface UserMapper {
List<User> getUserList();
}
2.7 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.duzhuan.dao.UserMapper">
<select id="getUserList" resultType="com.duzhuan.pojo.User">
select * from mybatis.user
</select>
</mapper>
L1-L4为xml文件头
mapper
是根标签,只允许有一个。namespace
,命名空间。其值等于要绑定的接口的全限定名,显然一个Mapper.xml只会绑定一个接口。
select
显然是一个用于执行SQL查询语句的标签,其中id
等于的是namespace
中 绑定的接口中的方法的名字。
`
resultType为结果的类型的全限定名。select * from mybatis.user
是执行的SQL。
值得一提的是,类似于返回值为List<User>
这种列表的,resultType也是填写具体的实体类。
在数据库中执行select * from mybatis.user
时返回的是:
到此仍未使用MyBatis去获取数据库里的数据,并且上面某些配置存在一些比较显然的问题,但先按下不表,继续。
2.8 MybatisUtils
这个类用于封装一些固定步骤。
路径
代码
package com.duzhuan.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;
/**
* @Autord: HuangDekai
* @Date: 2020/9/9 21:38
* @Version: 1.0
* @since: jdk11
*/
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession();
}
}
可以参照官方文档中从SqlSessionFactory中获取SqlSession:
从 XML 中构建 SqlSessionFactory
每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先配置的 Configuration 实例来构建出 SqlSessionFactory 实例。
从 XML 文件中构建 SqlSessionFactory 的实例非常简单,建议使用类路径下的资源文件进行配置。 但也可以使用任意的输入流(InputStream)实例,比如用文件路径字符串或 file:// URL 构造的输入流。MyBatis 包含一个名叫 Resources 的工具类,它包含一些实用方法,使得从类路径或其它位置加载资源文件更加容易。
String resource = "org/mybatis/example/mybatis-config.xml"; InputStream inputStream = Resources.getResourceAsStream(resource); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
2.9 创建测试样例
路径
UserMapperTest代码
package com.duzhuan.dao;
import com.duzhuan.pojo.User;
import com.duzhuan.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;
/**
* @Autord: HuangDekai
* @Date: 2020/9/9 21:56
* @Version: 1.0
* @since: jdk11
*/
public class UserMapperTest {
@Test
public void getUserListTest(){
SqlSession sqlSession= MybatisUtils.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
List<User> userList = userMapper.getUserList();
for (User user : userList) {
System.out.println(user);
}
sqlSession.close();
}
}
2.10 可能遇到的错误
2.10.1 Error:java: 错误: 不支持发行版本 5
最好将上述位置的Java版本设为一致。
2.10.2 经典错误 porg.apache.ibatis.binding.BindingException: Type interface com.duzhuan.dao.UserMapper is not known to the MapperRegistry.
类似于Servlet需要在web.xml中注册一样,Mapper也需要在mybatis-config.xml中注册。
在mybatis-config.xml的根标签里添加:
<mappers>
<mapper class="com.duzhuan.dao.UserMapper"></mapper>
</mappers>
建立关系的方式多种多样,这里仅用class="Mapper全限定名"
用来举例。同时,比如这种用法要求:
- Mapper与Mapper.xml同名
- Mapper与Mapper.xml同目录
2.10.3 经典错误 org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.duzhuan.dao.UserMapper.getUserList
一般情况下,是因为Maven生成的target文件夹中没有Mapper对应的Mapper.xml。
只要把UserMapper.xml文件复制粘贴过去一般就能解决。
但是这是Maven造成的问题,maven默认只复制java代码文件,对xml、properties等不复制。而且,每次都要复制粘贴过去也很麻烦,因此解决问题的正道应该是修改maven的配置。
在父pom.xml主标签里加入:
<build>
<resources>
<resource>
<directory>src/main/resource/</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>
2.11 输出结果及修正
在我们的数据库中,密码这一字段的字段名为pwd
:
在POJO中,很显然地,其属性名为password
:
从SQL上说,在此处select * from mybatis.user
可以类似看为:
select `id`,`name`,`password` from mybatis.user
当然,在SQL这样是不能执行的,只是Mybatis将其处理成全都是null的字段,具体操作有待研究。
这时修改pojo的属性及其 getter and setter方法名为pwd
无疑是简单的。但是MyBatis也有许多解决办法。
修改 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.duzhuan.dao.UserMapper">
<resultMap id="UserMap" type="com.duzhuan.pojo.User">
<result column="pwd" property="password"/>
</resultMap>
<select id="getUserList" resultMap="UserMap">
select * from mybatis.user
</select>
</mapper>
增加了resultMap
标签及其子标签。其中id
是resultMap的id,在11行中resultMap的值就是需要的resultMap的id。
type
中是要映射的实体类的全限定名或别名。
column
的值是数据库的字段名,property
的值要映射的实体类中的属性的名称。
这样,就相当于有如下SQL:
select `id`,`name`,`pwd`as`password` from mybatis.user
当然,MyBatis做的要多得多,比如省略了人工编写JDBC代码,将从数据库拿到的数据放入POJO中的操作。
结果: