文档结构

Mapper 文件是以 XML 形式保存，它的基本结构如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//dbvisitor.net//DTD Mapper 1.0//EN"
                        "https://www.dbvisitor.net/schema/dbvisitor-mapper.dtd">
<mapper namespace="...">
    ...
</mapper>

属性

属性名	描述
namespace	必选通常是配置一个接口类名，这个接口下的每个方法会对应到 mapper 文件中一个具体的 sql 操作上。
caseInsensitive	可选在处理映射列名和属性名时是否对大小写不敏感，默认是 `true` 不敏感。对于某些数据库查询结果始终返回大写，利用这个功能可以方便的映射到属性上。
mapUnderscoreToCamelCase	可选用于决定属性名在映射到列名时，是否按照驼峰命名法转换为下划线命名法，例如：属性名 `createTime` 被转换为 `create_time`。默认是 `false` 不转换
autoMapping	可选用于决定是否进行自动映射。默认是 `true` 自动映射。
useDelimited	可选 (v5.3.4+)，用于决定在生成 SQL 语句时，表名/列名是否强制使用限定符。默认：false 不使用。

验证文档

使用 XML DTD 或者 XML Schema 可以验证 Mapper 文件的正确性。

例：使用 DTD 验证
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//dbvisitor.net//DTD Mapper 1.0//EN"
                        "https://www.dbvisitor.net/schema/dbvisitor-mapper.dtd">
<mapper namespace="...">
    ...
</mapper>

例：使用 XML Schema 验证
<?xml version="1.0" encoding="UTF-8"?>
<mapper xmlns="https://www.dbvisitor.net/schema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="https://www.dbvisitor.net/schema https://www.dbvisitor.net/schema/dbvisitor-mapper.xsd"
        namespace="...">
    ...
</mapper>

属性​

标签​

验证文档​

属性

标签

验证文档