Mybatis中数据对象与数据库参数映射是怎么设计的?

Mybatis中数据对象与数据库参数映射是怎么设计的?

技术教程gslnedu2025-02-01 13:20:3610A+A-

你知道Mybatis在执行的时候是如何获取我们传入对象的参数值并设置到xml中的指定字段中的吗,或者是如何将数据库字段映射到我们执行的对象中的吗,今天我们通过MetaObject和ObjectWrapper并结合源码来看一下。

这两个类在DefaultParameterHandler(参数映射)和DefaultResultSetHandler(结果集映射)中有广泛的应用,例如在DefaultParameterHandler中,通过将mapper接口方法入参封装为MetaObject,然后将mapper.xml的参数通过get的方式从MetaObject中获取属性值。又或者在DefaultResultSetHandler中,将查询结果映射到我们指定的实体对象中。

MetaObject

MetaObject意为源数据,在MetaObject中封装了objectWrapperFactory、objectWrapper(入参对象包装类)和源对象(入参对象),其中objectWrapper是通过objectWrapperFactory来获取的。

MetaObject中有几个常用的方法我们介绍一下:getValue()、setValue()、findProperty()等

先说明一下,虽然MetaObject提供了方法,但实际上最终还有由对应的ObjectWrapper来实现的

  • getValue:获取源数据中指定字段的值

在使用MetaObject获取值时,通过MetaObject的getValue方法,最终还是委托给objectWrapper的get方法去获取value值

我们以DefaultParameterHandler来解释一下上面的这段话:

通过configuration的newMetaObject方法去创建了metaObject对象,实际就是调用metaObject的构造方法去创建,然后通过metaObject的getValue方法去获取指定的参数值,我们看getValue方法不难看出实际就是调用objectWrapper的get方法。

  • findProperty:处理反馈的数据库字段

这个怎么理解呢,我们知道数据库设计时,如果字段名有多个单词,应该以"_"隔开,在java中并没有这种设计,因此如何将有"_"与实体字段名相映射呢?

在Mybatis中,如果你设置了mapUnderscoreToCamelCase=true的话,Mybatis会自动将字段中的"_"去除,然后与java实体映射。

那Mybatis是怎么做的呢,其实就是用到了findProperty方法:

我们可以看到如果开启的话,则会自动替换

我们以DefaultResultSetHandler为例来解释一下上的话:

DefaultResultSetHandler这个类就是处理结果集映射的,它会一行一行的解析数据库返回的数据,并将字段的值设置到我们的实体对象中,其中在判断有自动映射时,会调用findProperty方法,传入的是数据库中的字段,实际返回的是处理后的字段名称(与实体字段名一致),然后通过该名称调用setValue方法设置到实体对象中。

  • setValue:给指定实体设置值

我们继续以上面的为例,当findProperty二次处理后,返回的就是我们实体的字段名了,然后依然通过反射给字段设置值。

ObjectWrapper

说完MetaObject,我们再来看看ObjectWrapper,ObjectWrapper本身是一个接口,Mybatis本身已经对常用的对象做了实现,例如:MapWrapper、CollectionWrapper、BeanWrapper,分别对应map对象、集合对象、实体对象,所以我们平时也不需要管这些东西。


在MetaObject创建的时候,Mybatis会根据参数实体的类型自动生成对应的ObjectWrapper,同时也给我们提供了自定的ObjectWrapper(通过ObjectWrapperFactory)。

我们以BeanWrapper为例来看一下Mybatis是如何获取实体对象的参数值的:

调用MetaObject的getValue方法,实际是调用的BeanWrapper的get方法来获取参数值

而BeanWrapper实际是通过反射获取指定的参数值

实践

ok,说了这么多,这俩类是干啥的我们知道了,但是有啥用呢,Mybatis已经将常用的都给我们封装好了,实际上我们并不需要关注这么多。但是当我们遇到极个别棘手的问题时,我们知道了其中的原理,那么就可以对症下药根治它。

例如:当我们使用Map做结果集映射时,不同的数据库返回的字段大小写是不一样的,oracle返回的是大写的,mysql返回的是小写的。

Map selectId(String id);

这样的话,我们在使用不同的数据库时,需要做不同的判断,否则我们无法获取对应字段的值,如果后续增加新的数据库,我们还要写代码疲于应对。那么有没有一种办法可以根治这个问题呢,答案肯定是有的,我们可以将数据库返回的字段统一改为大写或者小写不就可以了嘛!

那么该如何做呢?有了上面的知识,我们知道结果映射map是通过MapWrapper来实现的,数据库结果集二次映射是通过findProperty方法来实现的,那么我们就可以重写MapWrapper的findProperty方法,将数据库字段改成统一的方式即可!

public class Map2UpperWrapper extends MapWrapper {
    public Map2UpperWrapper(MetaObject metaObject, Map map) {
        super(metaObject, map);
    }
    @Override
    public String findProperty(String name, boolean useCamelCaseMapping) {
        return StringUtils.isBlank(name)?"":name.toUpperCase() ;
    }
}

这还没有完,我们自定义完ObjectWrapper,如何让他生效呢?我们知道ObjectWrapper是通过ObjectWrapperFactory来生成的,因此我们需要创建一个ObjectWrapperFactory在指定条件下来生成我们自定义的ObjectWrapper:

public class Map2UpperWrapperFactory implements ObjectWrapperFactory {
    @Override
  	//当参数映射是map是才使用Map2UpperWrapper对象
    public boolean hasWrapperFor(Object object) {
        return object != null && object instanceof Map;
    }
    @Override
    public ObjectWrapper getWrapperFor(MetaObject metaObject, Object o) {
        return new Map2UpperWrapper(metaObject, (Map) o);
    }
}

然后我们将Map2UpperWrapperFactory设置到sqlSessionFactory中:

public SqlSessionFactory sqlSessionFactory(@Qualifier("DataSource") DataSource dataSource) throws Exception {
        final SqlSessionFactoryBean sqlSessionFactory = new SqlSessionFactoryBean();
        sqlSessionFactory.setObjectWrapperFactory(new MapWrapperFactory());
        return sqlSessionFactory.getObject();
    }

这么看好像比单独判断数据库要麻烦,但是我们是从根源上解决了这个问题,后续再增加数据库,我们也无需再改代码。

点击这里复制本文地址 以上内容由朽木教程网整理呈现,请务必在转载分享时注明本文地址!如对内容有疑问,请联系我们,谢谢!
qrcode

朽木教程网 © All Rights Reserved.  蜀ICP备2024111239号-8