本章节将介绍 元素,使用该元素可以定义一个 SQL 片段。然后在 Mapper.xml 文件中使用 标签根据 ID 引用 SQL 片段。
要使用 元素,我们需要先了解 元素的 DTD 定义,如下:
id CDATA #REQUIRED
lang CDATA #IMPLIED
databaseId CDATA #IMPLIED>
MyBatis 中 元素用于定义一个 SQL 片段,用于分离一些公共的 SQL 语句,例如:SELECT 关键字和 WHERE 关键字之间的部分。其中:id:唯一标识符,用于在其他地方使用 标签引用;
lang:设置字符编码;
databaseId:指定执行该 SQL 语句的数据库ID,数据库ID在 mybatis-cfg.xml 中的 中配置。
同时,你也能够看见 标签中可以使用 、、、、、、、 等标签定义复杂的 SQL 片段。例如:
`user_id`, `name`, `sex`, `age`
在 标签中使用 标签,如下:
`user_id`, `name`
, `sex`, `age`
完整示例
下面将通过本实例演示怎样使用 标签。
(1)MyBatis 配置文件 mybatis-cfg.xml 文件内容如下:<?xml version="1.0" encoding="UTF-8" ?>
configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"https://mybatis.org/dtd/mybatis-3-config.dtd">
(2)定义 Mapper 接口 UserMapper.java 文件,内容如下:package com.hxstrive.mybatis.sql.demo1;
import java.util.List;
public interface UserMapper {
/** 查询所有用户信息 */
List findAll();
}
(3)定义 Mapper XML文件 UserMapper.xml,内容如下:<?xml version="1.0" encoding="UTF-8"?>
mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"https://mybatis.org/dtd/mybatis-3-mapper.dtd">
`user_id`, `name`, `sex`, `age`
select from `user`
(4)定义返回结果实体Bean UserBean.java,内容如下:package com.hxstrive.mybatis.sql.demo1;
public class UserBean {
private Integer userId;
private String name;
private String sex;
private Integer age;
// 忽略 setter和getter
@Override
public String toString() {
return "UserBean{" +
"userId=" + userId +
", name='" + name + '\'' +
", sex='" + sex + '\'' +
", age=" + age +
'}';
}
}
(5)客户端代码如下:package com.hxstrive.mybatis.sql.demo1;
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 java.io.IOException;
import java.io.InputStream;
import java.util.List;
public class SqlDemo1 {
public static void main(String[] args) throws Exception {
new SqlDemo1();
}
public SqlDemo1() throws IOException {
// 获取 Mapper 对象
String cfgName = "com/hxstrive/mybatis/sql/demo1/mybatis-cfg.xml";
InputStream input = Resources.getResourceAsStream(cfgName);
SqlSessionFactoryBuilder factoryBuilder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlFactory = factoryBuilder.build(input);
SqlSession sqlSession = sqlFactory.openSession(true);
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 查询所有用户
List userBeanList = userMapper.findAll();
for(UserBean userBean : userBeanList) {
System.out.println(userBean);
}
}
}
运行结果如下:UserBean{userId=1, name='ZhangSan', sex='男', age=28}
UserBean{userId=2, name='李艳', sex='女', age=27}
UserBean{userId=3, name='ZhaoLiu', sex='男', age=28}