3.2.9.3.2. 属性类型

平台支持以下开箱即用的属性类型:

  • String, 原始类型及其封装类型(booleanBooleanint 、 `Integer`等)

  • enum,属性值作为枚举的值名称存储在文件或数据库中。

    如果枚举实现了 EnumClass 接口并且具有用于通过标识符获取值的静态方法 fromId(),则可以使用 @EnumStore 注解指定存储枚举标识符而不是具体值。例如:

    1. @Property("myapp.defaultCustomerGrade")
    2. @DefaultInteger(10)
    3. @EnumStore(EnumStoreMode.ID)
    4. CustomerGrade getDefaultCustomerGrade();
    5. @EnumStore(EnumStoreMode.ID)
    6. void setDefaultCustomerGrade(CustomerGrade grade);
  • 持久化实体类。访问实体类型的属性时,将从数据库加载由属性值定义的实例。

要支持任意类型,请使用 TypeStringifyTypeFactory 类将值转换为字符串或从字符串转换值,并使用 @Stringify@Factory 注解为属性指定这些类。

我们以 UUID 类型为例来了解这个过程。

  • 创建类 com.haulmont.cuba.core.config.type.UuidTypeFactory 继承于 com.haulmont.cuba.core.config.type.TypeFactory 类 并实现下面的方法:

    1. public Object build(String string) {
    2. if (string == null) {
    3. return null;
    4. }
    5. return UUID.fromString(string);
    6. }
  • 在这种情况下没有必要创建 TypeStringify,因为有 toString() 方法。

  • 在配置接口中注解属性:

    1. @Factory(factory = UuidTypeFactory.class)
    2. UUID getUuidProp();
    3. void setUuidProp(UUID value);

平台为以下类型提供了 TypeFactory 实现:

  • UUIDUuidTypeFactory, 如上所述。

  • java.util.DateDateFactory。日期值必须以 yyyy-MM-dd HH:mm:ss.SSS 格式指定,例如:

    1. cuba.test.dateProp = 2013-12-12 00:00:00.000
  • List<Integer> (整数列表) – IntegerListTypeFactory。必须以数字的形式指定属性值,用空格分隔,例如:

    1. cuba.test.integerListProp = 1 2 3
  • List<String> (字符串列表) – StringListTypeFactory。必须将属性值指定为由”|”分隔的字符串列表,例如:

    1. cuba.test.stringListProp = aaa|bbb|ccc