Mybatis --- 映射文件、参数处理、参数值的获取、select元素

最新推荐文章于 2025-06-30 09:44:49 发布

转载最新推荐文章于 2025-06-30 09:44:49 发布 · 5.3k 阅读

本文详细介绍了MyBatis映射文件中的各种标签及其用途，包括增删改查、参数处理、SQL节点复用等内容，并提供了具体的示例代码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

映射文件：指导着MyBatis如何进行数据库增删改查，有着非常重要的意义；

- cache 命名空间的二级缓存配置

- cache-ref 其他命名空间缓存配置的引用。

- resultMap 自定义结果集映射

- parameterMap 已废弃！老式风格的参数映射

- sql 抽取可重用语句块

- insert 映射插入语句

- update 映射更新语句

- delete 映射删除语句

- select 映射查询语句

1.先看增删改查标签

public interface EmployeeMapper
 {

      /*

       *
 增删改查方法

       *
 */

      public Employee
 getEmployeeById(Integer id);

      public void insertEmp(Employee
 employee);

}

在其对应的sql映射文件中：

useGeneratedKeys="true"：默认使用主键自增的主键

keyProperty="id"：将主键赋值给 id 属性

这样就可以在insert函数中获取新添加的用户的 id主键，否则获取不到

<select
 id="getEmployeeById" resultType="employee" databaseId="mysql">

      select
 * from student where id = #{id}

</select>

<insert
 id="insertEmp" parameterType="com.neuedu.entity.Employee" useGeneratedKeys="true" keyProperty="id">

      insert
 into student(name,password,email) values(#{name},#{password},#{email})

</insert>

编写测试单元：

private EmployeeMapper
 mapper = null;

private SqlSession
 session = null;

@Before

public void testBefore(){

      //1.获取sqlSessionFactory对象

      SqlSessionFactory
 sqlSessionFactory = getSqlSessionFactory();

      //2.利用sqlSessionFactory创建一个session对象，表示和数据库的一次会话

      session
 = sqlSessionFactory.openSession();

      //3.用session对象获取mapper接口的代理对象

      //因为sql映射文件给相应的接口创建了一个代理对象，所以mapper接口类不需要实现类

      mapper
 = session.getMapper(EmployeeMapper.class);

}

@Test

public void testSelect(){

      mapper
 = session.getMapper(EmployeeMapper.class);

      //4.通过mapper接口的代理对象就可以对数据库进行增删改查操作

      Employee
 employee = mapper.getEmployeeById(4);

      System.out.println(employee);

}

@Test

public void testInsert(){

      Employee
 emp = new Employee("zhangsan", "1234567", "zhangsan@q.com");

      mapper.insertEmp(emp);

      int id
 = emp.getId();

      System.out.println(id);

}

@After

public void testAfter(){

      //增删改需要提交事务

      session.commit();

      session.close();

}

//@Before、@After自动在@Test之前和之后运行

//查询不需要提交事务，增删改都需要提交事务

2.获取自增主键值【当向数据库中插入一条数据的时候，默认是拿不到主键的值的，需要设置如下两个属性才可以拿到主键值！】

<!--设置userGeneratedKeys属性值为true:使用自动增长的主键。使用keyProperty设置把主键值设置给哪一个属性-->

<insert
 id="addEmp" parameterType="com.neuedu.mybatis.bean.Employee" useGeneratedKeys="true" keyProperty="id" databaseId="mysql">

      insert
 into tbl_employee(last_name,email,gender) values(#{lastName},#{gender},#{email})

</insert>

3.SQL节点：

1).可以用于存储被重用的SQL片段

2).在sql映射文件中,具体使用方式如下：

<sql
 id="npe">

      name,password,email

</sql>

<insert
 id="insertEmp" parameterType="com.neuedu.entity.Employee" useGeneratedKeys="true" keyProperty="id">

      insert
 into student(<include refid="npe"></include>)
 values(#{name},#{password},#{email})

</insert>

参数处理：

- 单个参数：Mybatis 不会特殊处理

　　#{参数名}: 取出参数值，参数名任意写

- 多个参数：Mybatis会做特殊处理，多个参数会被封装成一个map　

　　key：param1...paramN,或者参数的索引也可以（0，1，2，3.....）

value：传入的参数值

#{ }就是从map中获取指定的key的值

命名参数：明确指定封装参数时map的key:@param("id")

　　　多个参数会被封装成一个map,

　　 key：使用@Param注解指定的值

　　 value:参数值

　　 #{指定的key}取出对应的参数值

public void updateEmp(@Param("id")Integer
 id,

                      @Param("name")String
 name,

                      @Param("password")String
 password,

                      @Param("email")String
 email);

<update
 id="updateEmp">

      update
 student set name=#{name},password=#{password},email=#{email} where id=#{id}

</update>

- POJO参数：如果多个参数正好是我们业务逻辑的数据模型，我们就可以直接传入POJO

　　#{属性名}:取出传入的POJO的属性值

public void insertEmp(Employee
 employee);

<sql
 id="npe">

        name,password,email

</sql>

<insert
 id="insertEmp" parameterType="com.neuedu.entity.Employee" useGeneratedKeys="true" keyProperty="id">

    insert
 into student(<include refid="npe"></include>)
 values(#{name},#{password},#{email})

</insert>

@Test

public void testReturnVal(){

    Employee
 employee = mapper.getEmployeeById(30);

    System.out.println(employee);

}

- Map：如果多个参数不是业务模型中的数据，没有对应的pojo，不经常使用，为了方便，我们也可以传入Map

　　#{key}:根据 key 取出map中对应的值

public void updateName(Map<String,
 Object> map);

<update
 id="updateName">

      update
 student set name=#{name} where id=#{id}

</update>

@Test

public void testMap(){

      Map<String,
 Object> map = new HashMap<>();

      map.put("id", 33);

      map.put("name", "刘德华");

      mapper.updateName(map);

}

#关于参数的问题：

①.使用#{}来传递参数

②.若目标方法的参数类型为对象类型，则调用其对应的getter方法，如getEmail()

③.若目标方法的参数类型为Map类型，则调用其get(key)

④.若参数是单个的，或者列表，需要使用@param注解来进行标记

⑤.注意：若只有一个参数，则可以省略@param注解

若有多个参数，必须要写@param注解

参数值的获取：

#{}：可以获取map中的值或者pojo对象属性的值
${}: 可以获取map中的值获取pojo对象属性的值

用例子简单区分一下：

select * from tbl_employee where id = ${id} and last_name = #{lastName}
preparing:select * from tbl_employee where id = 2 and last_name = ?

也就是说：对于${} 在日志中可以看到你输入的值，不安全；

　　　　　对于#{} 在日志中是?，所以相对安全

具体区别：

#{}:是以预编译的形式，将参数设置到sql语句中，相当于PreparedStatement;防止sql注入

<update
 id="updateEmp">

      update
 student set name=#{name},password=#{password},email=#{email} where id=#{id}

</update>

${}:取出的值直接拼装在sql语句中，会有安全问题

<update
 id="updateEmp">

      update
 student set name='${name}',password='${password}',email='${email}' where
 id='${id}'

</update>

大多情况下，我们取参数的值都应该去使用#{}

但是原生JDBC不支持占位符的地方我们就可以使用${}进行取值

比如获取表名、分表、排序；按照年份分表拆分

- select * from ${year}_salary where xxx;[表名不支持预编译]

- select * from tbl_employee order by ${f_name} ${order} :排序是不支持预编译的！

select 元素 ：

select元素来定义查询操作。

　　Id：唯一标识符。

用来引用这条语句，需要和接口的方法名一致

　　parameterType：参数类型。

可以不传，MyBatis会根据TypeHandler自动推断

　　resultType：返回值类型。

别名或者全类名，如果返回的是集合，定义集合中元素的类型。不能和resultMap同时使用

1.返回类型为一个List

public List<Employee>
 getEmps();

<select
 id="getEmps" resultType="com.neuedu.entity.Employee">

      select
 * from student

</select>

@Test

public void testReturnList(){

      List<Employee>
 emps = mapper.getEmps();

      for (Employee
 employee : emps) {

            System.out.println(employee);

      }

}

2.返回记录为一个Map

只能查询单条数据，如果多条的话，多个key 值，找不到

public Map<String,
 Object> getEmpInfoById(Integer id);

resultType 是 Map 的全类名

<select
 id="getEmpInfoById" ="java.util.Map">

      select
 * from student where id = #{id}

</select>

key：列名；value：值

@Test

public void testReturnMap(){

      Map<String,
 Object> emp = mapper.getEmpInfoById(30);

      Set<Entry<String,Object>>
 entrySet = emp.entrySet();

      for (Entry<String,
 Object> entry : entrySet) {

            System.out.println(entry.getKey()+":"+entry.getValue());

      }

}

数据库列名与实体类的属性名不对应的情况下有几种处理方式：

1.sql 语句用 as 换名

2.下划线转换成驼峰式命名

在全局配置文件中

<settings>

    <!--
 setting标签负责每一个属性的设置 -->

    <setting
 name="mapUnderscoreToCamelCase" value="true"/>

</settings>

3.利用ResultMap：

public Employee
 getEmpInfoById(Integer id);

<resultMap
 type="com.neuedu.entity.Employee" id="getEmployByIdMap">

      <!--
 主键映射可以用 id 字段，mybatis在底层会做优化，主键有索引，加快查询速度 -->

      <id
 column="id" property="id"/>

      <!--
 普通列的映射使用result -->

      <result
 column="name" property="name"/>

      <result
 column="password" property="password"/>//相同的也可以不写，但因为规范建议写

      <result
 column="email" property="email"/>

</resultMap>

<select
 id="getEmpInfoById" resultMap="getEmployByIdMap">

      select
 * from student where id = #{id}

</select>

@Test

public void testReturnMap(){

      Employee
 emp = mapper.getEmpInfoById(30);

      System.out.println(emp);

}