[TOC]
# 表字段名与实体类属性名不同的解决方案
在实际开发过程中，表中的字段名和表对应实体类的属性名称不一定都是完全相同的。
## 一、创建订单表，并插入数据
~~~
CREATE TABLE orders(
order_id INT PRIMARY KEY AUTO_INCREMENT,
order_no VARCHAR(20),
order_price FLOAT
);
INSERT INTO orders(order_no, order_price) VALUES('aaaa', 23);
INSERT INTO orders(order_no, order_price) VALUES('bbbb', 33);
INSERT INTO orders(order_no, order_price) VALUES('cccc', 22);
~~~
## 二、定义实体类
~~~
package com.ntqingniao.mybatis.entity;
/**
* 定义orders表对应的实体类
*
* @author CUI
*
*/
public class Order {
// Order实体类中属性名和orders表中的字段名是不一样的
private int id; // id===>order_id
private String orderNo; // orderNo===>order_no
private float price; // price===>order_price
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getOrderNo() {
return orderNo;
}
public void setOrderNo(String orderNo) {
this.orderNo = orderNo;
}
public float getPrice() {
return price;
}
public void setPrice(float price) {
this.price = price;
}
@Override
public String toString() {
return "Order [id=" + id + ", orderNo=" + orderNo + ", price=" + price
+ "]";
}
}
~~~
## 三、编写 SQL 的 xml 映射文件
### 1、定义 sql 映射的接口
OrderMapper 接口的代码如下：
~~~
package com.ntqingniao.mybatis.mapping;
import com.ntqingniao.mybatis.entity.Order;
public interface OrderMapper {
/**
* 根据id查询得到一个order对象
*
* @param id
* @return Order
*/
public Order getOrderById(int id);
/**
* 根据id查询得到一个order对象（SQL查询语句采用别名）
*
* @param id
* @return Order
*/
public Order selectOrder(int id);
/**
* 根据id查询得到一个order对象（采用resultMap进行配置）
*
* @param id
* @return Order
*/
public Order selectOrderResultMap(int id);
}
~~~
### 2、创建 orderMapper.xml 文件
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，namespace的值习惯上设置成包名+sql映射文件名，这样就能够保证namespace的值是唯一的
例如namespace="com.ntqingniao.mybatis.mapping.orderMapper"就是com.ntqingniao.mybatis.mapping(包名)+orderMapper(OrderMapper.java文件去除后缀) -->
<mapper namespace="com.ntqingniao.mybatis.mapping.OrderMapper">
<!-- 根据id查询得到一个order对象，使用这个查询是查询不到我们想要的结果的， 这主要是因为实体类的属性名和数据库的字段名对应不上的原因，因此无法查询出对应的记录 -->
<select id="getOrderById" parameterType="int" resultType="com.ntqingniao.mybatis.entity.Order">
select
* from orders where order_id=#{id}
</select>
<!-- 方法一 -->
<!-- 根据id查询得到一个order对象，使用这个查询是可以正常查询到我们想要的结果的， 这是因为我们查询的字段名都起一个和实体类属性名相同的别名，这样实体类的属性名和查询结果中的字段名就可以一一对应上 -->
<select id="selectOrder" parameterType="int" resultType="com.ntqingniao.mybatis.entity.Order">
select
order_id id, order_no orderNo,order_price price from orders where
order_id=#{id}
</select>
<!-- 根据id查询得到一个order对象，使用这个查询是可以正常查询到我们想要的结果的， 这是因为我们通过<resultMap>映射实体类属性名和表的字段名一一对应关系 -->
<select id="selectOrderResultMap" parameterType="int" resultMap="orderResultMap">
select * from orders where order_id=#{id}
</select>
<!-- 方法二 -->
<!--通过<resultMap>映射实体类属性名和表的字段名对应关系 -->
<resultMap type="com.ntqingniao.mybatis.entity.Order" id="orderResultMap">
<!-- 用id属性来映射主键字段 -->
<id property="id" column="order_id" />
<!-- 用result属性来映射非主键字段 -->
<result property="orderNo" column="order_no" />
<result property="price" column="order_price" />
</resultMap>
</mapper>
~~~
### 3、在 conf.xml 文件中添加 orderMapper.xml 映射文件
~~~
<mappers>
<!-- 注册orderMapper.xml文件，
orderMapper.xml位于com.ntqingniao.mybatis.mapping这个包下，所以resource写成com/ntqingniao/mybatis/mapping/orderMapper.xml-->
<mapper resource="com/ntqingniao/mybatis/mapping/orderMapper.xml"/>
</mappers>
~~~
### 4、测试代码
测试类代码如下：
~~~
package com.ntqingniao.mybatis.test;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import com.ntqingniao.mybatis.entity.Order;
import com.ntqingniao.mybatis.entity.User;
import com.ntqingniao.mybatis.mapping.OrderMapper;
import com.ntqingniao.mybatis.mapping.UserMapper;
public class Test1 {
public static void main(String[] args) {
// mybatis的配置文件
String resource = "conf.xml";
// 使用类加载器加载mybatis的配置文件（它也加载关联的映射文件）
InputStream is = Test.class.getClassLoader().getResourceAsStream(
resource);
// 构建sqlSession的工厂
SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder()
.build(is);
// 使用MyBatis提供的Resources类加载mybatis的配置文件（它也加载关联的映射文件）
// Reader reader = Resources.getResourceAsReader(resource);
// 构建sqlSession的工厂
// SqlSessionFactory sessionFactory = new
// SqlSessionFactoryBuilder().build(reader);
// 创建能执行映射文件中sql的sqlSession
SqlSession session = sessionFactory.openSession();
// 通过getMapper()方法获取UserMapper接口
OrderMapper orderMapper = session.getMapper(OrderMapper.class);
Order order = new Order();
// 查询orders表中id为1的记录,执行查询操作，将查询结果自动封装成Order返回
order = orderMapper.getOrderById(1);
// 打印结果：null，也就是没有查询出相应的记录
System.out.println(order);
// 执行查询操作，将查询结果自动封装成Order返回（SQL查询语句采用别名）
order = orderMapper.selectOrder(1);
// 打印结果：Order [id=1, orderNo=aaaa, price=23.0]
System.out.println(order);
// 执行查询操作，将查询结果自动封装成Order返回（采用resultMap进行配置）
order = orderMapper.selectOrderResultMap(1);
// 打印结果：Order [id=1, orderNo=aaaa, price=23.0]
System.out.println(order);
// 使用SqlSession执行完SQL之后需要关闭SqlSession
session.close();
}
}
~~~
> 测试结果：
> 1、getOrderById() 方法执行查询后返回一个 null。
> 2、selectOrder() 方法和 selectOrderResultMap() 方法执行查询后，可以正常得到想要的结果。
## 四、总结
当实体类中的属性名和表中的字段名不一致时，使用 MyBatis 进行查询操作时无法查询出相应的结果的问题以及针对问题采用的两种办法：
> 解决办法一: 通过在查询的 sql 语句中定义字段名的别名，让字段名的别名和实体类的属性名一致，这样就可以表的字段名和实体类的属性名一一对应上了，这种方式是通过在 sql 语句中定义别名来解决字段名和属性名的映射关系的。
>
> 解决办法二: 通过`<resultMap>`来映射字段名和实体类属性名的一一对应关系。这种方式是使用MyBatis提供的解决方式来解决字段名和属性名的映射关系的。
