Final Annotation

Final Annotation定义基础的注释与接口。

Final Annotation Core

Final Annotation Core定义了大量的超接口和注释，用于标记标记和区分元素（类、方法或属性）在项目中所扮演的角色。

如：

• IEnum：用于枚举的IEnum接口，可实现Json序列化增强及自定义数据映射。
• IEntity：用于实体类的IEntity接口，可实现ORM映射及通用的CRUD数据操作。
• IException: 用于异常的IException接口，可用于区分系统异常和业务异常，从而进行全局的异常处理。
• IQuery：用于查询的IQuery接口，可用于定义统一的查询规则。
• IResult：用于结果的IResult接口，可实现统一的结果集处理。
• @Default: 用于标记元素含有（或是）默认值，不需要框架进行处理。如数据的默认值。
• @Final：用于标记元素是终态，不应该被修改，如数据库的主键ID和创建时间。
• @Transient: 用于票房元素是短暂的，不需要被处理。

Final Annotation Data

Final Annotation Data为ORM的定义了大量的注解。

如：

• @Table：用于指定实体类与数据库表的映射关系。
• @Column：用于指定实体类属性与数据库列的映射关系。

一个实体类应有实现IEntity接口，或继承自AbsEntity。

Final Annotation Cache

Final Annotation Cache定义了切面缓存注释，使用Redis做为缓存存储，支持Value和Hash等数据结构。

可以为应用快速添加缓存功能，减少大量模板代码。

public interface UserService {

    @Cacheable(key = "#{#id}")
    User findById(Long id);

}

Final Annotation Query

Final Annotation Query提供了丰富的查询条件(Criterion)和更新操作(Update)。

Query

Final Annotation Query提供编码和注解两种方式来构建查询条件。

如当需要构建以下查询条件时：

WHERE name = #{value} AND age BETWEEN #{min} AND #{max}

• 编码

new Query().where(
    name.eq("name"),
    age.between(min,max)
    );

• 注解

public class MyQuery implements IQuery {

    @Equal
    private String name;

    @Between
    private BetweenValue<Integer> age;

    //setter and getter
    //...
}

Update

Update支持常用的数据设置及数学运算，如：

    // UPDATE table SET name = #{value},version = version + 1;
    new Update().set("name","value").incr("version");

也添加了对Json数据列的支持：

    // UPDATE table SET json = JSON_SET(json,path,value);
    new Update().jsonSet("json",<path, value>);
    // UPDATE table SET json = JSON_INSERT(json,path,value);
    new Update().jsonInsert("json",<path, value>);
    // UPDATE table SET json = JSON_REPLACE(json,path,value);
    new Update().jsonReplace("json",<path, value>);
    // UPDATE table SET json = JSON_REMOVE(json,paths);
    new Update().jsonRemove("json",paths);

注意path的格式为要以$开头。