MyBatis快速入门（02）入门例子

小咪咪 2022-12-08 05:48 155阅读 0赞

# MyBatis中文官方文档地址 #

> [http://www.mybatis.org/mybatis-3/zh/index.html][http_www.mybatis.org_mybatis-3_zh_index.html]

我们打开文档，可以看到mybatis的介绍，而介绍下面就是一个紧跟着的入门说明，下面我来写一下mybatis的入门例子，完成上一篇文章中的jdbc完成的功能，并且通过这个例子来初步了解mybatis。

# 第1步：添加依赖 #

使用mybatis需要添加mybatis的jar包依赖，这里我们使用比较稳定的3.4.6版本，添加后maven的pom文件如下：

![98d1f07f05aa7bc7202554bfc5065779.png][]

# 第2步：构建SqlSessionFactory #

什么是SqlSessionFactory？每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先定制的 Configuration 的实例构建出 SqlSessionFactory 的实例。下面我通过经典的xml配置构建一个SqlSessionFactory。首先在resource下面新建一个mybatis-config.xml文件，内容如下：

![816b42f52194ed2e9a372bf5968bf304.png][]

XML 配置文件中包含了对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源（DataSource）和决定事务作用域和控制方式的事务管理器（TransactionManager）。 XML 配置文件的详细内容后面再探讨。

从 XML 文件中构建 SqlSessionFactory 的实例非常简单，建议使用类路径下的资源文件进行配置（也就是maven的resource目录）。 但是也可以使用任意的输入流（InputStream）实例，包括字符串形式的文件路径或者 file:// 的 URL 形式的文件路径来配置。MyBatis 包含一个名叫 Resources 的工具类，它包含一些实用方法，可使从 classpath 或其他位置加载资源文件更加容易，下面看一下构建代码：

![3c92c4cd4a0eb8ff3cfdef3bf3728e26.png][]

通过以上的配置和代码，我们就有了SqlSessionFactory的实例。

# 第3步：从 SqlSessionFactory 中获取 SqlSession #

既然有了 SqlSessionFactory，顾名思义，我们就可以从中获得 SqlSession 的实例了。SqlSession 完全包含了面向数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。既然SqlSession可以直接执行sql语句，那么我们来把获取SqlSession写成一个公共方法：

![2567ea2eb09d4ba418f6b7ca5d327f72.png][]

接下来的步骤就简单了：

![51919d767ddde384b04b34224ba5e1b5.png][]

因为SqlSession继承了Closeable，因此我们可以使用TWR的形式：

![7ac328c1b2cbdd33c50db863bb61409f.png][]

# 第4步：定义sql语句 #

mybatis定义sql语句经典的方式是使用xml文件定义，我们在resource下面的mapper文件夹下面定义一个UserMapper.xml文件，内容如下：

![4b9654cb9863a625b4ddc05fbfa5e5ee.png][]

mapper标签上面的文件头的写法都一样，不用细说。所有的sql语句都要定义在mapper标签之间。namespace表示执行sql语句的接口类，类的定义如下：

![733f96bd63ac6e29425902d4f9f7e742.png][]

我们要定义一个新增sql和一个查询sql，首先定义一个实体类：

![cb4a687f2c0afe49c14576717c52e7ec.png][]

然后在类中定义两个接口：

![5e6cda0dd49dbbf6d36f56503e4ea24d.png][]

然后在UserMapper.xml中定义两个接口对应的sql语句：

![cd3595e23e571e3a91846082d93b1096.png][]

查询定义在select标签中，新增定义在insert标签中。id表示同一个sql文件中sql语句的唯一标记，这个标记要和接口中对应的方法的名字一样。parameterType表示入参类型，resultType表示回参类型，新增删除和修改操作默认返回的都是结果的数量，因此不用写返回类型，默认都是整型。SQL语句中的参数都写在\#\{\}里面。

下面把sql语句定义的文件加到SqlSessionFactory的构建文件当中：

![645729b0ea4e81f55126c0521d2dd971.png][]

这样sql语句就定义好了。

# 第5步：调用定义好的sql #

先来看新增的调用（这里注意，这种写法需要手动commit）：

![53d7f3e5906d85bce274ddd71af1ea27.png][]

再来看查询的调用：

![427f01fe3047838bfeb455a8a44d9418.png][]

# 第6步：执行，查看结果 #

测试代码：

![14315db33612d93ba473b52dd210eb1b.png][]

结果：

![83b46839fcbed9ce5e1fda771f978722.png][]

上面的例子，我们使用mybatis完成了前面jdbc的功能，有人可能会觉得代码量反而多了，并不比jdbc简单，其实不然。可以想象这种写法在添加新功能的时候的方便性，只需要添加一个sql和一个接口，就可以直接调用完成数据库的操作，mybatis正是通过对公共内容的封装，使代码量下降。同时使开发人员把精力集中在业务业务的逻辑和sql上，避免写一些连接数据库的代码。

代码地址：[https://gitee.com/blueses/mybatis-demo][https_gitee.com_blueses_mybatis-demo] 02

[http_www.mybatis.org_mybatis-3_zh_index.html]: http://www.mybatis.org/mybatis-3/zh/index.html
[98d1f07f05aa7bc7202554bfc5065779.png]: /images/20221123/31d5d86e6fdf4692a7cf15e96357faaa.png
[816b42f52194ed2e9a372bf5968bf304.png]: /images/20221123/d0855766c6a74da685b9b88514f3a936.png
[3c92c4cd4a0eb8ff3cfdef3bf3728e26.png]: /images/20221123/feaa3a3d1b9f4af6b203c59a093de976.png
[2567ea2eb09d4ba418f6b7ca5d327f72.png]: /images/20221123/6c04b5f4cc00428aa44e8acaf8b54113.png
[51919d767ddde384b04b34224ba5e1b5.png]: /images/20221123/cf1c33eff37e494591357d3e7d745e4b.png
[7ac328c1b2cbdd33c50db863bb61409f.png]: /images/20221123/b16d54639ae94c579b2917bf1fc0a4e0.png
[4b9654cb9863a625b4ddc05fbfa5e5ee.png]: /images/20221123/87491bd42f2a410aafaa1926ced86f94.png
[733f96bd63ac6e29425902d4f9f7e742.png]: /images/20221123/f576df42540844bc87b1b0d06451b146.png
[cb4a687f2c0afe49c14576717c52e7ec.png]: /images/20221123/ea1c3ad66d694ead985db3e7c9c5fc3e.png
[5e6cda0dd49dbbf6d36f56503e4ea24d.png]: /images/20221123/7c526091a9dd4aa4a783d65da935ead3.png
[cd3595e23e571e3a91846082d93b1096.png]: /images/20221123/5079b4cf6ad54f9b834e1d1360ce0010.png
[645729b0ea4e81f55126c0521d2dd971.png]: /images/20221123/5af657d8c012449cbd0c4c7589950c02.png
[53d7f3e5906d85bce274ddd71af1ea27.png]: /images/20221123/a3bef6e5cd0749368239b09d1f3fed93.png
[427f01fe3047838bfeb455a8a44d9418.png]: /images/20221123/3633a4ca59514278aab2e8fd1cb76980.png
[14315db33612d93ba473b52dd210eb1b.png]: /images/20221123/12c7391516564d84b4656c8db812fd20.png
[83b46839fcbed9ce5e1fda771f978722.png]: /images/20221123/47914bc169b34182b5ed00c309518a2e.png
[https_gitee.com_blueses_mybatis-demo]: https://gitee.com/blueses/mybatis-demo