mybatis.net - 3 mybatis.net 的命名空间问题

在上一篇的映射文件中，Maps/ProductMap.xml 配置元素的根元素的开始标记如下所示：

<sqlMap namespace="EntityModel" xmlns="http://ibatis.apache.org/mapping"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

namespace 是什么呢？是不是 C# 中的命名空间呢？

其实不是的，这个命名空间与映射文件中的 statements 中配置的 SQL 语句的 id 有关。

在大型项目中，可能存在大量的 SQL 语句，这时候，为每个 SQL 语句起一个唯一的标识 id 就变得并不容易了。为了解决这个问题，在 mybatis 中，可以为每个映射文件起一个唯一的命名空间，这样，定义在这个映射文件中的每个 SQL 语句就成了定义在这个命名空间中的一个 id。只要我们能够保证每个命名空间是唯一的，即使在不同映射文件中的语句的 id 相同，也就不会冲突了。

与 C# 不同的是，这个通过命名空间管理语句标识的机制默认并不启用，也就是说，默认并不考虑我们定义的命名空间，而是直接使用语句的 id 。

何时启用命名空间机制，取决于 SqlMap.config 配置文件中定义的 useStatementNamespaces 配置参数的设置。此设置默认为 false.

<properties>
    <property key="useStatementNamespaces" value="false" />
</properties>

只有当这个参数设置为 true 的时候，命名空间机制才会启用，启用之后，在代码中，就必须使用带有命名空间的标识来访问 SQL 语句了。比如，原来的语句就需要修改为如下所示的代码了。

IList<EntityModel.Product> productList
    = Mapper.QueryForList<EntityModel.Product>("EntityModel.GetAllProducts", null);