关于Mapper 与 Mapper.xml文件之间匹配的问题

这里我们做一个实例

user实体类

public class User {
    private Integer id;
    private String username;
    private String password;
    private String email;
    private String phone;

数据库user表

userMapper.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="wdc.dao.UserMapper">
    <resultMap id="BaseResultMap" type="wdc.pojo.User">
        <!-- column为数据库字段名  property 为实体类字段名-->
        <id column="id" property="id" jdbcType="INTEGER"/>
        <result column="user_name" property="username" jdbcType="VARCHAR"/>
        <result column="user_password" property="password" jdbcType="VARCHAR"/>
        <result column="user_email" property="email" jdbcType="VARCHAR"/>
        <result column="user_phone" property="phone" jdbcType="VARCHAR"/>

    </resultMap>
    <!-- 这里 id 是数据库字段名 #{id}是实体类字段名，sql语句后面不加封号-->
    <select id="selectUser" parameterType="java.lang.Integer" resultMap="BaseResultMap">
         select *from USER where id=#{id}
    </select>
    <!--此sql用于登录查询
    #{username} 是对应mapper接口文件中 @Param注解中的参数名（防止mapper之间不匹配）-->
    <select id="login" parameterType="java.lang.String" resultMap="BaseResultMap">
        select *from user where user_name=#{username} and user_password=#{password}
    </select>
</mapper>

从上面不难看出，我们使用了resultMap作为映射集，目的是为了使得 实体类user 中的字段与数据库中的字段进行匹配。
而在查询中我们选择 使用结果集resultMap来进行数据映射

  <!-- 这里 id 是数据库字段名 #{id}是实体类字段名，sql语句后面不加封号-->
  <select id="selectUser" parameterType="java.lang.Integer" resultMap="BaseResultMap">

而在另一个查询中，我们在编写sql语句时，使用了对应userMapper文件中，@Param所对应的参数名

 <!-- #{username} 是对应mapper接口文件中 @Param注解中的参数名（防止mapper之间不匹配）-->
   <select id="login" parameterType="java.lang.String" resultMap="BaseResultMap">
       select *from user where user_name=#{username} and user_password=#{password}
   </select>

这里也是为了防止mapper 文件与 xml文件之间匹配出现异常。

userMapper

package wdc.dao;

import org.apache.ibatis.annotations.Param;
import wdc.pojo.User;

public interface UserMapper {
    User selectUser(int id)throws Exception;
    //    登录
    //    @Param中的参数名，对应.xml文件中sql语句#{}中的参数名（防止mapper之间不匹配）
    User login(@Param("username") String username, @Param("password") String password)throws Exception;
}

这里我们重点解释一下

@Param注解

这里我们应该，采用#{}的方式把@Param注解括号内的参数进行引用
对应的是使用方法，上述代码中明确标出。

这里我们也可以不使用@Param注解，前提是数据库字段与实体类字段一一对应，例如 数据库命名为user_name,而我们的实体类就应该使用 驼峰命名 userName,这样就可以使mybatis将查询的结果自发的进行一一对应填充置user 对象中。

但是由于此案例，数据库字段和实体类字段之间的命名方式，使得mybatis 从数据库中查出的字段，不能正常的识别和对应正确的实体类字段，于是，我们需要使用@Param注解来指明，我们所要引用的参数的名称，方便再mapper.xml文件中，采用#{}的方式把@Param注解括号内的参数进行引用，

这样会更方便代码的阅读，也便于避免一些未知错误的发生。

测试

关于对象判空，和空指针异常(NullPointer)

@Test
    public void testLogin() throws Exception{
        ApplicationContext ac = new ClassPathXmlApplicationContext("classpath:config/spring-mybatis.xml");
        UserMapper userMapper = (UserMapper) ac.getBean("userMapper");
        User user = null;

            user = userMapper.login("张","123");
            if(user == null)
                System.out.println("没数据");
            else
                System.out.println(user);


    }

这里测试登录接口后我们发现，当没有数据返回时，我们可以直接 使用  user==null 的方式来对 对象进行判空。

而当我们在此代码中，直接将异常使用 try catch 捕捉时，我们发现，当对象 user 为空时,控制台并不会报出异常。
而当我们在调用 user对象的toSring方法时，则会出现NullPoint的空指针异常

总结：

导致mapper 与xml之间出现不匹配的原因主要有：

1. mapper 文件中 方法名与 xml 中查询语句id 进行匹配
2. mapper 文件中 参数类型，与xml 文件中的参数类型匹配
3. mapper 文件中 返回值类型，与xml文件中的 返回值类型匹配
4. XML 文件的 namespace 指定的路径与 相应的实体类对应
5. mapper 文件 和xml文件不在同一个包下的，要在配置文件中，将两个文件的包同时进行扫描

还有一些较为简单的异常不一一例举，但说明相应原因以供参考：
6. 数据库密码填写错误
7. 数据库服务未开启
8. 数据库路径 以及乱码问题

jdbc.url=jdbc:mysql://localhost:3306/blog?characterEncoding=utf-8

如果有什么不足的地方 还希望大家多多补充。