HasorDB 注解化Mapper

如果对于编写大量的 ​Mapper ​文件比较反感可以采用注解方式，这种方式对于一些 ​简单的查询​ 和可以使用 ​快速规则​ 的查询来说，既可以减少复杂度也可以更灵活。

由于注解化 ​Mapper ​最大的特点就是无需 ​Mapper ​文件，SQL 配置会集中在 Mapper 接口的注解上。因此作为 注解化 Mapper 需要标记 ​@SimpleMapper​ 注解。

​​提示​​
请注意 ​@SimpleMapper​ 和 ​@RefMapper​ 两个注解不能同时使用，但它们都能够正确处理注解化 Mapper。 不过仍然要注意的是请避免 注解化 Mapper 和 Mapper 文件的定义冲突，遇到冲突 HasorDB 也不能正确处理好它们。

@Query注解​

用于配置一个 ​select ​查询，例如下列 Mapper 和接口可以简化成一个注解化 Mapper 方法。

<select id="queryUser">
    select * from `test_user`
    where
    <if test="age != null">
        and age = #{age}
    </if>
</select>

下面使用 ​快速'或'条件​ 简化 ​if​ 之后在利用 ​@Query ​注解化的结果。

@SimpleMapper()
public interface UserMapper {
    @Query(value = "select * from `test_user` where @{and, age = :age }",
           resultType = TestUser.class)
    List<TestUser> queryUser(@Param("age") int age);
}

​@Query​ 注解拥有很多属性，这些属性和 ​<select>​ 标签是相对应的

@Insert注解​

​@Insert​ 注解的功效和 ​<insert>​ 标签相同，下面是示例：

<insert id="insertUser">
    insert into `test_user` (
        `id`, `name`, `age`, `create_time`
    ) values (
        #{id}, #{name}, #{age}, #{createTime}
    )
</insert>

使用 ​@Insert​ 注解化方式。

@SimpleMapper()
public interface UserMapper {
    @Insert(value = "insert into `test_user` ( `id`, `name`, `age`, `create_time` ) "+
                     " values ( #{id}, #{name}, #{age}, #{createTime})")
    int queryUser(TestUser user);
}

​@Insert​ 注解拥有很多属性，这些属性和 ​<insert>​ 标签是相对应的

@Update注解​

​@Update​ 注解的功效和 ​<update>​ 标签相同，下面是示例：

<update id="updateAge">
    update `test_user` set age = #{age} where id = #{id}
</update>

使用 ​@Update​ 注解化方式。

@SimpleMapper()
public interface UserMapper {
    @Update(value = "update `test_user` set age = #{age} where id = #{id}")
    int updateAge(@Param("age") int age, @Param("id") int id);
}

​@Update​ 注解拥有很多属性，这些属性和 ​<update>​ 标签是相对应的

@Delete注解​

​@Delete​ 注解的功效和 ​<delete>​ 标签相同，下面是示例：

<delete id="deleteById">
    delete from `test_user` where id = #{id}
</delete>

使用 ​@Delete​ 注解化方式。

@SimpleMapper()
public interface UserMapper {
    @Update(value = "delete from `test_user` where id = #{id}")
    int updateAge(@Param("id") int id);
}

​@Delete​ 注解拥有很多属性，这些属性和​ <delete>​ 标签是相对应的

@Param注解​

​@Param ​注解只能标记在方法的参数上，用来在拼接动态 SQL 时候引用到对应的属性。

比较常见的方式如下，​#{id}​ 对应​ @Param("id")​

@Update(value = "delete from `test_user` where id = #{id}")
int updateAge(@Param("id") int id);

如果方法入参有且仅有一个对象，那么这个对象无需标记 ​@Param​ 注解，它的每一个属性都会被识别。例如：

public class TestUser {
    private Integer id;
    private String  name;
    private Integer age;
    private Date    createTime;

    // getters and setters omitted
}

@Insert(value = "insert into `test_user` "+
                "values ( #{id}, #{name}, #{age}, #{createTime})")
int queryUser(TestUser user);

如果参数没有标记 ​@Param​ 注解那么会以参数的所在顺序 前面加上固定的 ​arg ​来替代，例如：

@Update(value = "update `test_user` set age = #{arg0} where id = #{arg1}")
int updateAge(int age, int id);