1 引导

框架的概念在以前的博文中也有提到，此处简单说明下，框架实质是软件开发中的一套解决方案，不同的框架解决的是不同的问题。

1）使用框架的好处：框架封装了很多细节，开发者可以很简单的实现某些功能，提高开发效率；

2）框架解决了什么问题？

看下三层架构和SSM框架的对应关系，MyBatis框架是解决的持久层的问题，与数据库交互，进行增删改查操作的。

3）持久层技术解决方案有哪些？

JDBC技术：Connection、PreparedStatement、ResultSet；
Spring的JdbcTemplate：Spring对Jdbc的简单封装；
Apache的DBUtils，和Spring的JdbcTemplate类似，也是对Jdbc的简单封装；

以上都不是框架，JDBC是规范，后两者都只是工具类，是对规范的实现，没有系统的解决方案。

以前使用传统jdbc的步骤很多，操作繁杂，我们要实现一个需求的功能，从数据库表中查找一个结果，希望没有这么多繁杂的操作步骤，把焦点放在功能的实现上即可，实现高效率开发，MyBatis框架就是帮我们解决这些问题的。

2 MyBatis框架入门

MyBatis是一个基于Java的持久层框架，封装了jdbc操作的细节，开发者只需要关注sql语句本身，不需要关注注册驱动、创建连接、创建statement等过程，它使用了ORM思想实现了结果集封装。

注：ORM，Object Relational Mapping对象关系映射，就是把数据库表和实体类的属性对应起来，让我们可以操作实体类就可以操作数据库表。我们需要保证实体类属性和数据库表的字段名称保持一致，有一个好习惯；

2.1 MyBatis环境搭建

下面以一个案例形式一步步看下如何搭建MyBatis环境。

1）准备数据库，在本地数据库db4中新建一个user表，插入数据：

CREATE DATABASE db4;
USE db4;
CREATE TABLE USER (
id INT(11) NOT NULL PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(32) NOT NULL COMMENT '用户名称',
birthday DATETIME DEFAULT NULL COMMENT '生日',
sex VARCHAR(1) DEFAULT NULL COMMENT '性别',
address VARCHAR(256) DEFAULT NULL COMMENT '地址'
) ENGINE=INNODB DEFAULT CHARSET=utf8;
INSERT INTO `user`(`id`,`username`,`birthday`,`sex`,`address`) VALUES (1,'老王','2018-02-27 17:47:08','男','北京'),(2,'李四','2018-03-02 15:09:37','女','上海'),(3,'王五','2018-03-04 11:34:34','女','南京');

2）新建Maven工程，不使用模板，此处不展开了，需要回顾的可以看上一篇博文；

3）配置pom.xml文件，导入相关的jar包坐标：

<?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.winter</groupId>
<artifactId>19.mybatis</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.5</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.6</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.12</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.10</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>

4）写一个User实体类，实现Serializable，数据库表对应

public class User implements Serializable {
private Integer id;
private String username;
private Date birthday;
private String sex;
private String address;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", username='" + username + '\'' +
", birthday=" + birthday +
", sex='" + sex + '\'' +
", address='" + address + '\'' +
'}';
}
}

5）写一个User的持久层接口

//User的持久层接口
public interface UserDao {
List<User> findAll();
}

至此，准备工作OK了，下面看下MyBatis的环境。

6）在resources包下新建SqlMapConfig.xml文件作为MyBatis的主配置文件，其中做两件事：

配置MySQL的环境：事务类型、连接池、四个基本信息（驱动、url、用户名、密码）；
指定映射配置文件的位置，映射配置文件指的是每个dao独立的配置文件；

<?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="mysql">
<environment id="mysql">
<transactionManager type="JDBC"></transactionManager>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/db4"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/winter/dao/UserDao.xml"></mapper>
</mappers>
</configuration>

7）新建每个dao的独立配置文件，注意三件事：

在resources包下新建com.winter.dao三级包（mybatis映射配置文件必须和dao接口的包结构相同），命名为UserDao.xml，和SqlMapConfig.xml中指定的名字要一致；
mapper标签下的namespace属性要是UserDao接口的全限定类名；
操作配置（select标签中配置sql语句）中id属性要与UserDao接口中的方法名字一致；

<?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.winter.dao.UserDao">
<select id="findAll">
select * from user
</select>
</mapper>

映射配置文件中的限制很多，这么做的好处是什么呢？我们不需要再写dao的实现类了！（上述的独立配置文件还有点小问题，你发现了吗？没有的话继续阅读下文：））

完成以上后，工程目录结构如下：

2.2 MyBatis入门案例实战

2.2.1 MyBatis读取数据库的入门案例实战

在上一节环境搭建的基础上，我们看下如何使用MyBatis，使用的步骤是怎样的，可以总结为如下几个步骤：

1）读取配置文件；
2）创建SqlSessionFactory工厂；
3）使用工厂生产SqlSession对象；
4）使用SqlSession创建Dao接口的代理对象；
5）使用代理对象执行方法；
6）释放资源。

在src.test.java.com.winter.test包下新建一个测试类MyBatisTest.java:

public class MyBatisTest {
//MyBatis入门案例
@Test
public void test() throws Exception{
//1、读取配置文件
InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml");
//2、创建SqlSessionFactory工厂
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
SqlSessionFactory factory = builder.build(in);
//3、使用工厂生产SqlSession对象
SqlSession session = factory.openSession();
//4、使用SqlSession创建Dao接口的代理对象
UserDao userDao = session.getMapper(UserDao.class);
//5、使用代理对象执行方法
List<User> users = userDao.findAll();
for (User user : users) {
System.out.println(user);
}
//6、释放资源
session.close();
in.close();
}
}

【运行测试】：发现如下异常问题出现：

### Error querying database. Cause: org.apache.ibatis.executor.ExecutorException: A query was run and no Result Maps were found for the Mapped Statement 'com.winter.dao.UserDao.findAll'. It's likely that neither a Result Type nor a Result Map was specified.

我们在UserDao.xml里面写了sql查询语句，但是MyBatis不知道查询结果要封装到哪里去，所以要在UserDao.xml中对应提供另一个指定的对象类型，修正后的UserDao.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.winter.dao.UserDao">
<select id="findAll" resultType="com.winter.domain.User">
select * from user
</select>
</mapper>

再次运行测试OK：

【小插曲——调试问题】：开始MyBatisTest中使用public static void main(String[] args)方法测试，但是运行时始终报错：

Failed to execute goal org.codehaus.mojo:exec-maven-plugin:3.0.0:exec (default-cli) on project 19.mybatis: Command execution failed.

网上查找各种解决方法，如项目的java版本配置和JDK要一致等等，最后都没解决，怀疑是Maven支持的JDK版本问题，我的是14.0.1，最后通过junit解决，@Test注解运行就可以了。

2.2.2 入门案例设计模式分析

基于上述案例，分析下设计模式。

1）读取配置文件

不建议使用绝对路径，或相对路径，不够灵活，实际项目中多使用以下两种：

使用类加载器，它只能读取类路径的配置文件；
使用ServletContext对象的getRealPath()；

2）创建SqlSessionFactory工厂

MyBatis使用了构建者模式，把对象的创建细节隐藏，使用者直接调用方法即可获取对象。像我们自己盖厂房一样，不是事事亲为，我们找个包工队，告诉需求，给钱即可：

SqlSessionFactoryBuilder类似于包工队；
in类似于我们给的钱；

3）创建SqlSession对象

使用了工厂模式，降低了类之间的依赖关系

4）创建dao接口的代理对象

使用了代理模式，不修改源码的基础上对已有方法增强；

2.2.3 MaBatis基于注解的入门案例

以上基于xml的实现方式是不是感觉有些麻烦，映射配置文件有很多要对应的关系，下面来看下比较简单的方式，使用注解，相比于xml，主要改变在于：

移除UserDao.xml，在dao接口的方法上使用@Select注解，并且指定SQL语句；
在SqlMapConfig.xml中的mapper配置时，使用class属性指定dao接口的全限定类名。

【UserDao接口】：

public interface UserDao {
@Select("select * from user")
List<User> findAll();
}

【SqlMapConfig.xml中mapper配置】：

<!--指定映射配置文件的位置，映射配置文件指的是每个dao独立的配置文件
若使用注解配置，应该使用class属性指定被注解的dao全限定类名
-->
<mappers>
<mapper class="com.winter.dao.UserDao"></mapper>
</mappers>

【注意】：实际MyBatis也是支持写dao实现类的，但是实际开发中追求的理念就是越简单越好，无论是xml还是注解形式，一般都是不写dao实现类。

posted @ 2020-09-09 00:19 zhang黑科技时间到阅读(2063) 评论(0) 编辑收藏举报

会员力量，点亮园子希望

刷新页面返回顶部

JavaWeb——MyBatis框架之入门总结及案例实战，常见坑处理：Failed to execute goal org.codehaus.mojo:exec-maven-plugin:3.0.0