簡介:
MyBatis的每一個查詢映射的返回類型都是ResultMap,只是當我們提供的返回類型屬性是resultType的時候,MyBatis對自動的給我們把對應的值賦給resultType所指定對象的屬性,而當我們提供的返回類型是resultMap的時候,將數據庫中列數據復制到對象的相應屬性上,可以用於復制查詢,兩者不能同時用。
resultMap 元素是 MyBatis 中最重要最強大的元素。它就是讓你遠離 90%的需要從結果 集中取出數據的 JDBC 代碼的那個東西, 而且在一些情形下允許你做一些 JDBC 不支持的事 情。 事實上, 編寫相似於對復雜語句聯合映射這些等同的代碼, 也許可以跨過上千行的代碼。 ResultMap 的設計就是簡單語句不需要明確的結果映射,而很多復雜語句確實需要描述它們 的關系。
首先來說一下resultType
使用resultType進行輸出映射,只有查詢出來的列名和pojo(實體bean)中的屬性名一致,該列才可以映射成功。
簡單來說也就是你的數據庫字段和JavaBean里的字段名稱必須一致才能映射成功。
所以當我們JavaBean中的字段名和數據庫字段名稱有不同的時候,或者是多表查詢的時候,一般會使用resultMap
resultMap
resultMap是Mybatis最強大的元素,它可以將查詢到的復雜數據(比如查詢到幾個表中數據)映射到一個結果集當中。
屬性 | 描述 |
---|---|
property | 需要映射到JavaBean 的屬性名稱。 |
column | 數據表的列名或者標簽別名。 |
javaType | 一個完整的類名,或者是一個類型別名。如果你匹配的是一個JavaBean,那MyBatis 通常會自行檢測到。然后,如果你是要映射到一個HashMap,那你需要指定javaType 要達到的目的。 |
jdbcType | 數據表支持的類型列表。這個屬性只在insert,update 或delete 的時候針對允許空的列有用。JDBC 需要這項,但MyBatis 不需要。如果你是直接針對JDBC 編碼,且有允許空的列,而你要指定這項。 |
typeHandler | 使用這個屬性可以覆寫類型處理器。這項值可以是一個完整的類名,也可以是一個類型別名。 |
元素簡介:
<!--column不做限制,可以為任意表的字段,而property須為type 定義的pojo屬性--> <resultMap id="唯一的標識" type="映射的pojo對象"> <id column="表的主鍵字段,或者可以為查詢語句中的別名字段" jdbcType="字段類型" property="映射pojo對象的主鍵屬性" /> <result column="表的一個字段(可以為任意表的一個字段)" jdbcType="字段類型" property="映射到pojo對象的一個屬性(須為type定義的pojo對象中的一個屬性)"/> <association property="pojo的一個對象屬性" javaType="pojo關聯的pojo對象"> <id column="關聯pojo對象對應表的主鍵字段" jdbcType="字段類型" property="關聯pojo對象的主席屬性"/> <result column="任意表的字段" jdbcType="字段類型" property="關聯pojo對象的屬性"/> </association> <!-- 集合中的property須為oftype定義的pojo對象的屬性--> <collection property="pojo的集合屬性" ofType="集合中的pojo對象"> <id column="集合中pojo對象對應的表的主鍵字段" jdbcType="字段類型" property="集合中pojo對象的主鍵屬性" /> <result column="可以為任意表的字段" jdbcType="字段類型" property="集合中的pojo對象的屬性" /> </collection> </resultMap>
使用具體案例來講述:
首先我們數據庫中的表結構如下:
可以看出我們表字段中有很多字段內有下划線,而我們的JavaBean里面的命名是按照駝峰規則命名的,下面我們貼上JavaBean:

package com.zy.domain; import java.util.Date; public class User { private Long id; // 用戶名 private String userName; // 密碼 private String password; // 姓名 private String name; // 年齡 private Integer age; // 性別,1男性,2女性 private Integer sex; // 出生日期 private Date birthday; // 創建時間 private Date created; // 更新時間 private Date updated; public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getuserName() { return userName; } public void setuserName(String userName) { this.userName = userName; } public String getPassword() { return password; } public void setPassword(String password) { this.password = password; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } public Integer getSex() { return sex; } public void setSex(Integer sex) { this.sex = sex; } public Date getBirthday() { return birthday; } public void setBirthday(Date birthday) { this.birthday = birthday; } public Date getCreated() { return created; } public void setCreated(Date created) { this.created = created; } public Date getUpdated() { return updated; } public void setUpdated(Date updated) { this.updated = updated; } @Override public String toString() { return "User [id=" + id + ", userName=" + userName + ", password=" + password + ", name=" + name + ", age=" + age + ", sex=" + sex + ", birthday=" + birthday + ", created=" + created + ", updated=" + updated + "]"; } } User JavaBean

package com.zy.domain; import java.util.List; /** * 訂單表 * */ public class Order { private Integer oid; private Long userId; private String orderNumber; private User user; private List<Orderitem> orderitemList; public List<Orderitem> getOrderitemList() { return orderitemList; } public void setOrderitemList(List<Orderitem> orderitemList) { this.orderitemList = orderitemList; } public User getUser() { return user; } public void setUser(User user) { this.user = user; } public Integer getOid() { return oid; } public void setOid(Integer oid) { this.oid = oid; } public Long getUserId() { return userId; } public void setUserId(Long userId) { this.userId = userId; } public String getOrderNumber() { return orderNumber; } public void setOrderNumber(String orderNumber) { this.orderNumber = orderNumber; } @Override public String toString() { return "Order [oid=" + oid + ", userId=" + userId + ", orderNumber=" + orderNumber + ", user=" + user + ", orderitemList=" + orderitemList + "]"; } } Order JavaBean

package com.zy.domain; /** * 商品表 */ public class Product { private Integer pid; private String pname; private Float price; private String description; public Integer getPid() { return pid; } public void setPid(Integer pid) { this.pid = pid; } public String getPname() { return pname; } public void setPname(String pname) { this.pname = pname; } public Float getPrice() { return price; } public void setPrice(Float price) { this.price = price; } public String getDescription() { return description; } public void setDescription(String description) { this.description = description; } @Override public String toString() { return "Product [pid=" + pid + ", pname=" + pname + ", price=" + price + ", description=" + description + "]"; } } Product JavaBean

package com.zy.domain; public class Orderitem { private Integer itemId; private int orderId; private int productId; private Double totalPrice; private Integer status; private Product product; public Double getTotalPrice() { return totalPrice; } public void setTotalPrice(Double totalPrice) { this.totalPrice = totalPrice; } public Integer getStatus() { return status; } public void setStatus(Integer status) { this.status = status; } public Product getProduct() { return product; } public void setProduct(Product product) { this.product = product; } public Integer getItemId() { return itemId; } public void setItemId(Integer itemId) { this.itemId = itemId; } public int getOrderId() { return orderId; } public void setOrderId(int orderId) { this.orderId = orderId; } public int getProductId() { return productId; } public void setProductId(int productId) { this.productId = productId; } @Override public String toString() { return "Orderitem{" + "itemId=" + itemId + ", orderId=" + orderId + ", productId=" + productId + ", totalPrice=" + totalPrice + ", status=" + status + ", product=" + product + '}'; } } Orderitem JavaBean
首先我們把配置文件中的駝峰規則關閉
<settings> <setting name="mapUnderscoreToCamelCase" value="false"/> </settings>
單表查詢(查詢所有訂單信息):
OrderMapper.xml
<mapper namespace="com.zy.mapper.OrderMapper"> <resultMap id="OrderResultMap" type="com.zy.domain.Order"> <id column="oid" property="oid"></id> <result column="user_id" property="userId"></result> <result column="order_number" property="orderNumber"></result> </resultMap> <!--查詢訂單表信息--> <select id="getOrderList" resultMap="OrderResultMap"> select * from tb_order </select> </mapper>
OrderMapper接口
public interface OrderMapper { public List<Order> getOrderList(); }
測試:
public class OrderMapperTest { OrderMapper mapper; @org.junit.Before public void setUp() throws Exception { InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml"); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); SqlSession sqlSession = sqlSessionFactory.openSession(true); mapper = sqlSession.getMapper(OrderMapper.class); } @org.junit.Test public void getOrderList() throws Exception { List<Order> list = mapper.getOrderList(); for (Order order : list) { System.out.println(order); } } }
運行結果:
一對一多表查詢(根據訂單編號查詢訂單信息並帶出訂單所屬用戶信息):
這里引出了association聯合:
聯合元素用來處理“一對一”的關系。需要指定映射的Java實體類的屬性,屬性的javaType(通常MyBatis 自己會識別)。
OrderMapper.xml
<mapper namespace="com.zy.mapper.OrderMapper"> <resultMap id="OrderResultMap" type="com.zy.domain.Order"> <id column="oid" property="oid"></id> <result column="user_id" property="userId"></result> <result column="order_number" property="orderNumber"></result> </resultMap> <!--查詢訂單表信息--> <select id="getOrderList" resultMap="OrderResultMap"> select * from tb_order </select> <!--extends 表示繼承 autoMapping表示自動映射JavaBean中字段和數據表字段一致的字段信息--> <resultMap id="OrderWithUserResultMap" type="com.zy.domain.Order" extends="OrderResultMap"> <!--由於繼承了OrderResultMap 所以這里就不用再寫order表的信息了--> <!--用戶表信息--> <association property="user" javaType="com.zy.domain.User" autoMapping="true"> <id column="user_id" property="id"></id> <result column="user_name" property="userName"></result> </association> </resultMap> <!--根據訂單編號查詢訂單信息並帶出訂單所屬用戶信息--> <select id="getOrderWithUser" resultMap="OrderWithUserResultMap"> select * from tb_order as o left join tb_user as u on o.user_id=u.id where o.order_number=#{ordernumber} </select> </mapper>
OrderMapper接口:
public interface OrderMapper { /** * 獲取所有訂單列表 */ public List<Order> getOrderList(); /** * 根據訂單編號 獲取單個訂單及所屬用戶信息 */ public Order getOrderWithUser(@Param("ordernumber") String orderNumber); }
測試:
public class OrderMapperTest { OrderMapper mapper; @Before public void setUp() throws Exception { InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml"); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); SqlSession sqlSession = sqlSessionFactory.openSession(true); mapper = sqlSession.getMapper(OrderMapper.class); } @Test public void getOrderList() throws Exception { List<Order> list = mapper.getOrderList(); for (Order order : list) { System.out.println(order); } } @Test public void getOrderWithUser() throws Exception { Order order = mapper.getOrderWithUser("20140921002"); System.out.println(order); } }
一對多多表查詢(根據訂單號 查詢訂單,並且查詢出所有訂單詳情(子訂單)及所屬用戶):
由於是一對多,所以這里就引出了collection聚集:
聚集元素用來處理“一對多”的關系。需要指定映射的Java實體類的屬性,屬性的javaType(一般為ArrayList);列表中對象的類型ofType(Java實體類)。
OrderMapper.xml
<mapper namespace="com.zy.mapper.OrderMapper"> <resultMap id="OrderResultMap" type="com.zy.domain.Order"> <id column="oid" property="oid"></id> <result column="user_id" property="userId"></result> <result column="order_number" property="orderNumber"></result> </resultMap> <!--查詢訂單表信息--> <select id="getOrderList" resultMap="OrderResultMap"> select * from tb_order </select> <!--extends 表示繼承--> <resultMap id="OrderWithUserResultMap" type="com.zy.domain.Order" extends="OrderResultMap"> <!--由於繼承了OrderResultMap 所以這里就不用再寫order表的信息了--> <!--用戶表信息--> <association property="user" javaType="com.zy.domain.User" autoMapping="true"> <id column="user_id" property="id"></id> <result column="user_name" property="userName"></result> </association> </resultMap> <!--根據訂單編號查詢訂單信息並帶出訂單所屬用戶信息--> <select id="getOrderWithUser" resultMap="OrderWithUserResultMap"> select * from tb_order as o left join tb_user as u on o.user_id=u.id where o.order_number=#{ordernumber} </select> <resultMap id="OrderWithItemAndUserResultMap" type="com.zy.domain.Order" extends="OrderWithUserResultMap"> <!--javaType為list list代表List類型 ofType為Orderitem--> <collection property="orderitemList" javaType="list" ofType="com.zy.domain.Orderitem" autoMapping="true"> <id column="item_id" property="itemId"></id> <result column="order_id" property="orderId"></result> <result column="product_id" property="productId"></result> <result column="total_price" property="totalPrice"></result> </collection> </resultMap> <!--根據訂單號 查詢訂單,並且查詢出所有訂單詳情(子訂單)及所屬用戶--> <select id="getOrderWithItenAndUser" resultMap="OrderWithItemAndUserResultMap"> select * from tb_order o left join tb_user u on o.user_id=u.id left join tb_orderitem oi on o.oid=oi.order_id where o.order_number=#{ordernumber} </select> </mapper>
OrderMapper接口:
public interface OrderMapper { /** * 獲取所有訂單列表 */ public List<Order> getOrderList(); /** * 根據訂單編號 獲取單個訂單及所屬用戶信息 */ public Order getOrderWithUser(@Param("ordernumber") String orderNumber); /** * 根據訂單號 查詢訂單,並且查詢出所有訂單詳情(子訂單)及所屬用戶 */ public Order getOrderWithItenAndUser(@Param("ordernumber") String orderNumber); }
測試:
public class OrderMapperTest { OrderMapper mapper; @Before public void setUp() throws Exception { InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml"); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); SqlSession sqlSession = sqlSessionFactory.openSession(true); mapper = sqlSession.getMapper(OrderMapper.class); } @Test public void getOrderList() throws Exception { List<Order> list = mapper.getOrderList(); for (Order order : list) { System.out.println(order); } } @Test public void getOrderWithUser() throws Exception { Order order = mapper.getOrderWithUser("20140921002"); System.out.println(order); } @Test public void getOrderWithItenAndUser() throws Exception { Order order = mapper.getOrderWithItenAndUser("20140921001"); System.out.println(order); } }
多對多 多表查詢(根據訂單號 查詢訂單,查詢出所屬用戶,並且查詢出訂單的詳情,及訂單詳情中的對應的商品信息 訂單詳情和商品為多對多關系):
這一次我們開啟駝峰規則,可以少寫一些符合規則的字段:
<settings> <setting name="mapUnderscoreToCamelCase" value="true"/> </settings>
OrderMapper.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="com.zy.mapper.OrderMapper"> <resultMap id="OrderFullInfoResultMap" type="com.zy.domain.Order" autoMapping="true"> <!--order表主鍵--> <id column="oid" property="oid"></id> <!--關聯用戶表--> <association property="user" javaType="com.zy.domain.User" autoMapping="true"> <!--用戶表主鍵--> <id column="user_id" property="id"></id> </association> <!--關聯訂單詳情表--> <collection property="orderitemList" javaType="list" ofType="com.zy.domain.Orderitem" autoMapping="true"> <!--訂單詳情表主鍵--> <id column="item_id" property="itemId"></id> <!--關聯商品--> <association property="product" javaType="com.zy.domain.Product" autoMapping="true"> <!--商品表主鍵--> <id column="product_id" property="pid"></id> </association> </collection> </resultMap> <!--根據訂單號 查詢訂單,查詢出所屬用戶,並且查詢出訂單的詳情,及訂單詳情中的對應的商品信息--> <select id="getOrderFullInfo" resultMap="OrderFullInfoResultMap"> select * from tb_order o left join tb_user u on o.user_id=u.id left join tb_orderitem oi on o.oid=oi.order_id left join tb_product p on oi.product_id=p.pid where o.order_number=#{ordernumber} </select> </mapper>
OrderMapper接口:
public interface OrderMapper { /** * 根據訂單號 查詢訂單,查詢出所屬用戶,並且查詢出訂單的詳情,及訂單詳情中的對應的商品信息 */ public Order getOrderFullInfo(@Param("ordernumber") String orderNumber); }
測試:
public class OrderMapperTest { OrderMapper mapper; @Before public void setUp() throws Exception { InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml"); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); SqlSession sqlSession = sqlSessionFactory.openSession(true); mapper = sqlSession.getMapper(OrderMapper.class); } @Test public void getOrderFullInfo() throws Exception{ Order order = mapper.getOrderFullInfo("20140921001"); System.out.println(order); } }
最終測試結果: