MyBatis系列之--Java 项目（非SpringBoot）集成MyBatis

对MyBatis简单介绍
核心接口SqlSessionFactory
实战
- 1. Maven创建Java项目
- 2. 添加依赖
- 3. 配置JDBC属性
- 4. 配置MyBatis需要的配置文件
- 5. 准备数据
- 6. 创建数据库表对应的POJO
- 6. 创建Mapper接口
- 7. 创建XML的Mapper文件

工作中常常写一些服务，基本上会与MySQL关联上，如何快速的从MySQL中获取数据？大家可能都会选用SpringBoot来集成MyBatis，这样做的原因一个是简单，另外一个是封装的好，基本上开箱即用。

遗憾的是，这里想介绍的跟SpringBoot 没有关系，这里用一个与SpringBoot无关的Java Maven 项目，来与MyBatis结合做数据查询。

对MyBatis简单介绍

MyBatis是一个轻量级的持久层框架，能很好的解析自定义SQL，高效的完成数据的添加、删除、查询等操作。
MyBatis几乎免除了所有的JDBC代码，以及设置参数和获取结果的工作。可以通过XML或注解的方式来配置和映射原始类型、接口和POJO为数据库中的记录。

核心接口SqlSessionFactory

MyBatis主要和数据库进行交互，少不了创建数据库连接，其中SqlSessionFactory是主要的核心。

上面这张图是对官网简介的一个总结，通过这个简单的描述可以回答下面两个问题：

如何创建SqlSessionFactory？

SqlSessionFactory（简称SSF）通过 SqlSessionFactoryBuilder (简称SSFB)创建。

SSFB创建SSF的过程中，需要一些数据库JDBC的信息，这些信息可以通过XML文件或Java的Configuration对象来获取。
如何使用SqlSessionFactory？

SSF 创建好之后，基本上就保证它应用级别的作用域，不对其进行重复的创建和销毁操作。

最简单的是通过单例模式或静态单例模式来达到应用级别的作用域。

实战

1. Maven创建Java项目

本地需要安装Maven，然后才能执行下面的代码。

 mvn archetype:generate -DgroupId=com.botao -DartifactId=pure-mybatis -DarchetypeArtifactId=maven-archetype-quickstart

2. 添加依赖

pom.xml 文件中添加下面的依赖

  <dependencies><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.2</version></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.44</version></dependency></dependencies>

3. 配置JDBC属性

resources目录下创建 application.properties文件，并输入下面的配置信息。

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/university?characterEncoding=UTF-8
jdbc.username=root
jdbc.password=123456

4. 配置MyBatis需要的配置文件

resources目录下创建mybatis-config.xml文件，并输入下面的配置信息。

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><properties resource="application.properties"/><environments default="development"><environment id="development"><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver" value="${jdbc.driver}"/><property name="url" value="${jdbc.url}"/><property name="username" value="${jdbc.username}"/><property name="password" value="${jdbc.password}"/></dataSource></environment></environments><mappers><mapper resource="mapper/PersonMapper.xml"/></mappers>
</configuration>

注意：
1. 开头部分声明是xml文件
2. <properties resource="application.properties"/> 声明本文中的属性从 application.properties中获取
3. <mapper resource="mapper/PersonMapper.xml"/> 声明与数据库表的映射接口文件位置

5. 准备数据

CREATE DATABASE `university` ;CREATE TABLE `person` (`id` bigint(20) NOT NULL AUTO_INCREMENT,`name` varchar(100) DEFAULT NULL,`age` int(11) DEFAULT NULL,PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=12 DEFAULT CHARSET=utf8mb4 ;INSERT INTO `university`.`person`(`id`, `name`, `age`) VALUES (1, 'poter1', 10);
INSERT INTO `university`.`person`(`id`, `name`, `age`) VALUES (2, 'poter2', 20);
INSERT INTO `university`.`person`(`id`, `name`, `age`) VALUES (3, 'poter3', 30);
INSERT INTO `university`.`person`(`id`, `name`, `age`) VALUES (4, 'poter4', 40);
INSERT INTO `university`.`person`(`id`, `name`, `age`) VALUES (5, 'poter5', 50);
INSERT INTO `university`.`person`(`id`, `name`, `age`) VALUES (6, 'poter6', 60);
INSERT INTO `university`.`person`(`id`, `name`, `age`) VALUES (7, 'poter7', 70);
INSERT INTO `university`.`person`(`id`, `name`, `age`) VALUES (8, 'poter8', 80);
INSERT INTO `university`.`person`(`id`, `name`, `age`) VALUES (9, 'poter9', 90);
INSERT INTO `university`.`person`(`id`, `name`, `age`) VALUES (10, 'poter10', 100);
INSERT INTO `university`.`person`(`id`, `name`, `age`) VALUES (11, 'poter11', 110);

6. 创建数据库表对应的POJO

package com.botao.pojo;public class Person {private int id;private String name;private int age;public Person() {}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 int getAge() {return age;}public void setAge(int age) {this.age = age;}@Overridepublic String toString() {return "PersonMapper{" +"id=" + id +", name='" + name + '\'' +", age=" + age +'}';}
}

6. 创建Mapper接口

package com.botao.mapper;import com.botao.pojo.Person;public interface PersonMapper {Person selectPersonById(Integer id);
}

7. 创建XML的Mapper文件

在resources/mapper目录下创建PersonMapper.xml文件，并配置如下信息：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.botao.mapper.PersonMapper"><select id="selectPersonById" resultType="com.botao.pojo.Person">select * from Person where id = #{id}</select>
</mapper>

好了，到目前位置，我们的工程就完成了，可以创建一个main方法，或用Junit来测试下。

这里写一个Main方法做下测试：

package com.botao;import com.botao.mapper.PersonMapper;
import com.botao.pojo.Person;
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;public class App {public static void main(String[] args) throws IOException {System.out.println("use mybatis connect to database ... ");// 根据 mybatis-config.xml 配置的信息得到 sqlSessionFactoryString resource = "mybatis-config.xml";InputStream inputStream = Resources.getResourceAsStream(resource);SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);// 然后根据 sqlSessionFactory 得到 sessionSqlSession session = sqlSessionFactory.openSession();PersonMapper mapper = session.getMapper(PersonMapper.class);Person person = mapper.selectPersonById(1);System.out.println(person);}
}

测试结果：

C:\app\java\jdk1.8.0_131\bin\java.exe  ...
use mybatis connect to database ...
PersonMapper{id=1, name='poter1', age=10}Process finished with exit code 0

OK！这就是所有内容了，如果对上面的说明有任何疑问，欢迎留言与我交流。