對映申明樣例

這個例子展示瞭如何使用 @SelectKey 註解來在插入前讀取資料庫序列的值：

@Insert("insert into table3 (id, name) values(#{nameId}, #{name})")@SelectKey(statement="call next value for TestSequence", keyProperty="nameId", before=true, resultType=int.class)int insertTable3(Name name);

這個例子展示瞭如何使用 @SelectKey 註解來在插入後讀取資料庫識別列的值：

@Insert("insert into table2 (name) values(#{name})")@SelectKey(statement="call identity()", keyProperty="nameId", before=false, resultType=int.class)int insertTable2(Name name);

This example shows using the @Flush annotation to call the SqlSession#flushStatements():

@FlushList<BatchResult>
 
 flush();

These examples show how to name a ResultMap by specifying id attribute of @Results annotation.

@Results(id ="userResult", value ={@Result(property ="id", column ="uid", id =true),@Result(property ="firstName", column ="first_name"),@Result(property ="lastName", column ="last_name")})@Select
 
("select * from users where id = #{id}")User getUserById(Integer id);@Results(id ="companyResults")@ConstructorArgs({@Arg(property ="id", column ="cid", id =true),@Arg(property ="name", column ="name")})@Select("select * from company where id = #{id}")Company getCompanyById(Integer id);

This example shows solo parameter using the Sql Provider annotation:

@SelectProvider(type =UserSqlBuilder.class, method ="buildGetUsersByName")List<User> getUsersByName(String name);classUserSqlBuilder{publicString buildGetUsersByName(finalString name){returnnew SQL(){{
      SELECT("*");
      FROM("users");if(name !=null){
        WHERE("name like #{value} || '%'");}
      ORDER_BY("id");}}.toString();}}

This example shows multiple parameters using the Sql Provider annotation:

@SelectProvider(type =UserSqlBuilder.class, method ="buildGetUsersByName")List<User> getUsersByName(@Param("name")String name,@Param("orderByColumn")String orderByColumn);classUserSqlBuilder{// If not use @Param, you should be define same arguments with mapper methodpublicString buildGetUsersByName(finalString name,finalString orderByColumn){returnnew SQL(){{
      SELECT("*");
      FROM("users");
      WHERE("name like #{name} || '%'");
      ORDER_BY(orderByColumn);}}.toString();}// If use @Param, you can define only arguments to be usedpublicString buildGetUsersByName(@Param("orderByColumn")finalString orderByColumn){returnnew SQL(){{
      SELECT("*");
      FROM("users");
      WHERE("name like #{name} || '%'");
      ORDER_BY(orderByColumn);}}.toString();}}