上面的这个示例说明了一个非常简单的命名参数映射。参数类型被设置为 int,这样这个参数就可以被设置成任何内容。原生的类型或简单数据类型(比如整型和字符串)因为没有相关属性,它会完全用参数值来替代。然而,如果传入一个复杂的对象,行为就会有一点不同了。比如:

  1. insert into users (id, username, password)
  2. values (#{id}, #{username}, #{password})

如果 User 类型的参数对象传递到了语句中,id、username 和 password 属性将会被查找,然后将它们的值传入预处理语句的参数中。

这点相对于向语句中传参是比较好的,而且又简单,不过参数映射的功能远不止于此。

首先,像 MyBatis 的其他部分一样,参数也可以指定一个特殊的数据类型。

  1. #{property,javaType=int,jdbcType=NUMERIC}

NOTE 如果一个列允许 null 值,并且会传递值 null 的参数,就必须要指定 JDBC Type。阅读 PreparedStatement.setNull() 的 JavaDocs 文档来获取更多信息。

为了以后定制类型处理方式,你也可以指定一个特殊的类型处理器类(或别名),比如:

尽管看起来配置变得越来越繁琐,但实际上,很少需要去设置它们。

对于数值类型,还有一个小数保留位数的设置,来确定小数点后保留的位数。

  1. #{height,javaType=double,jdbcType=NUMERIC,numericScale=2}

    MyBatis 也支持很多高级的数据类型,比如结构体,但是当注册 out 参数时你必须告诉它语句类型名称。比如(再次提示,在实际中要像这样不能换行):

    尽管所有这些选项很强大,但大多时候你只须简单地指定属性名,其他的事情 MyBatis 会自己去推断,顶多要为可能为空的列指定 jdbcType

    1. #{firstName}
    2. #{middleInitial,jdbcType=VARCHAR}

    字符串替换

    默认情况下,使用 #{} 格式的语法会导致 MyBatis 创建 PreparedStatement 参数并安全地设置参数(就像使用 ? 一样)。这样做更安全,更迅速,通常也是首选做法,不过有时你就是想直接在 SQL 语句中插入一个不转义的字符串。比如,像 ORDER BY,你可以这样来使用:

    1. ORDER BY ${columnName}

    这里 MyBatis 不会修改或转义字符串。