关于mybatis 的mapper namespace 作用及解析

时间:2022-11-09 17:02:21

  因为语言惯性,大部分的namespace 在语言级别*来说是作为一种限定性标识来用,起到唯一或一类的标识。来看看语言(以PHP语言为例)上的namespace的作用实例

一、namespace 在PHP中的作用(引自:http://www.php.net/manual/zh/language.namespaces.rationale.php

  在PHP中,命名空间用来解决在编写类库或应用程序时创建可重用的代码如类或函数时碰到的两类问题:

  1. 用户编写的代码与PHP内部的类/函数/常量或第三方类/函数/常量之间的名字冲突。
  2. 为很长的标识符名称(通常是为了缓解第一类问题而定义的)创建一个别名(或简短)的名称,提高源代码的可读性。

  PHP 命名空间提供了一种将相关的类、函数和常量组合到一起的途径。下面是一个说明 PHP 命名空间语法的示例:

Example #1 命名空间语法示例

 <?php
namespace my\name; // 参考 "定义命名空间" 小节 class MyClass {}
function myfunction() {}
const MYCONST = 1; $a = new MyClass;
$c = new \my\name\MyClass; // 参考 "全局空间" 小节 $a = strlen('hi'); // 参考 "使用命名空间:后备全局函数/常量" 小节 $d = namespace\MYCONST; // 参考 "namespace操作符和__NAMESPACE__常量” 小节 $d = __NAMESPACE__ . '\MYCONST';
echo constant($d); // 参考 "命名空间和动态语言特征" 小节
?>

二、namespace 在mybatis mapper 中的作用

  由于之前对namespace 的理解一直停留在如上的理解中,导致在编写mybatis的mapper时namespace也理解为限定类作用,就以当前文件所在包名为命名空间

  关于mybatis 的mapper namespace 作用及解析

  编译通过没有收到Warning类提示,但在调用对应的dao时会报

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.*******.dao.UserDao.userExists

一开始还在怀疑是不是mybaits配置文件是否有问题,但MapperCounfigure中扫描包确定是没有问题,后来查找了mybatis入门指南中关于namespace的解释才明白

1.mapper中的namespace用于绑定dao接口的,即面向接口编程。

2.看一下入门指南是如何解释的

命名空间的一点注释(引自:http://www.mybatis.org/mybatis-3/zh/getting-started.html)

命名空间(Namespaces)在之前版本的 MyBatis 中是可选的,容易引起混淆因此是没有益处的。现在的命名空间则是必须的,目的是希望能比只是简单的使用更长的完全限定名来区分语句更进一步。

命名空间使得你所见到的接口绑定成为可能,尽管你觉得这些东西未必用得上,你还是应该遵循这里的规定以防哪天你改变了主意。出于长远考虑,使用命名空间,并将它置于合适的 Java 包命名空间之下
,你将拥有一份更加整洁的代码并提高了 MyBatis 的可用性。 命名解析:为了减少输入量,MyBatis 对所有的命名配置元素(包括语句,结果映射,缓存等)使用了如下的命名解析规则。 1.完全限定名(比如“com.mypackage.MyMapper.selectAllThings”)将被直接查找并且找到即用。
2.短名称(比如“selectAllThings”)如果全局唯一也可以作为一个单独的引用。如果不唯一,有两个或两个以上的相同名称(比如“com.foo.selectAllThings ”和“com.bar.selectAllThings”),
    那么使用时就会收到错误报告说短名称是不唯一的,这种情况下就必须使用完全限定名。

3.正确的namspace指定

关于mybatis 的mapper namespace 作用及解析

总结:Mybatis中namespace用于绑定dao接口,dao接口的方法对应mapper中的sql语名。

*:关于这一理解纯属个人理解可能namespace在其他方面也有相应的作用,可能有点以偏概全。