Mybatis 处理列名—字段名映射(一) :驼峰式命名映射

我们需要分析Mybatis在转换Result到需要的Java业务对象时做的三件事,如下:

[JDBC] 处理ResultSet,构建Java对象

https://my.oschina.net/kailuncen/blog/906992

解决了数据库列名到Java列名的映射。

解决了数据库类型到Java类型的转换工作。

在转换过程中具备一定的容错能力。

其实核心就是:

数据库中的列名怎么和对象中的字段对应起来。

数据库中的列的类型怎么转换到合适的Java类型,不引起转换失败。

今天我们先来看第一点,数据库中的列名怎么和对象中的字段对应起来。首先是日常PO(Persistant Object) CityPO,里面有五个字段。

public class CityPO {

Integer id;

Long cityId;

String cityName;

String cityEnName;

String cityPyName;

本次要查询的数据库中的列名如下所示。

mysql> mysql> desc SU_City;

+--------------+-------------+------+-----+-------------------+-----------------------------+

| Field        | Type        | Null | Key | Default           | Extra                       |

+--------------+-------------+------+-----+-------------------+-----------------------------+

| id           | int(11)     | NO   | PRI | NULL              | auto_increment              |

| city_id      | int(11)     | NO   | UNI | NULL              |                             |

| city_name    | varchar(20) | NO   |     |                   |                             |

| city_en_name | varchar(20) | NO   |     |                   |                             |

| city_py_name | varchar(50) | NO   |     |                   |                             |

| create_time  | datetime    | NO   |     | CURRENT_TIMESTAMP |                             |

| updatetime   | datetime    | NO   | MUL | CURRENT_TIMESTAMP | on update CURRENT_TIMESTAMP |

+--------------+-------------+------+-----+-------------------+-----------------------------+

7 rows in set (0.01 sec)

我们是按照驼峰式命名,把数据库中的列名对应到了对象的字段名。如下是Mybatis的接口类和映射文件。

public interface CityMapper {

CityPO selectCity(int id);

}


PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"

"http://mybatis.org/dtd/mybatis-3-mapper.dtd">

select id,city_id,city_name,city_en_name from SU_City where id = #{id}

在上面的映射文件中,namespace指定了这个接口类的全限定类名,紧随其后的select代表是select语句,id是接口类中函数的名字,resultType代表了从这条语句中返回的期望类型的类的完全限定名或别名,在此例子中是我们的业务对象CityPO的类路径。

主要有三种方案

驼峰式命名开关,或者不开,数据库列和字段名全一致。

Select时指定AS。

resultMap 最稳健。

这篇主要看一下第一种,附上示例和部分源码走读。

1.驼峰命名开关。

因为CityPO的列名是完全根据数据库列名驼峰式命名后得到的,因此Mybatis提供了一个配置项。开启开配置项后,在匹配时,能够根据数据库列名找到对应对应的驼峰式命名后的字段。


我们从源码角度解读一下,Mybat处理ResultSet的映射默认都在DefaultResultSetHandler中完成。

处理行数据的时候的时候主要在下面的函数里进行,由于我们在映射文件中没有定义额外的ResultMap,因此会直接进入else分支的代码。

public void handleRowValues(ResultSetWrapper rsw, ResultMap resultMap, ResultHandler resultHandler, RowBounds rowBounds, ResultMapping parentMapping) throws SQLException {

if (resultMap.hasNestedResultMaps()) {

ensureNoRowBounds();

checkResultHandler();

handleRowValuesForNestedResultMap(rsw, resultMap, resultHandler, rowBounds, parentMapping);

} else {

handleRowValuesForSimpleResultMap(rsw, resultMap, resultHandler, rowBounds, parentMapping);

}

}

进入handleRowValuesForSimpleResultMap中,主要处理函数如下,在这里完成了对象的生成及赋值。

Object rowValue = getRowValue(rsw, discriminatedResultMap);

在这里先创建了对象的实例,然后获取了对象的元信息,为反射赋值做准备。

private Object getRowValue(ResultSetWrapper rsw, ResultMap resultMap) throws SQLException {

final ResultLoaderMap lazyLoader = new ResultLoaderMap();

Object rowValue = createResultObject(rsw, resultMap, lazyLoader, null);

if (rowValue != null && !hasTypeHandlerForResultObject(rsw, resultMap.getType())) {

final MetaObject metaObject = configuration.newMetaObject(rowValue);

boolean foundValues = this.useConstructorMappings;

if (shouldApplyAutomaticMappings(resultMap, false)) {

foundValues = applyAutomaticMappings(rsw, resultMap, metaObject, null) || foundValues;

}

foundValues = applyPropertyMappings(rsw, resultMap, metaObject, lazyLoader, null) || foundValues;

foundValues = lazyLoader.size() > 0 || foundValues;

rowValue = (foundValues || configuration.isReturnInstanceForEmptyRow()) ? rowValue : null;

}

return rowValue;

}

在applyAutomaticMappings完成了整个过程,我们进去探一探。

就是下面这个函数创建好了映射关系,这个函数的下半部分是完成赋值的,映射的部分下次会详细分析。

List autoMapping = createAutomaticMappings(rsw, resultMap, metaObject, columnPrefix);

在这个方法里,上半部分是生成了数据库的列名,在这个函数中找到了对应的字段名。

final String property = metaObject.findProperty(propertyName, configuration.isMapUnderscoreToCamelCase());

我们进去看一看,它传进了生成好的数据库列名,传进了前面提到的是否根据驼峰式命名映射开关的值。

事实证明,真的很简单,往下看,就是把下划线都去了。

public String findProperty(String name, boolean useCamelCaseMapping) {

if (useCamelCaseMapping) {

name = name.replace("_", "");

}

return findProperty(name);

}

隐隐觉得是不是大小写不敏感啊,继续往下看,这里返回找到的字段名。

private StringBuilder buildProperty(String name, StringBuilder builder) {

..........

String propertyName = reflector.findPropertyName(name);

if (propertyName != null) {

builder.append(propertyName);

}

}

return builder;

}

好了,真相大白,就是大小写不敏感的。

public String findPropertyName(String name) {

return caseInsensitivePropertyMap.get(name.toUpperCase(Locale.ENGLISH));

}

所以如果你数据库里字段是city_id,city_Id,大写I,那么可能会有问题吧,不过仔细想想,谁会吃力不讨好干这种事情,硬要处理成标准的驼峰式命名也可以啦,不过感觉必要性不大。

经过若干次中途崩溃,我终于写完了驼峰式命名开关下,我们是如何完成数据库列和字段名的映射的。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,445评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,889评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,047评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,760评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,745评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,638评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,011评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,669评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,923评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,655评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,740评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,406评论 4 320
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,995评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,961评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,023评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,483评论 2 342

推荐阅读更多精彩内容