my space:mybatis中的namespace及mapper

有时候遇到问题,我们可能在网上找不到解决方法,即使找得到也不要完全相信,我并不是说博客内容有问题,我相信原创博客比如经过作者的精心验证,但是博客不顾时间的肆意转载,导致有些解决方案并不适合当前版本,我觉得作为一个程序员,要有严谨的工作态度,不能说哦原来这样,让应该问问自己咦,为什么这样。有时候自己看看源码或许也是解决问题的不错途径,今天我们从源码中分析下mybatis中的namespace到底该怎么配置。
在mybatis的前身ibatis中namespace可以随便写,甚至可以不写,他并没有实际存在的意义,只是让语句区分度更高了写,一个淘汰的框架就不说他实现了。那么在mybatis中namespace有何作用呢?Namespace实现语句与接口的绑定,通过生成mapper接口代理的方式替代dao层设计,当然如果不使用mapper接口的方式namespace依旧可以随便写,但不能不写
如果要采用面向接口的编程方式,namespace必须为mapper接口的全类名对象。
为什么这么说呢?我们从源码的角度研究下,mybatis框架环环相扣,我们今天不讨论每一步实现细节,只关注namespace相关。首先记住一点获取代理对象必然要调用configuration.java中的getMapper方法。


因此使用之前,必然要注册映射器,即先调用addMapper。
先看下mybatis对于配置文件的解析,以config.xml为例,由SqlSessionFactoryBuilder类中build进入,真正对于xml文件解析在XMLConfigBuilder中parseConfiguration,众所周知mybatis中映射文件的配置是通过config.xml的mappers标签配置,此元素非必需,因为mybatis提供了注解的方式,同时再调用addMapper时会尝试解析,容下问分解。


只关注mapperElement方法。


Mappers的配置有四种形式。
1.以package标签方式配置
2.以mapper方式配置,分别可以通过四种属性配置。
如果是package方式,此时突然发现这个方法没有解析映射文件的逻辑,直接调用了addMappers,看看这个方法最终调用调用了addMapper.


回过头来看看addMapper方法。


首先注册了一个映射器,即将我们mapepr接口的类型与代理对象工厂绑定。然后看下面处理,从注释也可以看得出来要生成mapepr代理对象需完成两个过程,映射(不一定是文件哦)解析,接口映射器的注入。



loadXmlResource作用是解析mapper映射文件,什么时候解析呢?在之前没有解析过的时候进行解析,mybatis通过一个set列表标识解析资源。没有解析过时通过mapper接口的全类名查找资源。因此此时决定了mapper接口与映射文件必须完成相同(同名同包)。同时构造mapper.xml解析XMLMapperBuilder类对象,同时设置当前namespace为mapper接口全类名。mybatis通过三种不同方式标识本地资源。(如果映射文件被解析,那么会添加一个该文件的路径标识该xml已经解析过,如果解析的xml,namespace为一个接口的全类名,会添加一个namespace+xml路径的资源标识,eg:“namespace com.bll.IUser”并调用addMapper;如果调用了addMapper还会添加一个interface.tostring的标识,eg:“interface com.bll.IUser”)


Mapper标签解析如下:

开始获取了namespace属性,然后设置当前namespace,设置逻辑如下


由于当前namespace已经设置为mapper接口全名类,因为与映射文件namespace不相同必然报错,换句话说namespace必须为mapper接口全类名。
再看下一个方法,上面我们知道namespace即为namespace属性值也就是mapper全类名,获取类对象判断此映射器是否已注入,没有则标识当前解析资源,并调用addmapper注映射器,由于我们是在addmapper过来,映射器已经注入,所以不再调用,不然死循环了。那这个此时何时调用呢?我们接着往下看。

如果我们采用的标签配置映射文件。


如果通过resource或者xml属性标识资源,此时创建解析类,但是注意这个构造方法没有设置当前解析的文件namespace.原因是namespace在不使用mapper接口的形式编程时,可以随便填写。
又回到xml解析,不同的是此时进行了映射器的注册,当使用mapper接口编程,boundType不为空,然后进行注册,在此调用了addMapper,同时表示映射文件已解析,刚才咱们已经讨论过。


如果通过class表示mapper接口,直接调用了addMapper,触发文件解析,不再赘述同时该方法也会解析mapper接口的注解,如果存在。

所以当使用注解时,映射文件可以不用配置。但是建议配置空的xml文件,namespace为mapper接口全类名,自动触发映射器(mapper接口)的注入与注解的解析。如果你就是死活不配置,也阔以,请自行调用session.getConfiguration.addMapper(T.class).

总之,如果想使用mapper代理的方式,namespace与mapper接口全类名必须相同,至于需不需要同包同名,看你通过什么样的形式去配置,他们必须相同的还有个最重要的原因:解析sql语句所用的id为namespace+id,生成代理时,找寻sql接口对应的sql语句为接口全名+方法名。mapper文件解析做了什么及mapper代理对象的生成请听下回分解。

相关推荐

相关文章