在实际开发中，查询操作通常都会涉及到单条数据的精确查询，以及多条数据的模糊查询。那么使用MyBatis框架是如何进行这两种查询的呢？接下来，本小节将讲解下如何使用MyBatis框架根据客户编号查询客户信息，以及根据客户名模糊查询客户信息。
1．根据客户编号查询客户信息
根据客户编号查询客户信息主要是通过查询客户表中的主键（这里表示唯一的客户编号）来实现的，其具体实现步骤如下：
（1）在MySQL数据库中，创建一个名为mybatis的数据库，在此数据库中创建一个t_customer表，同时预先插入几条数据。此操作所执行的SQL语句如下所示。
# 创建一个名称为mybatis的数据库
CREATE DATABASE mybatis;
# 使用mybatis数据库
USE mybatis;
# 创建一个名称为t_customer的表
CREATE TABLE t_customer (
id int(32) PRIMARY KEY AUTO_INCREMENT,
username varchar(50),
jobs varchar(50),
phone varchar(16)
);
# 插入3条数据
INSERT INTO t_customer VALUES ('1', 'joy', 'doctor', '13745874578');
INSERT INTO t_customer VALUES ('2', 'jack', 'teacher', '13521210112');
INSERT INTO t_customer VALUES ('3', 'tom', 'worker', '15179405961');
完成上述操作后，数据库t_customer表中的数据如图1所示。
图1 t_customer表
（2）在Eclipse中，创建一个名为chapter06的Web项目，将MyBatis的核心JAR包、lib目录中的依赖JAR包，以及MySQL数据库的驱动JAR包一同添加到项目的lib目录下, 并发布到类路径中。添加后的lib目录如图2所示。
图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的日志配置信息进行简单修改即可使用。
图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; // 电话
public Integer 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;
}
@Override
public 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">
<!-- namespace表示命名空间 -->
<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所示。
图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>
<!--1.配置环境 ，默认的环境id为mysql-->
<environments default="mysql">
<!--1.2.配置id为mysql的数据库环境 -->
<environment id="mysql">
<!-- 使用JDBC的事务管理 -->
<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>
<!--2.配置Mapper的位置 -->
<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
package com.itheima.test;
import java.io.InputStream;
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 org.junit.Test;
import com.itheima.po.Customer;
/**
* 入门程序测试类
*/
public class MybatisTest {
/**
* 根据客户编号查询客户信息
*/
@Test
public void findCustomerByIdTest() 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，并返回映射结果
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所示。
图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()，其代码如下所示。
/**
* 根据用户名称来模糊查询用户信息列表
*/
@Test
public 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所示。
图6 运行结果
从图6可以看出，使用MyBatis框架已成功查询出了客户表中客户名称中带有“j”的2条客户信息。
至此，MyBatis入门程序的查询功能就已经讲解完成。从上面两个查询方法中可以发现，MyBatis的操作大致可分为以下几个步骤：
1) 读取配置文件。
2) 根据配置文件构建SqlSessionFactory。
3) 通过SqlSessionFactory创建SqlSession。
4) 使用SqlSession对象操作数据库（包括查询、添加、修改、删除，以及提交事务等）。
5) 关闭SqlSession。
原创文章，作者：ItWorker，如若转载，请注明出处：https://blog.ytso.com/tech/java/253812.html