在mybatis的前身ibatis中namespace可以随便写,甚至可以不写,他并没有实际存在的意义,只是让语句区分度更高了写,一个淘汰的框架就不说他实现了。那么在mybatis中namespace有何作用呢?Namespace实现语句与接口的绑定,通过生成mapper接口代理的方式替代dao层设计,当然如果不使用mapper接口的方式namespace依旧可以随便写,但不能不写。
如果要采用面向接口的编程方式,namespace必须为mapper接口的全类名对象。
为什么这么说呢?我们从源码的角度研究下,mybatis框架环环相扣,我们今天不讨论每一步实现细节,只关注namespace相关。首先记住一点获取代理对象必然要调用configuration.java中的getMapper方法。
[图片上传失败...(image-d89372-1542177215245)]
[图片上传失败...(image-11acca-1542177215245)]
因此使用之前,必然要注册映射器,即先调用addMapper。
先看下mybatis对于配置文件的解析,以config.xml为例,由SqlSessionFactoryBuilder类中build进入,真正对于xml文件解析在XMLConfigBuilder中parseConfiguration,众所周知mybatis中映射文件的配置是通过config.xml的<mappers></mappers>元素配置,此元素非必需,因为mybatis提供了注解的方式,同时再调用addMapper时会尝试解析,容下问分解。
[图片上传失败...(image-f18542-1542177215245)]
只关注mapperElement方法。
[图片上传失败...(image-58a8fb-1542177215245)]
Mappers的配置有四种形式。
以<package></package>方式配置
以<mapper></mapper>方式配置,分别可以通过四种属性配置。
如果是package方式,此时突然发现这个方法没有解析映射文件的逻辑,直接调用了addMappers,看看这个方法最终调用调用了addMapper.
[图片上传失败...(image-4cebf9-1542177215245)]
回过头来看看addMapper方法。
[图片上传失败...(image-b33084-1542177215245)]
首先注册了一个映射器,即将我们mapepr接口的类型与代理对象工厂绑定。然后看下面处理,从注释也可以看得出来要生成mapepr代理对象需完成两个过程,映射(不一定是文件哦)解析,接口映射器的注入。
[图片上传失败...(image-a7db3c-1542177215245)]
[图片上传失败...(image-9ffa8e-1542177215245)]
loadXmlResource作用是解析mapper映射文件,什么时候解析呢?在之前没有解析过的时候进行解析,mybatis通过一个set列表标识解析资源。没有解析过时通过mapper接口的全类名查找资源,解析过的对象以三种不同的方式标识同一资源。因此此时决定了mapper接口与映射文件必须完成相同(同名同包)。同时构造mapper.xml解析XMLMapperBuilder类对象,同时设置当前namespace为mapper接口全类名。
[图片上传失败...(image-1ef710-1542177215244)]
Mapper标签解析如下:
[图片上传失败...(image-cd8bff-1542177215244)]
开始获取了namespace属性,然后设置当前namespace,设置逻辑如下
[图片上传失败...(image-21734c-1542177215244)]
由于当前namespace已经设置为mapper接口全名类,因为与映射文件namespace不相同必然报错,换句话说namespace必须为mapper接口全类名。
再看下一个方法,上面我们知道namespace即为namespace属性值也就是mapper全类名,获取类对象判断此映射器是否已注入,没有则标识当前解析资源,并调用addmapper注映射器,由于我们是在addmapper过来,映射器已经注入,所以不再调用,不然死循环了。那这个此时何时调用呢?我们接着往下看。
[图片上传失败...(image-5b683f-1542177215244)]
如果我们采用的<mapper></mapper>标签配置映射文件。
[图片上传失败...(image-302066-1542177215244)]
如果通过resource或者xml属性标识资源,此时创建解析类,但是注意这个构造方法没有设置当前解析的文件namespace.原因是namespace在不使用mapper接口的形式编程时,可以随便填写。
又回到xml解析,不同的是此时进行了映射器的注册,当使用mapper接口编程,boundType不为空,然后进行注册,在此调用了addMapper,同时表示映射文件已解析,刚才咱们已经讨论过。
[图片上传失败...(image-df0012-1542177215244)]
如果通过class表示mapper接口,直接调用了addMapper,触发文件解析,不再赘述同时该方法也会解析mapper接口的注解,如果存在。
所以当使用注解时,映射文件可以不用配置。但是建议配置空的xml文件,namespace为mapper接口全类名,自动触发映射器(mapper接口)的注入与注解的解析。如果你就是死活不配置,也阔以,请自行调用session.getConfiguration.addMapper(T.class).
总之,如果想使用mapper代理的方式,namespace与mapper接口全类名必须相同,至于需不需要同包同名,看你通过什么样的形式去配置,他们必须相同的还有个最重要的原因:解析sql语句所用的id为namespace+id,生成代理时,找寻sql接口对应的sql语句为接口全名+方法名。mapper代理对象的生成请听下回分解。