什么是MyBatis

一、MyBatis概述

1.1 原始的JDBC操作

        谈及mybatis，必然需要先了解Java和数据库的连接技术——JDBC(Java DataBase Connectivity)。但是原始JDBC操作中，却存在如下缺点：

1. 数据库连接创建、释放频繁造成系统资源浪费从而影响系统性能。
2. sql语句在代码中硬编译，造成代码不易维护，实际应用sql变化的可能较大，sql变动需要改变Java代码。
3. 查询操作时，需要手动将结果集中的数据手动封装到实体中；插入操作时，需要手动将实体的数据设置到sql语句的占位符位置。

        如下为原始JDBC操作：

 public class JDBCDemo { public static void main(String[] args) throws Exception{ //获取数据库连接对象 Connection conn = DriverManager.getConnection("jdbc:mysql://localhost:3306/db1","root","root"); //定义sql语句 String sql = "select * from db1.emp"; //获取执行sql的对象Statement Statement stmt = conn.createStatement(); //执行sql ResultSet resultSet = stmt.executeQuery(sql); //处理结果 while(resultSet.next()) { int id = resultSet.getInt(1); //获取id String name = resultSet.getString("ename"); //获取姓名 System.out.println("id:" + id + " name:" + name); } //释放资源 stmt.close(); conn.close(); } }

1.2 如何克服JDBC固有缺陷

        而面对上述缺点，我们的解决方案是：

1. 使用数据库连接池技术（C3P0或者Druid）初始化连接资源；
2. 将sql语句抽取到xml配置文件中（解耦合）；
3. 使用反射、内省等底层技术，自动将实体与表进行属性与字段的自动映射（比较困难）。

        因此，mybatis应运而生！

1.3 什么是MyBatis

        mybatis 是一个优秀的基于java的持久层框架，它内部封装了 jdbc，使开发者只需要关注sql语句本身，而不需要花费精力 去处理加载驱动、创建连接、创建statement等繁杂的过程。

        mybatis通过xml或注解的方式将要执行的各种 statement配置起来，并通过java对象和statement中sql的动态参数进行 映射生成最终执行的sql语句。

        最后mybatis框架执行sql并将结果映射为java对象并返回。采用ORM思想解决了实体和数据库映射的问题，对jdbc 进行了 封装，屏蔽了jdbc api 底层访问细节，使我们不用与jdbc api 打交道，就可以完成对数据库的持久化操作 。

二、MyBatis传统开发步骤

        首先，我们可以先访问一下MyBatis官网地址：mybatis – MyBatis 3 | Introduction，这里有完整的mybatis的介绍。

2.1 添加MyBatis的坐标

        把mysql和mybatis的坐标引入pom.xml中。

<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.32</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.7</version> </dependency>

2.2 创建一个实体

        在项目下创建一个User.java的实体。

 public class User { private int id; private String username; private String password; public int getId() { return id; } public void setId(int id) { this.id = id; } public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public String getPassword() { return password; } public void setPassword(String password) { this.password = password; } @Override public String toString() { return "User{" + "id=" + id + ", username='" + username + '\'' + ", password='" + password + '\'' + '}'; } }

2.3 编写映射文件

        在文件夹resources下再创建一个mapper文件夹，再创建映射文件UserMapper.xml。后续我们的sql语句可以全部写到这里。

2.3.1先写一个通用的dtd约束头

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

2.3.2 再配置mapper

        这里是select子句，当然也可以时insert、update等等。

<mapper namespace="userMapper"> <select id="findAll" resultType="user"> select * from db1.user </select> </mapper>

• namespace：命名空间。起名可以随意。例如使用时我们可以用userMapper.findAll来使用对应的select语句。

• resultType：结果类型。从数据库查询到的数据封装到哪个位置。例如我们这里的select子句查询到的结果要封装到User实体集中，但是这里用user而不适用domain.User是因为在接下来的核心配置文件SqlMapConfig.xml中我们通过typeAliases标签将domain.User更名为user。

注意：这里必须先要有一个user数据库表。

2.4 编写核心文件

2.4.1 核心配置文件SqlMapConfig.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>     <!--通过properties标签加载外部properties文件--> <properties resource="jdbc.properties"/>     <!--自定义别名--> <typeAliases> <typeAlias type="domain.User" alias="user"/> </typeAliases>     <!--数据源环境--> <environments default="developement"> <environment id="developement"> <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/UserMapper.xml"/> </mappers> </configuration>

• typeAliases：设置类型别名。比如这里我们使用自己定义的user更换本来的domain.User。所以在UserMapper.xml中我们就可以把sql语句中的resultType字段写成“user”。但是mybatis本身也为我们提供了一些别名来方便简写，如下：

        而后期我们在执行更新操作时，就可以直接使用parameterType=”int” 而不是 parameterType=”java.lang.Integer”，比如：

<update id="update" parameterType="int"> update user set username=#{username},password=#{password} where id=#{id} </update>

• transactionManager：事务管理器。取值有两种，JDBC和MANAGED，这里我们使用JDBC。

• dataSource：数据源。取值有三种，UNPOOLED、POOLED和JNDI，这里我们使用POOLED，利用“池”的概念将 JDBC 连接对象组织起来。

• property：配置数据库连接池的属性。这里使用了jdbc.properties来简化书写，当然也可以直接写。

• mappers：用来加载映射，加载方式有如下几种：

• 使用相对于类路径的资源引用，例如：

<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>

• 使用完全限定资源定位符（URL），例如：

<mapper url="file:///var/mappers/AuthorMapper.xml"/>

• 使用映射器接口实现类的完全限定类名，例如：

<mapper class="org.mybatis.builder.AuthorMapper"/>

• 将包内的映射器接口实现全部注册为映射器，例如：

<package name="org.mybatis.builder"/>

2.4.2 配置文件jdbc.properties

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/db1 jdbc.username=root jdbc.password=root

2.5 测试

2.5.1 编写测试代码

 / * 查询 * @throws IOException */ @Test public void test1() throws IOException { //获得核心配置文件 InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml"); //获得session工厂对象 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream); //获得session会话对象 SqlSession sqlSession = sqlSessionFactory.openSession(); //执行操作 参数：namespace+id List<User> userList = sqlSession.selectList("userMapper.findAll"); //打印数据 System.out.println(userList); //释放资源 sqlSession.close(); }

• SqlSessionFactoryBuilder ：工厂构建器。通过加载mybatis的核心文件的输入流的形式构建一个SqlSessionFactory对象 。

• SqlSessionFactory：工厂对象 ，用来创建sql会话。openSession( )会默认开启一个事务，但事务不会自动提交，也就意味着需要手动提 交该事务，更新操作数据才会持久化到数据库中 。如果里面传一个参数为true，那么不需要手动提交事务（更新操作中sqlSession.commit()方法就不需要写了）。

• SqlSession ：会话对象。执行接下来的增删改查操作。

2.5.2 代码要点

        这里我们可以看到，查询数据的一段java代码为：

 List<User> userList = sqlSession.selectList("userMapper.findAll");

        而这句代码中sqlSession.selectList的参数即我们刚才在UserMapper.xml 中写的代码：

<mapper namespace="userMapper"> <select id="findAll" resultType="user"> select * from db1.user </select> </mapper>

        同理，我们也可以同样得到添加数据、修改数据和删除数据类似的代码：

• 添加数据：

 sqlSession.insert("userMapper.add", user);

<insert id="add" parameterType="快速入门.User"> insert into user values(#{id},#{username},#{password}) </insert>

• 修改数据

 sqlSession.update("userMapper.update", user);

<update id="update" parameterType="快速入门.User"> update user set username=#{username},password=#{password} where id=#{id} </update>

• 删除数据

 sqlSession.delete("userMapper.delete",3); 

<delete id="delete" parameterType="快速入门.User"> delete from user where id=#{id} </delete>

2.5.3 输出结果

        执行编写好的代码，可以看到输出结果：

        上面被选中的输出语句为：

[User{id=1, username='zhangsan', password='123'}, User{id=2, username='lisi', password='234'}, User{id=5, username='wangwu', password='abc'}, User{id=6, username='ray', password='111'}]

        而我们再看一下数据库当中的数据，判断是否输出正常：

        这里我们可以看到，一共4条数据，数据库中的数据已经被我们成功查找到。

三、总结

        原来直接使用JDBC的sql代码被我们写入到了映射文件UserMapper.xml中，后续一些动态sql的加入更加简化了xml中代码量的书写。而在Java代码中，我们只需要新建一些SqlSession对象便可以将xml中的sql语句直接使用，耦合度大大降低。但是我们也不难发现，这样的配置还是相对复杂的，因此就有了后来的MyBatisPlus来更加简化我们的代码书写。