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> 

配置好的SqlMapConfig.xml

　　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 + "]";
     }

 }

实体类Admin.java

　　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);
 }

编写好的AdminDao.java接口

　　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>

配置好的AdminMapper.xml

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