MyBatis的每個查詢映射的返回類型都是ResultMap,只是當咱們提供的返回類型屬性是resultType的時候,MyBatis對自動的給咱們把對應的值賦給resultType所指定對象的屬性,而當咱們提供的返回類型是resultMap的時候,將數據庫中列數據複製到對象的相應屬性上,能夠用於複製查詢,二者不能同時用。java
resultMap 元素是 MyBatis 中最重要最強大的元素。它就是讓你遠離 90%的須要從結果 集中取出數據的 JDBC 代碼的那個東西, 並且在一些情形下容許你作一些 JDBC 不支持的事 情。 事實上, 編寫類似於對複雜語句聯合映射這些等同的代碼, 也許能夠跨過上千行的代碼。 ResultMap 的設計就是簡單語句不須要明確的結果映射,而不少複雜語句確實須要描述它們 的關係。sql
首先來講一下resultType數據庫
使用resultType進行輸出映射,只有查詢出來的列名和pojo(實體bean)中的屬性名一致,該列才能夠映射成功。mybatis
簡單來講也就是你的數據庫字段和JavaBean裏的字段名稱必須一致才能映射成功。app
因此當咱們JavaBean中的字段名和數據庫字段名稱有不一樣的時候,或者是多表查詢的時候,通常會使用resultMapdom
resultMap是Mybatis最強大的元素,它能夠將查詢到的複雜數據(好比查詢到幾個表中數據)映射到一個結果集當中。ide
屬性 | 描述 |
---|---|
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>
使用具體案例來說述:ui
首先咱們數據庫中的表結構以下:this
能夠看出咱們表字段中有不少字段內有下劃線,而咱們的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 + "]"; } }
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 + "]"; } }
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 + "]"; } }
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 + '}'; } }
首先咱們把配置文件中的駝峯規則關閉
<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); } }
最終測試結果: