Mybatis系列教材（一）- 入门教程

MAGIC_LAN

已于 2023-08-10 17:31:30 修改

阅读量310

点赞数

分类专栏： Java 文章标签： Mybatis

于 2020-04-15 09:30:20 首次发布

本文链接：https://blog.csdn.net/qq_31634777/article/details/105527829

版权

Java 专栏收录该内容

423 篇文章 3 订阅

订阅专栏

平时我们都用JDBC访问数据库，除了需要自己写SQL之外，还必须操作Connection, Statement, ResultSet 这些其实只是手段的辅助类。不仅如此，访问不同的表，还会写很多雷同的代码，显得繁琐和枯燥。

那么用了Mybatis之后，只需要自己提供SQL语句，其他的工作，诸如建立连接，Statement， JDBC相关异常处理等等都交给Mybatis去做了，那些重复性的工作Mybatis也给做掉了，我们只需要关注在增删改查等操作层面上，而把技术细节都封装在了我们看不见的地方。

必读： 基于框架的程序要成功运行，对于JAR包的版本，配置文件的正确性有着苛刻的要求，任何一个地方出错了，都会导致框架程序运行失败。如果你是第一次学习本框架，务必严格按照教程的指导，完全模仿操作，直到成功看到运行效果。第一次成功之后，信心，思路都会有较好的铺垫，然后再根据自己的疑惑，在“成功”的代码上做原本想做的改动和调整，这样可以大大节约学习的时间，提高效率，切勿一来就擅自改动，给自己的学习制造障碍

步骤1:学习之前先看效果
步骤2:创建数据库
步骤3:创建表
步骤4:导入数据
步骤5:先运行，看到效果，再学习
步骤6:模仿和排错
步骤7:创建项目
步骤8:导入jar包
步骤9:创建实体类
步骤10:配置文件mybatis-config.xml
步骤11:配置文件Category.xml
步骤12:测试类TestMybatis
步骤13:基本原理图
步骤14:可运行的项目
步骤15:练习

步骤 1 : 学习之前先看效果

这两条数据就是通过mybatis从数据库中查询出来的

步骤 2 : 创建数据库

首先创建数据库 how2java
如果没有安装数据库，请参考安装mysql-server

create database how2java

步骤 3 : 创建表

接着创建表category_

USE how2java;

CREATE TABLE category_ (

id int(11) NOT NULL AUTO_INCREMENT,

name varchar(32) DEFAULT NULL,

PRIMARY KEY (id)

) ENGINE=MyISAM AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;

步骤 4 : 导入数据

USE how2java;

INSERT INTO category_ VALUES (null,'category1');

INSERT INTO category_ VALUES (null,'category2');

步骤 5 : 先运行，看到效果，再学习

先下载下载区(点击进入)的可运行项目，配置运行起来，确认可用之后，再学习做了哪些步骤以达到这样的效果。

步骤 6 : 模仿和排错

在确保可运行项目能够正确无误地运行之后，再严格照着教程的步骤，对代码模仿一遍。
模仿过程难免代码有出入，导致无法得到期望的运行结果，此时此刻通过比较正确答案 ( 可运行项目 ) 和自己的代码，来定位问题所在。
采用这种方式，学习有效果，排错有效率，可以较为明显地提升学习速度，跨过学习路上的各个槛。

推荐使用diffmerge软件，进行文件夹比较。把你自己做的项目文件夹，和我的可运行项目文件夹进行比较。
这个软件很牛逼的，可以知道文件夹里哪两个文件不对，并且很明显地标记出来
这里提供了绿色安装和使用教程：diffmerge 下载和使用教程

步骤 7 : 创建项目

通过ecipse创建java project: mybatis
项目目录必须是 e:\project\mybatis
因为后续的学习都是基于这个位置，以及在右上方下载的可运行项目中的jar包依赖位置也是这里，所以请务必使用这个项目目录，有助于在使用本教程的过程中提高相当的学习效率。
用其他项目位置反而会带来不必要的困扰

步骤 8 : 导入jar包

本项目用到了两个jar包，在下载区(点击进入)的lib.rar中下载。
下载解压后，在项目目录e:/project/mybatis下新建目录lib,并复制过来
然后通过ecipse在mybatis的项目上导入这两个jar包

步骤 9 : 创建实体类

准备实体类Category，用于映射表category_

package com.how2java.pojo;

public class Category {

private int id;

private String name;

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;

}

步骤 10 : 配置文件mybatis-config.xml

在src目录下创建mybatis的主配置文件mybatis-config.xml (相当于hibernate.cfg.xml，如果没有hibernate基础请忽略本句)。
其作用主要是提供连接数据库用的驱动，数据库名称，编码方式，账号密码

<property name="driver" value="com.mysql.jdbc.Driver"/>

<property name="url" value="jdbc:mysql://localhost:3306/how2java?characterEncoding=UTF-8"/>

<property name="username" value="root"/>

<property name="password" value="admin"/>

以及别名，自动扫描com.how2java.pojo下的类型，使得在后续配置文件Category.xml中使用resultType的时候，可以直接使用Category,而不必写全com.how2java.pojo.Category

<typeAliases>

<package name="com.how2java.pojo"/>

</typeAliases>

映射Category.xml

<mappers>

<mapper resource="com/how2java/pojo/Category.xml"/>

</mappers>

<?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>

<typeAliases>

<package name="com.how2java.pojo"/>

</typeAliases>

<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/how2java?characterEncoding=UTF-8"/>

<property name="username" value="root"/>

<property name="password" value="admin"/>

</dataSource>

</environment>

</environments>

<mappers>

<mapper resource="com/how2java/pojo/Category.xml"/>

</mappers>

</configuration>

步骤 11 : 配置文件Category.xml

在包com.how2java.pojo下，新建文件Category.xml

namespace="com.how2java.pojo"

表示命名空间是com.how2java.pojo，在后续调用sql语句的时候，会用到它
里面定义了一条sql语句

select * from category_

这条sql语句用id: listCategory 进行标示以供后续代码调用。resultType="Category" 表示返回的数据和Category关联起来，这里本应该使用的是 com.how2java.pojo.Category, 但是因为上一步配置了别名，所以直接使用Category就行了

<?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.how2java.pojo">

<select id="listCategory" resultType="Category">

select * from category_

</select>

</mapper>

步骤 12 : 测试类TestMybatis

运行并观察到如图所示的结果。
根据配置文件mybatis-config.xml得到sqlSessionFactory 。

String resource = "mybatis-config.xml";

InputStream inputStream = Resources.getResourceAsStream(resource);

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

然后再根据sqlSessionFactory 得到session

SqlSession session=sqlSessionFactory.openSession();

最后通过session的selectList方法，调用sql语句listCategory。listCategory这个就是在配置文件Category.xml中那条sql语句设置的id。
执行完毕之后，得到一个Category集合，遍历即可看到数据。

List<Category> cs = session.selectList("listCategory");

for (Category c : cs) {

System.out.println(c.getName());

}

注： session.selectList("listCategory"); 也可以写成 session.selectList("com.how2java.pojo.listCategory"); 效果一样。但是我嫌弃其臃肿，不愿采用这种方式

package com.how2java;

import java.io.IOException;

import java.io.InputStream;

import java.util.List;

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 com.how2java.pojo.Category;

public class TestMybatis {

public static void main(String[] args) throws IOException {

String resource = "mybatis-config.xml";

InputStream inputStream = Resources.getResourceAsStream(resource);

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

SqlSession session=sqlSessionFactory.openSession();

List<Category> cs=session.selectList("listCategory");

for (Category c : cs) {

System.out.println(c.getName());

}

步骤 13 : 基本原理图

1. 应用程序找Mybatis要数据
2. mybatis从数据库中找来数据
2.1 通过mybatis-config.xml 定位哪个数据库
2.2 通过Category.xml执行对应的select语句
2.3 基于Category.xml把返回的数据库记录封装在Category对象中
2.4 把多个Category对象装在一个Category集合中
3. 返回一个Category集合