【Mybatis从0到1-003】mybatis框架及简单入门程序

冷不防 2022-06-10 11:16 186阅读 0赞

mybatis是持久层的框架，是Apache下的顶级项目。2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis，实质上Mybatis对ibatis进行一些改进。 Mybatis通过xml或注解的方式将要执行的各种statement（statement、preparedStatemnt、CallableStatement）配置起来，并通过java对象和statement中的sql进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射成java对象并返回。

本文首先介绍mybatis的框架，之后通过id查询用户的基本信息作为入门程序。

其框架结构如下：

![20170817170236617][]

框架结构也同样是，我们进行操作的流程。

【1】为了便于程序开发，首先创建一个日志文件，便于将来错误的查看。创建log4j.properties文件，路径为：src\\main\\resources\\log4j.properties，输入以下内容：

# Global logging configuration
    #开发环境日志要设置成debug
    log4j.rootLogger=DEBUG, stdout
    # MyBatis logging configuration...
    log4j.logger.org.mybatis.example.BlogMapper=TRACE
    # Console output...
    log4j.appender.stdout=org.apache.log4j.ConsoleAppender
    log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
    log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

【2】创建SqlMapConfig.xml文件，路径为：src\\main\\resources\\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>
        
        <environments default="development">
            <environment id="development">
                
                <transactionManager type="JDBC" />
                
                <dataSource type="POOLED">
                    <property name="driver" value="com.mysql.jdbc.Driver" />
                    <property name="url" value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8" />
                    <property name="username" value="root" />
                    <property name="password" value="123" />
                </dataSource>
            </environment>
        </environments>
        
    </configuration>

【3】根据上面的框架，现在开始配置映射文件，需要注意，在后期的开发中，mapper代理开发映射文件名称叫XXXMapper.xml，比如：UserMapper.xml、ItemsMapper.xml，这里，我们暂时不用mapper代理进行开发，采用最为原始的方式进行开发，这也是从0到1的过程。

新建文件，起名字为User.xml，之所以用User，是因为，后面的内容我们将引入一个更删改查用户信息的入门例子，这也是为后面的开发所准备的。文件路径为：src\\main\\resources\\sqlmap\\User.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="test">
        
        
        
        <select id ="findUserById" parameterType="int" resultType="po.User">
            SELECT *FROM user WHERE id=#{id} </select>
    </mapper>

这段程序不懂不要紧，一点点来解释。这里配置的文件实现的要求是：通过id查询用户表的记录 。代码中有具体的解释。在映射文件中，

resultType="po.User"

表示执行SQL之后返回结果所对应的java对象类型，这里的po.User 中的User类可以看做是返回体，这个文件需要自己创建（当然，在后面，结合spring之后就能自动生成了，现在，我们先手动创建吧）在创建文件之前，还有一点**千万注意**，就是在SqlMapConfig.xml中加载映射文件。在SqlMapConfig.xml中加入以下代码：

<mappers>
        <mapper resource="sqlmap/User.xml"/>
    </mappers>

【4】创建User.java文件，路径为：src\\main\\java\\po\\User.java

public class User {
        private int id;
        private String username;// 用户姓名
        private String sex;// 性别
        private Date birthday;// 生日
        private String address;// 地址
    //setter、getter方法及tostring方法略
    }

【5】上面都设置好之后，开始逻辑的程序编写吧。首先创建java文件，路径为：src\\main\\java\\first\\MyFirstMybatis.java，代码的逻辑，在上面的框架中都有提到，这里，简单叙述下： 1.根据配置文件创建会话工厂（SqlSessionFactory）;2.通过工厂得到SqlSession；3.通过SqlSession操作数据库。

code如下,先通过单元测试来测试下，我们的代码逻辑正确与否。

public class MyFirstMybatis {
        // 根据id查询用户信息，得到一条记录结果
    
    
        public void findUserByIdTest() throws Exception {
    
    
            // mybatis配置文件
            String resource = "SqlMapConfig.xml";
            // 得到配置文件流
            InputStream inputStream = Resources.getResourceAsStream(resource);
    
    
            // 创建会话工厂，传入mybatis的配置文件信息
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    
    
            // 通过工厂得到SqlSession
            SqlSession sqlSession = sqlSessionFactory.openSession();
    
    
            // 通过SqlSession操作数据库
            // 第一个参数：映射文件中statement的id，等于=namespace+"."+statement的id
            // 第二个参数：指定和映射文件中所匹配的parameterType类型的参数
            // sqlSession.selectOne结果 是与映射文件中所匹配的resultType类型的对象
            // selectOne查询出一条记录
            User user = sqlSession.selectOne("test.findUserById", 1);
    
    
            System.out.println(user);
    
    
            // 释放资源
            sqlSession.close();
    
    
        }
    }

【6】最后一步，创建测试文件，进行单元测试。单元测试很简单，idea创建单元测试，这里简单说下简单操作流程。

6.1 鼠标光标放到上面代码的“MyFirstMybatis ”处，点击鼠标右键。如图：

![20170817190539787][]  
6.2 点击“create new test”---->,之后按照图示操作。

![20170817191242012][]

6.3 点击OK，之后创建的文件路径为：src\\test\\java\\first\\MyFirstMybatisTest.java，在**public void findUserByIdTest() throws Exception \{ \}**中贴入下面的代码：

// mybatis配置文件
            String resource = "SqlMapConfig.xml";
            // 得到配置文件流
            InputStream inputStream = Resources.getResourceAsStream(resource);
    
            // 创建会话工厂，传入mybatis的配置文件信息
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    
            // 通过工厂得到SqlSession
            SqlSession sqlSession = sqlSessionFactory.openSession();
    
            // 通过SqlSession操作数据库
            // 第一个参数：映射文件中statement的id，等于=namespace+"."+statement的id
            // 第二个参数：指定和映射文件中所匹配的parameterType类型的参数
            // sqlSession.selectOne结果 是与映射文件中所匹配的resultType类型的对象
            // selectOne查询出一条记录
            User user = sqlSession.selectOne("test.findUserById", 1);
    
            System.out.println(user);
    
            // 释放资源
            sqlSession.close();

【7】到此，所有操作结束。点击run运行，将会看到我们通过id查询用户的基本信息。如下：

![20170817191635628][]

【8】最后，对比下，数据库的信息，看select的结果是否一致。

![20170817191812844][]

请继续关注后续内容，欢迎评论转发并给出指导意见！

[20170817170236617]: /images/20220610/938cc630b7b845e4a2285f8bf24779e1.png
[20170817190539787]: /images/20220610/643c2215b55c460abfbcda875eb9d473.png
[20170817191242012]: /images/20220610/ec9e0b0c394e4563937369363de3c6e1.png
[20170817191635628]: /images/20220610/e0e93d1edc0b4e3daa560a39558aba9f.png
[20170817191812844]: /images/20220610/8908461c890b4cbf8c6378ee519f3f52.png