1. 技术文章
  2. TangYuan之数据映射

TangYuan之数据映射

由 ￡可爱￡侵袭症＋ 提交于 2019-12-10 23:13:02

【推荐】2019 Java 开发者跳槽指南.pdf(吐血整理) >>>

7. 数据映射

7.1 数据类型映射

数据类型映射指的是数据库中的数据类型和Java数据类型之间的映射关系：比如：默认情况下，Mysql中的int类型对应Java中的int(Integer)类型，bigint对应Java中的BigInteger，decimal对应Java中的bigDecimal等等，这些都是Tangyuan框架提供的默认映射关系，但如果我们希望数据库中的bigint能映射成Java中的long类型，或者decimal映射成Java中的double类型，该如何处理呢？我们可以通过下面的配置来实现我们的目的：

示例：

<!-- 数据类型映射 -->
<dataTypeMapping>
	<relation jdbcType="tinyint" 	javaType="int" />
	<relation jdbcType="bigint" 	javaType="long" />
	<relation jdbcType="double" 	javaType="float" />
	<relation jdbcType="real" 		javaType="float" />
	<relation jdbcType="decimal" 	javaType="float" />
	<relation jdbcType="numeric" 	javaType="float" />
</dataTypeMapping>

说明：

该配置位于tangyuan-mapper.xml文件中，通过上述配置，我们就可以实现数据库中的数据类型到Java数据类型的自定义映射关系了。当然这种自定义映射关系也不是可以随便指定，需要遵循一定的规则:

  • 整数类型映射整数类型，浮点类型映射浮点类型，比如：tinyint(DB)->int(Java)；
  • 小类型到大类型的映射是安全的.比如:tinyint(DB)->int(Java)；大类型到小类型的映射是不安全的，需要用户自行确定是否超出范围，比如:bigint(DB)->long(Java)。

Schema设计图：

relation节点属性说明：

属性名 用途及说明 必填 取值
jdbcType 数据库中的数据类型 Y bit<br />boolean<br />tinyint<br />smallint<br />bigint<br />int<br />real<br />decimal<br />numeric<br />float<br />double
javaType Java中的数据类型 Y byte<br />boolean<br />short<br />int<br />long<br />float<br />double<br />bigInteger<br />bigDecimal

7.2 返回结果映射

返回结果映射指对SQL服务执行成功后的返回数据进行处理，转换成调用方所希望的类型或者名称。比如：<selectOne>标签执行后得到的是一条行记录，调用方拿到的返回结果默认是一个XCO对象，如果调用方希望得到的是一个Map对象，当然可以，甚至按照面向对象的习惯，我们查询user表，最后能否得到一个Java中的User对象呢，这当然也是可以的，这些都是通过数据映射来实现的，下面来详细的介绍一下。

首先返回结果映射的配置分为两部分，一部分是定义的配置，通过tangyuan-mapper.xml文件中resultMap标签和mappingClass标签来定义；另一部分是使用的配置，通过SQL服务标签的resultType属性和resultMap属性来使用。示例如下：

首先，我们需要做一些准备工作，定义一张user表，3个JavaBean对象（用于演示结果映射不同使用）来承载user表的中数据和一个自定义的列到属性处理器。

user表定义：

CREATE TABLE `user` (
  `user_id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT 'ID',
  `user_name` varchar(50) NOT NULL DEFAULT '' COMMENT '姓名',
  `user_age` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '年龄',
  `create_time` datetime NOT NULL COMMENT '创建时间',
  PRIMARY KEY (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='用户表';

Bean对象:

public class User1 {

	private Long	user_id;
	private String	user_name;
	private Integer	user_age;
	private Date	create_time;
	
	//set, get
}
	
public class User2 {

	private Long	id;
	private String	name;
	private Integer	age;
	private Date	time;
	
	//set, get
}

public class User3 {

	private Long	user_id;
	private String	user_name;
	private Integer	age;
	private Date	time;
	
	//set, get
}

自定义列到属性转换处理器：

public class User2Mapper implements MappingHandler{
	
	@Override
	public String columnToProperty(String arg0) {
		return arg0.substring(arg0.lastIndexOf("_") + 1);
	}
}

示例1：

<selectOne id="getUserToMap" resultType="map" dsKey="ds" txRef="tx_01">
	select * from user where user_id = 1
</selectOne>

返回结果：

class java.util.HashMap
{user_name=张三, create_time=Sun Nov 20 10:58:04 CST 2016, user_id=1, user_age=18}

说明：

示例1中，<selectOne>标签的resultType属性值为map，表示其返回结果的载体类型为Map。

示例2：

<selectOne id="getUserToBean" resultType="org.xson.tangyuan.vo.User1" dsKey="ds" txRef="tx_01">
	select * from user where user_id = 1
</selectOne>

返回结果(使用JSON序列化后的)：

class org.xson.tangyuan.vo.User1
{"create_time":1479610684000,"user_age":18,"user_id":1,"user_name":"张三"}

说明：

示例2中，<selectOne>标签的resultType属性值为org.xson.tangyuan.vo.User1，表示其返回结果的载体类型为一个具体JavaBean类型。

示例3：

tangyuan-mapper.xml文件中：

<resultMap id="userResult1" type="org.xson.tangyuan.vo.User2">
	<result column="user_id" 		property="id"/>
	<result column="user_name" 	property="name"/>
	<result column="user_age" 		property="age"/>
	<result column="create_time" 	property="time"/>
</resultMap>

SQL服务的XML中：

<selectOne id="getUser1" resultMap="userResult1" dsKey="ds" txRef="tx_01">
	select * from user where user_id = 1
</selectOne>

返回结果(使用JSON序列化后的)：

class org.xson.tangyuan.vo.User2
{"age":18,"id":1,"name":"张三","time":1479610684000}

说明：

示例3中，首先在tangyuan-mapper.xml文件中配置了一个返回结果的映射规则userResult1，其载体类型为User2对象，user表中列和User2对象中属性的对于关系则依照<result>中的配置。然后在<selectOne>标签中通过resultMap属性来进行使用。

示例4：

tangyuan-mapper.xml文件中：

<mappingClass id="user2Mapper" class="org.xson.tangyuan.mapper.User2Mapper"/>

<resultMap id="userResult2" type="org.xson.tangyuan.vo.User2" rule="user2Mapper" />

SQL服务的XML中：

<selectOne id="getUser2" resultMap="userResult2" dsKey="ds" txRef="tx_01">
	select * from user where user_id = 1
</selectOne>

返回结果(使用JSON序列化后的)：

class org.xson.tangyuan.vo.User2
{"age":18,"id":1,"name":"张三","time":1479610684000}

说明：

示例4中，先配置一个自定义的列到属性的处理器user2Mapper（需要实现org.xson.tangyuan.mapping.MappingHandler接口），然后在tangyuan-mapper.xml文件中配置一个返回结果的映射规则userResult2，其载体类型为User2对象，使用user2Mapper来处理数据库列到User2中属性的映射关系。最后在<selectOne>标签中通过resultMap属性来进行使用。

示例5：

tangyuan-mapper.xml文件中：

<resultMap id="userResult3" type="*" rule="user2Mapper" />

SQL服务的XML中：

<selectOne id="getUser3" resultType="org.xson.tangyuan.vo.User2" resultMap="userResult3" dsKey="ds" txRef="tx_01">
	select * from user where user_id = 1
</selectOne>

返回结果(使用JSON序列化后的)：

class org.xson.tangyuan.vo.User2
{"age":18,"id":1,"name":"张三","time":1479610684000}

说明：

示例5中，在tangyuan-mapper.xml文件中配置一个返回结果的映射规则userResult3，type="*"表示返回结果的载体将为SQL服务标签中resultType属性所设置的具体载体对象，同时使用user2Mapper来处理数据库列到具体对象中属性的映射关系。最后在<selectOne>标签中通过resultMap属性设置返回结果的映射规则，通过resultType属性来设置返回结果的载体为User2对象。

示例6： tangyuan-mapper.xml文件中：

<resultMap id="userResult4" type="org.xson.tangyuan.vo.User3">
	<result column="user_age" 		property="age"/>
	<result column="create_time" 	property="time"/>
</resultMap>

SQL服务的XML中：

<selectOne id="getUser4" resultMap="userResult4" dsKey="ds" txRef="tx_01">
	select * from user where user_id = 1
</selectOne>

返回结果(使用JSON序列化后的)：

class org.xson.tangyuan.vo.User3
{"age":18,"time":1479610684000,"user_id":1,"user_name":"张三"}

说明：

示例6和示例3相似，区别在于user_id，和user_name由于没有配置列到属性的映射关系，则按照数据库列的名称直接映射到User3的属性中。

使用限制和说明：

返回结果的映射功能只能在<selectSet>，<selectOne>服务标签中，通过resultMap使用；并且<selectSet>，<selectOne>必须为简单服务时才有效，在组合服务中设置无效。

Schema设计图：

resultMap节点属性说明：

属性名 用途及说明 必填 取值
id 返回结果映射规则的唯一标识，不能重复 Y 用户定义
type 返回结果载体对象类型 N 用户定义
rule 所引用的列到属性处理器实现类id N 用户定义

Schema设计图：

mappingClass节点属性说明：

属性名 用途及说明 必填 取值
id 列到属性处理器的唯一标识，不能重复 Y 用户定义
class 列到属性处理器全类名，需要实现org.xson.tangyuan.mapping.MappingHandler接口 Y 用户定义

到此，本章节的内容就结束了，感兴趣的朋友可以关注TangYuan项目。

标签
tangyuan
mapper
易学教程内所有资源均来自网络或用户发布的内容，如有违反法律规定的内容欢迎反馈！
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!