MyBatis学习笔记（一）简单配置让MyBatis跑起来---itlemon

MyBatis是一款优秀的支持自定义SQL查询、存储过程和高级映射的持久层框架，消除了几乎多有的JDBC代码和参数的手动设置和结果集的检索。MyBatis可以使用XML和注解进行配置和映射，MyBatis通过将参数映射到配置的SQL形成最终执行的SQL语句，最后将执行SQL的结果映射成Java对象返回。

一、创建Maven项目

Maven是一个优秀的项目构建和管理工具，使用Maven构建项目非常方便，可以非常方便地处理Jar包依赖问题。这里提供构建MyBatis应用的的pom.xml配置内容。

<?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.lemon</groupId> <artifactId>lemon-mybatis</artifactId> <version>1.0-SNAPSHOT</version> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <mybatis.version>3.4.6</mybatis.version> <junit.version>4.12</junit.version> <mysql.connector.version>8.0.11</mysql.connector.version> <slf4j.version>1.7.25</slf4j.version> <log4j.version>1.2.17</log4j.version> <lombok.version>1.16.20</lombok.version> </properties> <dependencies> <!-- mybatis核心依赖 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>${mybatis.version}</version> </dependency> <!-- 测试依赖 --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>${junit.version}</version> <scope>test</scope> </dependency> <!-- mysql数据库连接依赖 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>${mysql.connector.version}</version> </dependency> <!-- 日志模块 --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>${slf4j.version}</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>${slf4j.version}</version> <scope>test</scope> </dependency> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>${log4j.version}</version> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>${lombok.version}</version> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.7.0</version> <configuration> <source>1.8</source> <target>1.8</target> <encoding>UTF-8</encoding> </configuration> </plugin> </plugins> </build> </project>

其中<properties>标签指定了源代码的编码方式为UTF-8，以及项目所依赖的Jar包的版本。除了引入MyBatis应用所必须的Jar以外，还引入了lombok，lombok是一款非常优秀的插件，它可以被安装到Eclipse和IntelliJ IDEA上，使用lombok的相关注解可以使得创建JavaBean的代码十分简洁，至于如何使用，可以去CSDN上找到相关博客学习一下。

二、准备数据库

这里准备一个非常简单的MySQL数据库，数据库的编码方式设置为UTF-8，现在提供相关的SQL语句来建立数据库并插入测试数据。

-- 创建名称为lemon-mybatis的数据库 CREATE DATABASE lemon-mybatis DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; -- 使用数据库 use lemon-mybatis; -- 创建数据库表并插入数据 DROP TABLE IF EXISTS `country`; CREATE TABLE `country` ( `id` int(11) NOT NULL AUTO_INCREMENT, `countryName` varchar(255) DEFAULT NULL, `countryCode` varchar(255) DEFAULT NULL, PRIMARY KEY (`id`) ); INSERT `country` (`countryName`, `countryCode`) VALUES ('中国', 'CN'), ('美国', 'US'), ('俄罗斯', 'RU'), ('英国', 'GB'), ('法国', 'FR');三、配置MyBatis

配置MyBatis的方式有多种，最常见的是使用XML形式进行配置，当然，与Spring进行整合的时候，也可以使用Spring Bean的方式进行配置，另外还可以通过Java编码方式进行配置，但是这种方式不常用，这里仅仅使用XML形式配置MyBatis。 在项目的src/main/resources文件夹下面创建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> <settings> <!-- 配置日志实现 --> <setting name="logImpl" value="LOG4J"/> </settings> <!-- 配置实体类包名 --> <typeAliases> <package name="com.lemon.example.model"/> </typeAliases> <environments default="development"> <environment id="development"> <!-- 配置默认事务管理器 --> <transactionManager type="JDBC"> <property name="" value=""/> </transactionManager> <dataSource type="UNPOOLED"> <property name="driver" value="com.mysql.cj.jdbc.Driver"/> <property name="url" value="jdbc:mysql://192.168.171.133:3306/lemon-mybatis?useSSL=false"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> <mappers> <!-- 当没有写Mapper对应的接口时候，需要在这里配置XML文件位置，且标签mapper必须有在package前面 --> <mapper resource="com/lemon/example/mapper/CountryMapper.xml"/> </mappers> </configuration>

简单介绍一下这个配置文件：

<settings>中的logImpl属性配置指定使用LOG4J输出日志 <typeAliases>配置了一个包的别名，通常情况下，辨别一个类使用的是类的全限定名称，比如com.lemon.example.model.Country，在Mybatis中会频繁使用到类的全限定名称，所以配置包的别名以后，在配置文件中需要使用到全限定名称的时候直接写简单的类名即可，如Country。 <environments>环境配置中主要配置了数据库连接，可以同时配置多个数据库连接环境，内部使用<environment>隔离不同的环境。 <mappers>标签是配置配置Mapper文件的标签，其内部可以配置多个多个类似CountryMapper.xml，使用的是<mapper>标签，也可以使用<package>标签，更加便捷，后面会介绍更多细节。 四、创建实体类和Mapper.xml文件

MyBatis是一个结果映射型框架，一般在数据库设计和实体类设计的过程中，都是一个表对应一个实体类，对数据库的增删改查一般都是将实体类作为数据载体。而这里的Mapper.xml文件，是SQL语句和结果映射的基本载体，一般的命名习惯是实体类的名称加上Mapper，比如CountryMapper.xml。在实际的开发过程中，一个实体类Country对应一个接口CountryMapper.java和CountryMapper.xml文件，其中接口CountryMapper.java放在src/main下面的包里，比如com.lemon.example.mapper，而CountryMapper.xml文件则放在src/main/resources文件夹下，建立的各层文件夹和对应的接口包名一致，如com/lemon/example/mapper，其中接口并不是必须的。 本例中实体类Country的代码为：

package com.lemon.example.model; import lombok.Data; /** * @author lemon * @date 2018/4/22 下午9:32 */ @Data public class Country { private Long id; private String countryName; private String countryCode; }

这里导入了lombok的Data注解，在运行时会自动为实体类创建getter和setter方法。本例中没有创建CountryMapper接口，所以直接创建CountryMapper.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.lemon.example.mapper.CountryMapper"> <select id="selectAll" resultType="Country"> select id, countryName, countryCode from country </select> </mapper>

对于上面的Mapper文件，进行如下解释：

标签<mapper>是XML的根元素，属性namespace定义了当前XML的命名空间，是唯一的，如果没有创建该Mapper文件的Mapper接口，那么这个命名空间可以随意设置，如果创建了接口，那么这个命名空间的值必须是对应接口的全限定类名。 标签<select>是定义查询的语句的标签，它的属性id是该标签的标识，是唯一的，如果该Mapper文件有对应的接口，那么id是对应接口的方法名称，属性resultType是描述查询结果映射到哪个实体类中，由于在mybatis-config.xml文件中配置了别名，所以这里仅仅需要写Country（不区分大小写，但是为了统一，建议和类名一致）即可，否则将需要写全限定类名com.lemon.example.model.Country。 五、配置Log4j日志文件

对于项目的开发，一看都要量身定制日志文件，以便调优，这里将在src/main/resources文件夹下建立log4j.properties文件，代码如下：

# 全局配置 log4j.rootLogger=ERROR, stdout # Mybatis日志配置 log4j.logger.com.lemon.example.mapper=TRACE # 控制台输出配置 log4j.appender.stdout=org.apache.log4j.ConsoleAppender log4j.appender.stdout.layout=org.apache.log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

日志的全局配置是Error级别的，设置的是控制台输出，这是最简单的设置，也是开发阶段比较实用的设置。Mybatis日志配置指定了包名com.lemon.example.mapper，它对应的是接口，TRACE是最低级别的日志，这可以使得SQL语句执行的信息也会被打印出来。控制台输出配置了控制台日志打印的基本格式。

六、编写测试代码

本篇文章是一个入门案例，介绍了Mybatis最基本的配置，接下来编写一个测试代码，看看代码的运行效果。测试代码一般在Maven项目中都是写在src/test/java下的包中的，建立包com.lemon.example.mapper，并在该包下创建基础测试类BaseMapperTest，代码如下：

package com.lemon.example.mapper; 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 org.junit.BeforeClass; import java.io.IOException; import java.io.Reader; /** * 测试基础类 * * @author lemon * @date 2018/5/20 下午11:37 */ public class BaseMapperTest { private static SqlSessionFactory sqlSessionFactory; @BeforeClass public static void init() { try { Reader reader = Resources.getResourceAsReader("mybatis-config.xml"); sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader); reader.close(); } catch (IOException e) { e.printStackTrace(); } } public SqlSession getSqlSession() { return sqlSessionFactory.openSession(); } }

这是一个基础类，主要负责加载mybatis-config.xml来创建SqlSession实例对象，因为后期会有很多测试，如果每个测试都要重复编写获取SqlSession实例对象的代码，就显得有些多余了，这里进行了基本的代码重构复用。对于CountryMapper的测试，代码如下：

package com.lemon.example.mapper; import com.lemon.example.model.Country; import org.apache.ibatis.session.SqlSession; import org.junit.Test; import java.util.List; /** * @author lemon * @date 2018/5/8 下午5:22 */ public class CountryMapperTest extends BaseMapperTest { @Test public void testSelectAll() { try (SqlSession sqlSession = getSqlSession()) { List<Country> countryList = sqlSession.selectList("com.lemon.example.mapper.CountryMapper.selectAll"); printCountryList(countryList); } } private void printCountryList(List<Country> countryList) { for (Country country : countryList) { System.out.printf("%-4d%4s%4sn", country.getId(), country.getCountryName(), country.getCountryCode()); } } }

对上面两段代码进行如下解释：

通过Resources工具类将mybatis-config.xml配置读入Reader。 再通过SqlSessionFactoryBuilder建造类使用Reader创建SqlSessionFactory工厂对象，在创建SqlSessionFactory工厂对象过程中，首先会解析mybatis-config.xml配置文件，解析完成之后，SqlSessionFactory工厂对象就包含了所有的属性配置和执行SQL的信息。 通过继承BaseMapperTest类，直接调用父类的getSqlSession方法可以直接获取SqlSession对象。 通过SqlSession的selectList方法查找到CountryMapper.xml中id="selectAll"方法，执行SQL语句，MyBatis底层使用JDBC执行SQL语句，并将查询到的结果集ResultSet后，根据resultType的配置将结果映射到Country类型的集合中，返回查询结果。 最后将查询到的结果按照指定的格式进行输出到控制台。记得要关闭SqlSession，常见的做法是将其写在finally块中，但是代码中使用的是JDK1.7的新特性，直接写在try后面的圆括号里面，资源在利用完毕之后会自动关闭，这样做代码更加简洁。

执行测试代码，输出的日志如下所示：

DEBUG [main] - ==> Preparing: select id, countryName, countryCode from country DEBUG [main] - ==> Parameters: TRACE [main] - <== Columns: id, countryName, countryCode TRACE [main] - <== Row: 1, 中国, CN TRACE [main] - <== Row: 2, 美国, US TRACE [main] - <== Row: 3, 俄罗斯, RU TRACE [main] - <== Row: 4, 英国, GB TRACE [main] - <== Row: 5, 法国, FR DEBUG [main] - <== Total: 5 1 中国 CN 2 美国 US 3 俄罗斯 RU 4 英国 GB 5 法国 FR

这篇博文仅仅是对Mybatis进行了一个简单的案例实战，后面会继续发布多篇Mybatis的学习笔记，欢迎阅读，我们共同进步。

---来自腾讯云社区的---itlemon