Mybatis系列(二):优化MyBatis配置文件中的配置和解决字段名与实体类属性名不相同的冲突
原文链接:http://www.cnblogs.com/xdp-gacl/p/4264301.html http://www.cnblogs.com/xdp-gacl/p/4264425.html
一、优化MyBatis配置文件中的配置
1、连接数据库的配置单独放在一个properties文件中
之前,我们是直接将数据库的连接配置信息写在了MyBatis的主配置文件conf.xml文件中,如下:
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> 3 <configuration> 4 <environments default="development"> 5 <environment id="development"> 6 <transactionManager type="JDBC" /> 7 <!-- 配置数据库连接信息 --> 8 <dataSource type="POOLED"> 9 <property name="driver" value="com.mysql.jdbc.Driver" /> 10 <property name="url" value="jdbc:mysql://localhost:3306/mybatis" /> 11 <property name="username" value="root" /> 12 <property name="password" value="XDP" /> 13 </dataSource> 14 </environment> 15 </environments> 16 17 </configuration>
其实我们完全可以将数据库的连接配置信息写在一个properties文件中,然后在conf.xml文件中引用properties文件,具体做法如下:
1、在src目录下新建一个db.properties文件,如下图所示:
在db.properties文件编写连接数据库需要使用到的数据库驱动,连接URL地址,用户名,密码,如下:
1 driver=com.mysql.jdbc.Driver 2 url=jdbc:mysql://localhost:3306/mybatis 3 name=root 4 password=XDP
2、在MyBatis的主配置文件conf.xml文件中引用db.properties文件,如下:
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> 3 <configuration> 4 5 <!-- 引用db.properties配置文件 --> 6 <properties resource="db.properties"/> 7 <!-- 8 development : 开发模式 9 work : 工作模式 10 --> 11 <environments default="development"> 12 <environment id="development"> 13 <transactionManager type="JDBC" /> 14 <!-- 配置数据库连接信息 --> 15 <dataSource type="POOLED"> 16 <!-- value属性值引用db.properties配置文件中配置的值 --> 17 <property name="driver" value="${driver}" /> 18 <property name="url" value="${url}" /> 19 <property name="username" value="${name}" /> 20 <property name="password" value="${password}" /> 21 </dataSource> 22 </environment> 23 </environments> 24 25 </configuration>
2、为实体类定义别名,简化sql映射xml文件中的引用
之前,我们在sql映射xml文件中的引用实体类时,需要写上实体类的全类名(包名+类名),如下:
<!-- 创建用户(Create) --> <insert id="addUser" parameterType="me.gacl.domain.User"> insert into users(name,age) values(#{name},#{age}) </insert>
parameterType="me.gacl.domain.User"这里写的实体类User的全类名me.gacl.domain.User,每次都写这么一长串内容挺麻烦的,而我们希望能够简写成下面的形式
<insert id="addUser2" parameterType="_User"> insert into users(name,age) values(#{name},#{age}) </insert>
parameterType="_User"这样写就简单多了,为了达到这种效果,我们需要在conf.xml文件中为实体类="me.gacl.domain.User"定义一个别名为"_User",具体做法如下:
在conf.xml文件中<configuration></configuration>标签中添加如下配置:
<typeAliases> <typeAlias type="me.gacl.domain.User" alias="_User"/> </typeAliases>
这样就可以为me.gacl.domain.User类定义了一个别名为_User,以后_User就代表了me.gacl.domain.User类,这样sql映射xml文件中的凡是需要引用me.gacl.domain.User类的地方都可以使用_User来代替,这就达到了一个简化实体类引用的目的。
除了可以使用<typeAlias type="me.gacl.domain.User" alias="_User"/>这种方式单独为某一个实体类设置别名之外,我们还可以使用如下的方式批量为某个包下的所有实体类设置别名,如下:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <!-- 引用db.properties配置文件 --> <properties resource="db.properties"/> <!-- development : 开发模式 work : 工作模式 --> <environments default="development"> <environment id="development"> <transactionManager type="JDBC" /> <!-- 配置数据库连接信息 --> <dataSource type="POOLED"> <!-- value属性值引用db.properties配置文件中配置的值 --> <property name="driver" value="${driver}" /> <property name="url" value="${url}" /> <property name="username" value="${name}" /> <property name="password" value="${password}" /> </dataSource> </environment> </environments> <!-- 配置实体类的别名,配置实体类别名的目的是为了在引用实体类时可以使用实体类的别名来代替实体类,达到简写的目的 --> <typeAliases> <!-- 为实体类me.gacl.domain.User配置一个别名_User --> <!-- <typeAlias type="me.gacl.domain.User" alias="_User"/> --> <!-- 为me.gacl.domain包下的所有实体类配置别名,MyBatis默认的设置别名的方式就是去除类所在的包后的简单的类名 比如me.gacl.domain.User这个实体类的别名就会被设置成User --> <package name="me.gacl.domain"/> </typeAliases> </configuration>
<package name="me.gacl.domain"/>就表示为这个包下面的所有实体类设置别名。MyBatis默认的设置别名的方式就是去除类所在的包后的简单的类名,比如me.gacl.domain.User这个实体类的别名就会被设置成User。
二、解决字段名与实体类属性名不相同的冲突
在平时的开发中,我们表中的字段名和表对应实体类的属性名称不一定都是完全相同的,下面来演示一下这种情况下的如何解决字段名与实体类属性名不相同的冲突。
1、准备演示需要使用的表和数据
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);
2、定义实体类
1 package me.gacl.domain; 2 3 /** 4 * @author gacl 5 * 定义orders表对应的实体类 6 */ 7 public class Order { 8 /** 9 * 10 CREATE TABLE orders( 11 order_id INT PRIMARY KEY AUTO_INCREMENT, 12 order_no VARCHAR(20), 13 order_price FLOAT 14 ); 15 */ 16 17 //Order实体类中属性名和orders表中的字段名是不一样的 18 private int id; //id===>order_id 19 private String orderNo; //orderNo===>order_no 20 private float price; //price===>order_price 21 22 public int getId() { 23 return id; 24 } 25 26 public void setId(int id) { 27 this.id = id; 28 } 29 30 public String getOrderNo() { 31 return orderNo; 32 } 33 34 public void setOrderNo(String orderNo) { 35 this.orderNo = orderNo; 36 } 37 38 public float getPrice() { 39 return price; 40 } 41 42 public void setPrice(float price) { 43 this.price = price; 44 } 45 46 @Override 47 public String toString() { 48 return "Order [id=" + id + ", orderNo=" + orderNo + ", price=" + price+ "]"; 49 } 50 }
3、编写测试代码
3.1、编写SQL的xml映射文件
1、创建一个orderMapper.xml文件,orderMapper.xml的内容如下:
1 <?xml version="1.0" encoding="UTF-8" ?> 2 <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 3 <!-- 为这个mapper指定一个唯一的namespace,namespace的值习惯上设置成包名+sql映射文件名,这样就能够保证namespace的值是唯一的 4 例如namespace="me.gacl.mapping.orderMapper"就是me.gacl.mapping(包名)+orderMapper(orderMapper.xml文件去除后缀) 5 --> 6 <mapper namespace="me.gacl.mapping.orderMapper"> 7 8 <!-- 9 根据id查询得到一个order对象,使用这个查询是查询不到我们想要的结果的, 10 这主要是因为实体类的属性名和数据库的字段名对应不上的原因,因此无法查询出对应的记录 11 --> 12 <select id="getOrderById" parameterType="int" 13 resultType="me.gacl.domain.Order"> 14 select * from orders where order_id=#{id} 15 </select> 16 17 <!-- 18 根据id查询得到一个order对象,使用这个查询是可以正常查询到我们想要的结果的, 19 这是因为我们将查询的字段名都起一个和实体类属性名相同的别名,这样实体类的属性名和查询结果中的字段名就可以一一对应上 20 --> 21 <select id="selectOrder" parameterType="int" 22 resultType="me.gacl.domain.Order"> 23 select order_id id, order_no orderNo,order_price price from orders where order_id=#{id} 24 </select> 25 26 <!-- 27 根据id查询得到一个order对象,使用这个查询是可以正常查询到我们想要的结果的, 28 这是因为我们通过<resultMap>映射实体类属性名和表的字段名一一对应关系 --> 29 <select id="selectOrderResultMap" parameterType="int" resultMap="orderResultMap"> 30 select * from orders where order_id=#{id} 31 </select> 32 <!--通过<resultMap>映射实体类属性名和表的字段名对应关系 --> 33 <resultMap type="me.gacl.domain.Order" id="orderResultMap"> 34 <!-- 用id属性来映射主键字段 --> 35 <id property="id" column="order_id"/> 36 <!-- 用result属性来映射非主键字段 --> 37 <result property="orderNo" column="order_no"/> 38 <result property="price" column="order_price"/> 39 </resultMap> 40 41 </mapper>
2、在conf.xml文件中注册orderMapper.xml映射文件
1 <mappers> 2 <!-- 注册orderMapper.xml文件, 3 orderMapper.xml位于me.gacl.mapping这个包下,所以resource写成me/gacl/mapping/orderMapper.xml--> 4 <mapper resource="me/gacl/mapping/orderMapper.xml"/> 5 </mappers>
3.2、编写单元测试代码
1 package me.gacl.test; 2 3 import me.gacl.domain.Order; 4 import me.gacl.util.MyBatisUtil; 5 import org.apache.ibatis.session.SqlSession; 6 import org.junit.Test; 7 8 public class Test2 { 9 10 @Test 11 public void testGetOrderById(){ 12 SqlSession sqlSession = MyBatisUtil.getSqlSession(); 13 /** 14 * 映射sql的标识字符串, 15 * me.gacl.mapping.orderMapper是orderMapper.xml文件中mapper标签的namespace属性的值, 16 * getOrderById是select标签的id属性值,通过select标签的id属性值就可以找到要执行的SQL 17 */ 18 String statement = "me.gacl.mapping.orderMapper.getOrderById";//映射sql的标识字符串 19 //执行查询操作,将查询结果自动封装成Order对象返回 20 Order order = sqlSession.selectOne(statement,1);//查询orders表中id为1的记录 21 //使用SqlSession执行完SQL之后需要关闭SqlSession 22 sqlSession.close(); 23 System.out.println(order);//打印结果:null,也就是没有查询出相应的记录 24 } 25 26 @Test 27 public void testGetOrderById2(){ 28 SqlSession sqlSession = MyBatisUtil.getSqlSession(); 29 /** 30 * 映射sql的标识字符串, 31 * me.gacl.mapping.orderMapper是orderMapper.xml文件中mapper标签的namespace属性的值, 32 * selectOrder是select标签的id属性值,通过select标签的id属性值就可以找到要执行的SQL 33 */ 34 String statement = "me.gacl.mapping.orderMapper.selectOrder";//映射sql的标识字符串 35 //执行查询操作,将查询结果自动封装成Order对象返回 36 Order order = sqlSession.selectOne(statement,1);//查询orders表中id为1的记录 37 //使用SqlSession执行完SQL之后需要关闭SqlSession 38 sqlSession.close(); 39 System.out.println(order);//打印结果:Order [id=1, orderNo=aaaa, price=23.0] 40 } 41 42 @Test 43 public void testGetOrderById3(){ 44 SqlSession sqlSession = MyBatisUtil.getSqlSession(); 45 /** 46 * 映射sql的标识字符串, 47 * me.gacl.mapping.orderMapper是orderMapper.xml文件中mapper标签的namespace属性的值, 48 * selectOrderResultMap是select标签的id属性值,通过select标签的id属性值就可以找到要执行的SQL 49 */ 50 String statement = "me.gacl.mapping.orderMapper.selectOrderResultMap";//映射sql的标识字符串 51 //执行查询操作,将查询结果自动封装成Order对象返回 52 Order order = sqlSession.selectOne(statement,1);//查询orders表中id为1的记录 53 //使用SqlSession执行完SQL之后需要关闭SqlSession 54 sqlSession.close(); 55 System.out.println(order);//打印结果:Order [id=1, orderNo=aaaa, price=23.0] 56 } 57 }
执行单元测试的结果:
1、testGetOrderById方法执行查询后返回一个null。
2、testGetOrderById2方法和testGetOrderById3方法执行查询后可以正常得到想要的结果。
4、总结
上面的测试代码演示当实体类中的属性名和表中的字段名不一致时,使用MyBatis进行查询操作时无法查询出相应的结果的问题以及针对问题采用的两种办法:
解决办法一: 通过在查询的sql语句中定义字段名的别名,让字段名的别名和实体类的属性名一致,这样就可以表的字段名和实体类的属性名一一对应上了,这种方式是通过在sql语句中定义别名来解决字段名和属性名的映射关系的。
解决办法二: 通过<resultMap>来映射字段名和实体类属性名的一一对应关系。这种方式是使用MyBatis提供的解决方式来解决字段名和属性名的映射关系的。