SSM框架之Mybatis使用笔记（一）

可能遇到的问题：

1. 配置文件没注册(实现接口的Mapper.xml没有在mybatis-config.xml核心配置文件中进行注册)
   ==> 问题存在第二步

---

2. 接口绑定错误(实现接口的Mapper.xml中的标签的属性namespace绑定错误)
3. 方法名不对(标签的属性id绑定的方法名不一致)
4. 返回类型不对(标签的属性resultType等返回类型不对)
   ==> 问题存在第三步

---

5. Maven导出资源问题(没有添加build进行资源过滤) ==> 问题存在第一步

启动数据库

Mybatis使用流程

• 第一步：创建Maven项目后修改根目录下的pom.xml文件

1. 添加依赖

    <dependencies>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.17</version>
        </dependency>
        <dependency>
            <!-- mybatis -->
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.2</version>
        </dependency>
        <dependency>
            <!-- junit -->
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>

    </dependencies>

2. 添加build

    <build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>
    </build>

• 第二步：在resources目录下创建mybatis-config.xml核心配置文件，类似于JavaWeb的加载驱动。其中需要注意的是，每有一个实现接口的Mapper.xml文件，都需要在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>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=false&amp;useUnicode=true&amp;characterEncoding=utf-8&amp;serverTimezone=UTC&amp;autoReconnect=true"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <!-- 每一个Mapper.xml 都需要在Mybatis核心配置文件中注册,即在mybatis-config.xml文件中注册-->
    <mappers>
        <!-- 模板 -->
        <mapper resource="org/mybatis/example/BlogMapper.xml"/>
        <!-- 例子 -->
        <mapper resource="com/feng/dao/UserMapper.xml"/>
    </mappers>
</configuration>

• 第三步：构建SqlSessionFactory，获取SqlSession，相当于获取数据库操作的权柄，使用sqlSession可以指哪打哪。由于获取过程的不变的，因此使用静态方法，并且sqlSession相当于一个工具，因此给它创建一个MybatisUtils工具类

//构建SqlSessionFactory --> 获取SqlSession
public class MybatisUtils {

    private static SqlSessionFactory sqlSessionFactory;

    static{
        try {
            //使用mybatis第一步：获取SqlSessionFactory对象
            String resource = "mybatis-config.xml";//核心配置文件的名称可以自己起
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    /*
    * 既然有了 SqlSessionFactory，顾名思义，我们可以从中获得 SqlSession 的实例。
    * SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。
    * 可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。
    */
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }

}

前三步完成配置操作，后面是编码测试步骤

• 第四步：有三小步骤

1. 创建实体类(与JavaWeb一致)
2. 创建实体类的Mapper(Dao)接口

public interface UserMapper {
    // 获取用户列表的方法
    List<User> getUserList();
    // 
}

3. 实现接口以Mapper.xml(替代了之前的impl)
   每有一个接口，都需要有对应的mapper标签
   关键 mapper 标签中，属性 namespace 绑定对应接口
   <select标签中，属性 id 对应接口中的方法名 属性 resultType 对应方法的返回类型

<?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">
<!-- namespace=绑定一个对应的Mapper接口 -->
<mapper namespace="com.feng.dao.UserMapper">
    <!-- id=方法名 resultType返回一个，resultMap返回集合-->
    <select id="getUserList" resultType="com.feng.pojo.User">
        select * from mybatis.user 
    </select>
</mapper>

• 第五步：使用sqlSession工具去操作数据。

public class UserMapperTest {

    @Test
    public void test(){
        // 第一步：获得sqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        // 第二步：执行sql
        /*
         * 1. 从sqlSession里执行sql，如何获取sql？
         * 2. 通过getMapper获取UserMapper接口，使用面向接口编程
         *   因为xml是UserMapper具体实现，因此只需要获取接口即可。
         * 3. 获取接口userMapper后，即可通过接口调用接口提供方法。
         * */
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        List<User> userList = userMapper.getUserList();

        for (User user : userList) {
            System.out.println(user);
        }
        // 第三步：关闭sqlSession
        sqlSession.close();
    }
}

测试结果

项目结构

总结

为了避免在每一个模块的pom.xml文件中每次都添加依赖，可以采用以下方法：先创建一个父工程，在父项目中添加依赖后，再创建子工程，子工程会继承父工程的依赖，因此不需要每次都添加依赖。

JavaWeb与Mybatis的异同点

JavaWeb	Mybatis
导入jar包	在pom.xml配置文件中导入依赖和build
加载驱动	配置mybatis-config.xml核心配置文件
将加载驱动封装成工具类	构建工具类获取sqlsession（为了获取接口，从而能够使用接口提供的服务，封装成对象更加安全以及符合面向对象思想）
创建实体类	创建实体类
创建接口类（Dao）	创建接口类（Mapper）
实现接口类（impl）［手动输入参数以及执行sql的代码如preparedstatement、resultset一堆重复代码］	实现接口类（Mapper.xml）［namespace，id，resultType，parameterType，#｛｝］
使用接口提供的服务（Servlet）	使用接口提供的服务（sqlsession）［mybatis-config.xml中添加对应mapper进行注册］

Mybatis优点：

1. 直接导入依赖，Maven自动帮我们下载jar包
2. 加载驱动连接数据库，只需要修改mybatis-config.xml中的environment标签下的property标签内容即可
3. 构建工具类，JavaWeb里获取connect对象，Mybatis获取sqlsession对象（先根据mybatis-config.xml获取sqlsessionfactory，再用工厂创建sqlsession实例）
4. 创建实体类与JavaWeb一致
5. 创建接口类与JavaWeb一致
6. 实现接口使用Mapper.xml，先用namespace绑定对应接口名，再用id绑定对应方法名，再根据类型和参数绑定对应数据，最后编写sql语句（JavaWeb：获取连接，输入参数，准备sql，执行sql，返回结果集，释放连接）乍一看用JavaWeb也太累了吧，啥啥都要自己手工配置。
7. 使用服务差不多，sqlsession可以直接执行已经映射（已经写入Mapper.xml）的sql语句