MyBatis框架如何实现数据查询？有几种方法？

短命女 2023-10-10 16:05 10阅读 0赞

在实际开发中，查询操作通常都会涉及到单条数据的精确查询，以及多条数据的模糊查询。那么使用MyBatis框架是如何进行这两种查询的呢？接下来，本小节将讲解下如何使用MyBatis框架根据客户编号查询客户信息，以及根据客户名模糊查询客户信息。

**1．根据客户编号查询客户信息**

根据客户编号查询客户信息主要是通过查询客户表中的主键（这里表示唯一的客户编号）来实现的，其具体实现步骤如下：

（1）在MySQL数据库中，创建一个名为mybatis的数据库，在此数据库中创建一个t\_customer表，同时预先插入几条数据。此操作所执行的SQL语句如下所示。

# 创建一个名称为mybatis的数据库CREATEDATABASE mybatis;# 使用mybatis数据库USE mybatis;# 创建一个名称为t_customer的表CREATETABLE t_customer (
        id int(32)PRIMARYKEYAUTO_INCREMENT,
        username varchar(50),
        jobs varchar(50),
        phone varchar(16));# 插入3条数据INSERTINTO t_customer VALUES('1','joy','doctor','13745874578');INSERTINTO t_customer VALUES('2','jack','teacher','13521210112');INSERTINTO t_customer VALUES('3','tom','worker','15179405961');

完成上述操作后，数据库t\_customer表中的数据如图1所示。

![2a8eab13fec7b8aa1c60aa8c85963767.jpeg][]

图1 t\_customer表

（2）在Eclipse中，创建一个名为chapter06的Web项目，将MyBatis的核心JAR包、lib目录中的依赖JAR包，以及MySQL数据库的驱动JAR包一同添加到项目的lib目录下, 并发布到类路径中。添加后的lib目录如图2所示。

![7c26155068601188ad4874e0809e64d0.png][]

图2 MyBatis相关JAR包

（3）由于MyBatis默认使用log4j输出日志信息，所以如果要查看控制台的输出SQL语句，那么就需要在classpath路径下配置其日志文件。在项目的src目录下创建log4j.properties文件，编辑后的内容如文件1所示。

文件1 log4j.properties

# Global logging configuration
    log4j.rootLogger=ERROR, stdout
    # MyBatis logging configuration...
    log4j.logger.com.itheima=DEBUG
    # 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

在文件1中，包含了全局的日志配置、MyBatis的日志配置和控制台输出，其中MyBatis的日志配置用于将com.itheima包下所有类的日志记录级别设置为DEBUG。

由于log4j文件中的具体内容已经超出了本书范围，所以这里不过多讲解，读者可自行查找资料学习。上述配置文件代码也不需要读者全部手写，在MyBatis使用手册中的Logging小节，可以找到如图3所示的配置信息，只需将其复制到项目的log4j配置文件中，并对MyBatis的日志配置信息进行简单修改即可使用。

![c8c504252ebaa51ff6b76b17f88b487c.png][]

图3 MyBatis使用手册中的Logging配置

（4）在src目录下，创建一个com.itheima.po包，在该包下创建持久化类Customer，并在类中声明id、username、jobs和phone属性，及其对应的getter/setter方法，如文件2所示。

文件2 Customer.java

package com.itheima.po;/**
          * 客户持久化类
          */public class Customer {
             private Integer id;// 主键id
             private String username;// 客户名称
             private String jobs;// 职业
             private String phone;// 电话publicInteger getId() {
                 return id;
             }
             public void setId(Integer id) {
                 this.id = id;
             }
             public String getUsername() {
                 return username;
             }
             public void setUsername(String username) {
                 this.username = username;
             }
             public String getJobs() {
                 return jobs;
             }
             public void setJobs(String jobs) {
                 this.jobs = jobs;
             }
             public String getPhone() {
                 return phone;
             }
             public void setPhone(String phone) {
                 this.phone = phone;
             }
             @Overridepublic String toString() {
                 return"Customer [id="+ id +", username="+ username +", jobs="+ jobs +", phone="+ phone +"]";
             }
         }

从上述代码可以看出，持久化类Customer与普通的JavaBean并没有什么区别，只是其属性字段与数据库中的表字段相对应。实际上，Customer就是一个POJO（普通Java对象），MyBatis就是采用POJO作为持久化类来完成对数据库操作的。

（5）在src目录下，创建一个com.itheima.mapper包，并在包中创建映射文件CustomerMapper.xml，编辑后如文件3所示。

文件3 CustomerMapper.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.itheima.mapper.CustomerMapper"><select id="findCustomerById" parameterType="Integer"
                 resultType="com.itheima.po.Customer">select*from t_customer where id =#{id}</select></mapper>

在文件3中，第2~3行是MyBatis的约束配置，第5~11行是需要程序员编写的映射信息。其中，<mapper>元素是配置文件的根元素，它包含一个namespace属性，该属性为这个<mapper>指定了唯一的命名空间，通常会设置成“包名+SQL映射文件名”的形式。子元素<select>中的信息是用于执行查询操作的配置，其id属性是<select>元素在映射文件中的唯一标识；parameterType属性用于指定传入参数的类型，这里表示传递给执行SQL的是一个Integer类型的参数；resultType属性用于指定返回结果的类型，这里表示返回的数据是Customer类型。在定义的查询SQL语句中，“\#\{\}”用来表示一个占位符，相当于“?”，而“\#\{id\}”表示该占位符待接收参数的名称为id。

多学一招： 快速获取配置文件的约束信息

在MyBatis的映射文件中，包含了一些约束信息，初学者如果自己动手去编写，不但浪费时间，还容易出错。其实，在MyBatis使用手册中，就可以找到这些约束信息，具体的获取方法如下：

打开MyBatis的使用手册mybatis-3.4.2.pdf，在第2小节Getting started（入门指南）下的2.1.5小节Exploring Mapped SQL Statements中，即可找到映射文件的约束信息。如图4所示。

![7ce15c55bfddece2f4f5437f4e83ee72.png][]

图4 映射文件的约束信息

在图4中，方框处标注的文件信息就是MyBatis映射文件的约束信息。初学者只需将信息复制到项目创建的XML文件中即可。

（6）在src目录下，创建MyBatis的核心配置文件mybatis-config.xml，编辑后如文件4所示。

文件4 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="mysql"><environment id="mysql"><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver"value="com.mysql.jdbc.Driver"/><property name="url"value="jdbc:mysql://localhost:3306/mybatis"/><property name="username"value="root"/><property name="password"value="root"/></dataSource></environment></environments><mappers><mapper resource="com/itheima/mapper/CustomerMapper.xml"/></mappers></configuration>

在文件4中，第2~3行是MyBatis的配置文件的约束信息，下面<configuration>元素中的内容就是开发人员需要编写的配置信息。这里按照<configuration>子元素的功能不同，将配置分为了两个步骤：第1步配置了环境，第2步配置了Mapper的位置。关于上述代码中各个元素的详细配置信息将在下一章进行详细讲解，此案例中读者只需要按照上述代码配置即可。

小提示：

上述配置文件同样不需要读者完全手动编写。在MyBatis使用手册mybatis-3.4.2.pdf的2.1.2小节中，已经给出了配置模板（包含约束信息），读者只需要复制过来，依照自己的项目需求修改即可。

（7）在src目录下，创建一个com.itheima.test包，在该包下创建测试类MybatisTest，并在类中编写测试方法findCustomerByIdTest()，如文件5所示。

文件5 MybatisTest.java

packagecom.itheima.test;importjava.io.InputStream;importorg.apache.ibatis.io.Resources;importorg.apache.ibatis.session.SqlSession;importorg.apache.ibatis.session.SqlSessionFactory;importorg.apache.ibatis.session.SqlSessionFactoryBuilder;importorg.junit.Test;importcom.itheima.po.Customer;/**
          * 入门程序测试类
          */publicclassMybatisTest{/**
              * 根据客户编号查询客户信息
              */@TestpublicvoidfindCustomerByIdTest()throwsException{// 1、读取配置文件String resource ="mybatis-config.xml";InputStream inputStream =Resources.getResourceAsStream(resource);// 2、根据配置文件构建SqlSessionFactorySqlSessionFactory sqlSessionFactory =newSqlSessionFactoryBuilder().build(inputStream);// 3、通过SqlSessionFactory创建SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();// 4、SqlSession执行映射文件中定义的SQL，并返回映射结果Customer customer = sqlSession.selectOne("com.itheima.mapper"+".CustomerMapper.findCustomerById",1);// 打印输出结果System.out.println(customer.toString());// 5、关闭SqlSession
                 sqlSession.close();}}

在文件5的findCustomerByIdTest()方法中，首先通过输入流读取了配置文件，然后根据配置文件构建了SqlSessionFactory对象。接下来通过SqlSessionFactory对象又创建了SqlSession对象，并通过SqlSession对象的selectOne()方法执行查询操作。selectOne()方法的第1个参数表示映射SQL的标识字符串，它由CustomerMapper.xml中<mapper>元素的namespace属性值+<select>元素的id属性值组成；第2个参数表示查询所需的参数，这里查询的是客户表中id为1的客户。为了查看查询结果，这里使用了输出语句输出查询结果信息。最后，程序执行完毕时，关闭了SqlSession。

使用JUnit4测试执行findCustomerByIdTest()方法后，控制台的输出结果如图5所示。

![c940b0a2977957cf53ec58316877cb37.png][]

图5 运行结果

从图5可以看出，使用MyBatis框架已经成功查询出了id为1的客户信息。

**2．根据客户名模糊查询客户信息**

了解了如何使用MyBatis根据客户编号查询客户信息后，接下来讲解下如何根据客户的名称来模糊查询相关的客户信息。

模糊查询的实现非常简单，只需在映射文件中通过<select>元素编写相应的SQL语句，并通过sqlSession的查询方法执行该SQL即可。其具体实现步骤如下：

（1）在映射文件CustomerMapper.xml中，添加根据客户名模糊查询客户信息列表的SQL语句，具体实现代码如下。

<select id="findCustomerByName" parameterType="String"
        resultType="com.itheima.po.Customer">select*from t_customer where username like'%${value}%'</select>

与根据客户编号查询相比，上述配置代码中的属性id、parameterType和SQL语句都发生相应变化。其中，SQL语句中的“$\{\}”用来表示拼接SQL的字符串，即不加解释的原样输出。“$\{value\}”表示要拼接的是简单类型参数。

脚下留心：防止SQL注入

在使用“$\{\}”进行SQL字符串拼接时，无法防止SQL注入问题。所以想要既能实现模糊查询，又要防止SQL注入，可以对上述映射文件CustomerMapper.xml中模糊查询的select语句进行修改，使用MySQL中的concat()函数进行字符串拼接。具体修改示例如下所示。

select * from t_customer where username like concat('%',#{value},'%')

（2）在测试类MybatisTest中，添加一个测试方法findCustomerByNameTest()，其代码如下所示。

/**
     * 根据用户名称来模糊查询用户信息列表
     */@Testpublic void findCustomerByNameTest() throws Exception{    
        // 1、读取配置文件
        String resource ="mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);// 2、根据配置文件构建SqlSessionFactory
        SqlSessionFactory sqlSessionFactory = 
    new SqlSessionFactoryBuilder().build(inputStream);// 3、通过SqlSessionFactory创建SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();// 4、SqlSession执行映射文件中定义的SQL，并返回映射结果
        List<Customer> customers = sqlSession.selectList("com.itheima.mapper"+".CustomerMapper.findCustomerByName","j");for(Customer customer : customers) {
            //打印输出结果集
            System.out.println(customer);
        }
        // 5、关闭SqlSession
        sqlSession.close();
    }

从上述代码可以看出，findCustomerByNameTest()方法只是在第4步时与根据客户编号查询的测试方法有所不同，其他步骤都一致。在第4步时，由于可能查询出的是多条数据，所以调用的是SqlSession的selectList()方法来查询返回结果的集合对象，并使用for循环输出结果集对象。

使用JUnit4执行findCustomerByNameTest()方法后，控制台的输出结果如图6所示。

![4bd530f0b7377c0adbd56fb6f27087a0.jpeg][]

图6 运行结果

从图6可以看出，使用MyBatis框架已成功查询出了客户表中客户名称中带有“j”的2条客户信息。

至此，MyBatis入门程序的查询功能就已经讲解完成。从上面两个查询方法中可以发现，MyBatis的操作大致可分为以下几个步骤：

1) 读取配置文件。

2) 根据配置文件构建SqlSessionFactory。

3) 通过SqlSessionFactory创建SqlSession。

4) 使用SqlSession对象操作数据库（包括查询、添加、修改、删除，以及提交事务等）。

5) 关闭SqlSession。

[2a8eab13fec7b8aa1c60aa8c85963767.jpeg]: https://img-blog.csdnimg.cn/img_convert/2a8eab13fec7b8aa1c60aa8c85963767.jpeg
[7c26155068601188ad4874e0809e64d0.png]: https://img-blog.csdnimg.cn/img_convert/7c26155068601188ad4874e0809e64d0.png
[c8c504252ebaa51ff6b76b17f88b487c.png]: https://img-blog.csdnimg.cn/img_convert/c8c504252ebaa51ff6b76b17f88b487c.png
[7ce15c55bfddece2f4f5437f4e83ee72.png]: https://img-blog.csdnimg.cn/img_convert/7ce15c55bfddece2f4f5437f4e83ee72.png
[c940b0a2977957cf53ec58316877cb37.png]: https://img-blog.csdnimg.cn/img_convert/c940b0a2977957cf53ec58316877cb37.png
[4bd530f0b7377c0adbd56fb6f27087a0.jpeg]: https://img-blog.csdnimg.cn/img_convert/4bd530f0b7377c0adbd56fb6f27087a0.jpeg