语句模板

请注意

• 由于语句模版会直接参与 SQL 语句生成，模板应由应用代码定义，不能直接采用外部输入。数据值仍通过 ? 绑定；改用 JdbcTemplate 时也应保持参数绑定。

在使用 构造器 API 进行数据库操作时，语句模版可以决定生成的 SQL 的语句元素内容。

例如，对带有 point 类型的 MySQL 表进行读写操作时可以利用语句模版特性在生成的语句中使用数据库 ST_GeomFromText、ST_AsText 函数。

例：表

create table user_points
(
    id    int auto_increment primary key,
    point point,
    text  varchar(50)
);

例：映射

@Table("user_points")
public class UserPoints {
    private Integer id;

    @Column(selectTemplate   = "ST_AsText(point)",  // 会生成 select ST_AsText(point) as point
            insertTemplate   = "ST_GeomFromText(?)",// 会生成 insert ... values (ST_GeomFromText(?))
            setValueTemplate = "ST_GeomFromText(?)",// 会生成 update ... set point = ST_GeomFromText(?)
            whereColTemplate = "ST_AsText(point)"   // 会生成 ... where ST_AsText(point) = ?
    )
    private String point;
}

例：INSERT 操作和对应语句

UserPoints point = new UserPoints();
point.setId(1);
point.setPoint("POINT(1 2)");

LambdaTemplate lambda = ...
int result = lambda.insert(UserPoints.class)
                   .applyEntity(point)
                   .executeSumResult();

// 语句为：INSERT INTO user_points (id, point) VALUES (?, ST_GeomFromText(?))

例：UPDATE 操作和对应语句

LambdaTemplate lambda = ...
int result = lambda.update(UserPoints.class)
                   .eq(UserPoints::getId, 1)                     // 匹配条件
                   .updateTo(UserPoints::getPoint, "POINT(1 2)") // 更新字段
                   .doUpdate();

// 语句为：UPDATE user_points SET point = ST_GeomFromText(?) WHERE ( id = ? )

例：DELETE 操作和对应语句

LambdaTemplate lambda = ...
int result = lambda.delete(UserPoints.class)
                   .eq(UserPoints::getPoint, "POINT(1 2)") // 匹配条件
                   .doDelete();

// 语句为：DELETE FROM user_points WHERE ( ST_AsText(point) = ? )

模版属性

属性名	描述
selectTemplate	用作 select 语句中的列名。默认是空，表示列名本身。
insertTemplate	用作 insert 语句时参数写法，默认是 ?。
setValueTemplate	用作 update set 语句时参数写法，默认是 ?。
whereColTemplate	用作 update/delete 的 where 语句时列名的写法。默认是空，表示列名本身。
whereValueTemplate	用作 update/delete 的 where 语句时参数写法，默认是 ?。
orderByColTemplate	用作 order by 语句时列名的写法。默认是空，表示列名本身。