本章节将介绍怎样使用 和 标签映射参数。
在开始使用之前,我们先看看这两个标签的 DTD 定义。如下:
id CDATA #REQUIRED
type CDATA #REQUIRED>
property CDATA #REQUIRED
javaType CDATA #IMPLIED
jdbcType CDATA #IMPLIED
mode (IN | OUT | INOUT) #IMPLIED
resultMap CDATA #IMPLIED
scale CDATA #IMPLIED
typeHandler CDATA #IMPLIED>
上面 DTD 定义映射参数的标签信息,其中:parameterMap:标签可以用来定义参数组,可以为参数组指定ID、参数类型(即该参数是对那个JavaBean进行映射)
parameter:标签用来定义单个的参数;其中,property 用来指定对应 JavaBean 属性,javaType 对应Java类型,jdbcType对应数据库类型,mode 用于定义存储过程参数类型(输入、输出、输入输入类型)等
下面使用 将参数 ArgBean 对象进行映射。ArgBean.java 类内容如下:public class ArgBean {
private String name;
private int age;
// 忽略 getter 和 setter
}
XML 配置如下:
上面实例中将 com.hxstrive.mybatis.parameter.demo2.ArgBean 映射成 PARAM_MAP,在该映射中有两个参数,分别是 age 和 name,而且通过 javaType 指定参数的 java 类型。然后我们就可以在 等标签的 parameterMap 属性中引用我们定义的 PARAM_MAP 映射。注意:当我们使用 JavaBean 作为参数时,您可以不使用 进行映射。
实例
(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.parameter.demo2;
import java.util.List;
public interface UserMapper {
List getUsers(ArgBean argBean);
List getUsers2(ArgBean argBean);
}
(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">
select `user_id`, `name`, `sex`, `age`
from `user`
where `age`=#{age} and `name` like #{name}
select `user_id`, `name`, `sex`, `age`
from `user`
where `age`=#{age} and `name` like #{name}
(4)定义实体Bean,参数Bean ArgBean.java 内容如下:package com.hxstrive.mybatis.parameter.demo2;
public class ArgBean {
private String name;
private int age;
// 忽略 setter 和 getter
}
返回结果实体Bean UserBean.java 内容如下:package com.hxstrive.mybatis.parameter.demo2;
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.parameter.demo2;
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.InputStream;
import java.util.List;
public class ParameterDemo2 {
public static void main(String[] args) throws Exception {
String cfgName = "com/hxstrive/mybatis/parameter/demo2/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);
ArgBean argBean = new ArgBean();
argBean.setAge(28);
argBean.setName("%Zh%");
List userBeanList = userMapper.getUsers(argBean);
for(UserBean userBean : userBeanList) {
System.out.println(userBean);
}
System.out.println("------------------ 分割线 ------------------");
userBeanList = userMapper.getUsers(argBean);
for(UserBean userBean : userBeanList) {
System.out.println(userBean);
}
}
}