MyBatis02 MyBatis基础知识之Mapper映射器

1 Mapper映射器是什么

　　是符合映射文件要求的接口

　　　　接口要求

　　　　　　a. 方法名要与sql的id一致。
　　　　　　b. 方法的参数类型要与parameterType一致。
　　　　　　c. 方法的返回类型要与resultType一致。

　　　　映射文件要求

　　　　　　namespace必须等于接口名(包含包名)

 　　增加笔记（2017年5月19日09:19:46）

　　　　Mapper映射器的作用：如果我们不使用Mapper映射器，那么我们就必须调用SqlSession的相应方法区执行相应的增、删、改、查操作；如果我们使用了Mapper映射器，那么我们执行增、删、改、查这些操作时使用的就是Mapper映射器中的相应方法；但是要想使用Mapper映射器中的方法必须要有一个Mapper映射器对象，这个对象可以通过SqlSession的getMapper方法得到，例如：AdminDao ad = sqlSession.getMapper(AdminDao.class);当然也有得到Mapper对象的简便方法，那就是使用spring去集成mybatis，通过在spring配置文件中配置MapperScannerConfigurer就可以帮相应的Mapper映射器配置一个bean，以后我们就可以通过spring容器来使用这个bean啦。

2 如何使用Mapper映射器

　　2.1 导包

　　　　

　　2.2 添加mybatis配置文件

<?xml version="1.0" encoding="UTF-8" ?>  
<!DOCTYPE configuration PUBLIC "-//ibatis.apache.org//DTD Config 3.0//EN" 
    "http://ibatis.apache.org/dtd/ibatis-3-config.dtd">
<configuration>
    <!-- 和spring整合后，environment配置将被废除 -->
    <environments default="environment">
        <environment id="environment">
            <!-- 使用jdbc事务管理，事务控制由mybatis实现 -->
            <transactionManager type="JDBC" />
            <!-- 数据库连接池，由mybatis进行管理 -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url"
                    value="jdbc:mysql://127.0.0.1:3306/xiangxu" />
                <property name="username" value="root" />
                <property name="password" value="182838" />
            </dataSource>
        </environment>
    </environments>
    
    <!--  指定映射文件的位置（即：加载映射文件）  -->        
    <mappers>
        <mapper resource="cn/xiangxu/telecom/login/entity/AdminMapper.xml" /> <!-- 注意：包名的 . 全部换成 / -->
    </mappers>
    
</configuration> 

　　2.3 编写实体类（类的属性名和表的字段名保持一致）

package cn.xiangxu.telecom.login.entity;

import java.io.Serializable;

public class Admin implements Serializable {
    private Integer id;
    private String name;
    private String password;
    private String gender;
    
    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getPassword() {
        return password;
    }
    public void setPassword(String password) {
        this.password = password;
    }
    public String getGender() {
        return gender;
    }
    public void setGender(String gender) {
        this.gender = gender;
    }

    public String toString() {
        return "Admin [id=" + id + ", name=" + name + ", password=" + password + ", gender=" + gender + "]";
    }
    
}

　　2.4 编写 AdminDao 接口　　

　　　　接口中方法的要求

　　　　　　a. 方法名要与sql的id一致。
　　　　　　b. 方法的参数类型要与parameterType一致。
　　　　　　c. 方法的返回类型要与resultType一致。

package cn.xiangxu.telecom.login.dao;

import java.util.List;
import java.util.Map;

import cn.xiangxu.telecom.login.entity.Admin;
import cn.xiangxu.telecom.login.entity.Admin2;

public interface AdminDao {
    public void insert(Admin admin); // 插入方法
    public List<Admin> findAll(); // 查询所有方法
    public Admin findByName(String name); // 限定查询方法
    public void modify(Admin admin); // 修改方法
    public void deleteByName(String name); // 删除方法
    
    public Map<Object, Object> findByName2(String name); // 查询结果返回Map 的方法
    public Admin2 findByName3(String name); // 实体类的属性名和表的字段名不一致的情况
    public Admin2 findByName4(String name);
    public Admin2 findByName5(String name);
}

　　2.4 添加映射文件并进行编写

　　　　映射文件需满足的要求

　　　　　　映射文件的 namespace 必须等于接口名(包含包名) 

<?xml version="1.0" encoding="UTF-8" ?>  
<!DOCTYPE mapper PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN"      
 "http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd">

<mapper namespace="cn.xiangxu.telecom.login.dao.AdminDao">
    <insert id="insert" parameterType="cn.xiangxu.telecom.login.entity.Admin">
    <!-- 注意：parameterType的属性值一定要写上类名（基本类型除外） -->
        INSERT INTO admin
        (name, password, gender)
        VALUES(#{name}, #{password}, #{gender})
    </insert>    
    
    <select id="findAll" resultType="cn.xiangxu.telecom.login.entity.Admin">
        SELECT * FROM admin
    </select>
    
    <select id="findByName" parameterType="String" resultType="cn.xiangxu.telecom.login.entity.Admin">
        SELECT * FROM admin
        WHERE NAME = #{MYNAME}
    </select>
    
    <update id="modify" parameterType="cn.xiangxu.telecom.login.entity.Admin">
        UPDATE admin 
        SET password=#{password}, gender=#{gender}
        WHERE name=#{name}
    </update>
    
    <delete id="deleteByName" parameterType="String">
        DELETE FROM admin
        WHERE name=#{deleteName}
    </delete>
    
    <select id="findByName2" parameterType="String" resultType="Map">
        SELECT * FROM admin
        WHERE name=#{selectName}
    </select>
    
    <!-- 如果实体类的属性名和表的字段名不一致，那么不一致的字段将返回null -->
    <select id="findByName3" parameterType="String" resultType="cn.xiangxu.telecom.login.entity.Admin2">
        SELECT * FROM admin
        WHERE name = #{selectName}
    </select>
    
    <!-- 利用sql的别名解决实体类的属性名和标的字段名不一致的问题 -->
    <select id="findByName4" parameterType="String" resultType="cn.xiangxu.telecom.login.entity.Admin2">
        SELECT id, name, password word, gender gender1 FROM admin
        WHERE name = #{selectName}
    </select>
    
    <!-- 使用resultMap元素解决实体类的属性名和标的字段名不一致的问题 -->
    <resultMap type="cn.xiangxu.telecom.login.entity.Admin2" id="admin2Map">
        <result property="word" column="password"></result>
        <result property="gender1" column="gender"></result>
    </resultMap>
    <select id="findByName5" parameterType="String" resultMap="admin2Map">
    <!-- 注意:查询的返回值是cn.xiangxu.telecom.login.entity.Admin2类型 -->
        SELECT * FROM admin
        WHERE name=#{selectName}
    </select>
    
    
    
    
    
</mapper>

本博客源代码地址：点击前往