首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >OneCode3.0 ComboInput:注解驱动的交互体验革新

OneCode3.0 ComboInput:注解驱动的交互体验革新

原创
作者头像
OneCode
发布于 2025-07-23 14:52:41
发布于 2025-07-23 14:52:41
3520
举报
文章被收录于专栏:ooderAgentooderAgent

前言

作为 OneCode 框架中的核心组件,ComboInput 一直以来都是处理复杂输入场景的利器。而在 OneCode3.0 版本中,ComboInput 组件通过全新的注解体系重构,实现了更高效、更灵活的开发体验。今天,我们就来深度剖析 OneCode3.0 ComboInput 的新特性和技术实现。

一、注解体系重构:从臃肿到清晰的蜕变

OneCode3.0 对 ComboInput 组件的最大改进,莫过于注解体系的重构。在旧版本中,数据属性、字段属性和通用属性分散在各个组件注解中,导致代码复用性低、维护困难。3.0 版本通过以下方式实现了注解的清晰拆分:

  1. 通用属性类:@CustomAnnotation 负责配置组件的通用属性,如 id、caption 等
  2. 容器属性类:@ComboBoxAnnotation 专注于下拉框的容器配置,如列表宽度、高度等
  3. 字段属性类:@ComboInputAnnotation 定义字段相关的属性,如输入类型、提示信息等
  4. 数据集合类:@CustomListAnnotation 统一管理数据集合,支持动态加载和过滤

这种拆分遵循了单一职责原则,使得每个注解的职责更加明确,代码结构更加清晰。

二、子组件结构关系

OneCode3.0 ComboInput 组件的子组件结构关系可以用以下图形表示:

代码语言:txt
复制
+-------------------+
|  CustomAnnotation |
+-------------------+
         ^
         |
+---------+---------+
|                   |
|                   |
+--------+    +------+------+
|        |    |             |
|        |    |             |
+--------v----v-+   +-------v--------+
|  ComboBoxAnnotation  |   |  ComboInputAnnotation  |
+----------------------+   +-----------------------+
         ^                         ^
         |                         |
+---------+---------+    +---------+---------+
|                   |    |                   |
|                   |    |                   |
+--------+    +------+   +--------+    +------+
|        |    |      |   |        |    |      |
|        |    |      |   |        |    |      |
+--------v----v-+    +---v--------v----v-+    +---v--------+
| ComboHelpAnnotation |  | ComboFileAnnotation |  | ComboDateAnnotation |
+---------------------+  +--------------------+  +---------------------+

+-------------------+
| CustomListAnnotation |
+-------------------+
         ^
         |
+---------+---------+
|                   |
|                   |
+--------+    +------+
|        |    |      |
|        |    |      |
+--------v----v-+    +---v--------+
| ComboGetterAnnotation |  | 其他数据集合注解  |
+-----------------------+  +------------------+

从图中可以看出,@CustomAnnotation 是所有组件的基类,负责配置通用属性;@ComboBoxAnnotation 和 @ComboInputAnnotation 分别负责容器和字段属性;而 @CustomListAnnotation 则独立管理数据集合。

三、核心注解详解

1. CustomAnnotation

代码语言:java
复制
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.FIELD})
@BeanClass(clazz = CustomFieldBean.class)
public @interface CustomAnnotation {
    String id() default "";
    String caption() default "";
    String[] enums() default {};
    Class<? extends Enum> enumClass() default Enum.class;
    @NotNull
    boolean uid() default false;
    ComboInputType inputType() default ComboInputType.none;
    // 其他通用属性...
}

@CustomAnnotation 是配置组件通用属性的核心注解,几乎所有组件都会用到它。它负责设置组件的 id、caption、是否只读、是否隐藏等通用属性。

2. ComboBoxAnnotation

代码语言:java
复制
@CustomClass(clazz = CustomComboBoxComponent.class,
        viewType = CustomViewType.COMBOBOX,
        inputType = ComboInputType.combobox,
        componentType = ComponentType.ComboInput)
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.FIELD})
@BeanClass(clazz = ComboxFieldBean.class)
public @interface ComboBoxAnnotation {
    String listKey() default "";
    String dropImageClass() default "";
    int dropListWidth() default 0;
    int dropListHeight() default 0;
}

@ComboBoxAnnotation 专注于下拉框的容器配置,如列表宽度、高度和图标样式等。它的 listKey 属性用于指定下拉列表数据的键名。

3. ComboInputAnnotation

代码语言:java
复制
@CustomClass(clazz = CustomComboInputComponent.class,
        viewType = CustomViewType.COMBOBOX,
        inputType = {ComboInputType.input},
        componentType = ComponentType.ComboInput)
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.FIELD})
@BeanClass(clazz = ComboInputFieldBean.class)
public @interface ComboInputAnnotation {
    String expression() default "";
    String imageBgSize() default "";
    String imageClass() default "";
    String iconFontCode() default "";
    // 其他字段属性...
}

@ComboInputAnnotation 负责定义字段相关的属性,如输入类型、提示信息和只读状态等。它的 inputType 属性用于指定输入类型。

4. CustomListAnnotation

代码语言:java
复制
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.FIELD})
@BeanClass(clazz = CustomListBean.class)
public @interface CustomListAnnotation {
    String id() default "";
    Class bindClass() default Void.class;
    Class<? extends Enum> enumClass() default Enum.class;
    @NotNull
    boolean dynLoad() default true;
    String filter() default "";
    // 其他数据集合属性...
}

@CustomListAnnotation 是 OneCode3.0 新增的注解,用于统一管理数据集合。它支持动态加载、过滤和枚举值设置,提高了数据的复用性和可维护性。

四、代码示例

1. 基本使用示例

代码语言:java
复制
// 下拉框示例 - 结合多个注解
@CustomAnnotation(
    id = "userTypeComboBox",
    caption = "用户类型"
)
@ComboBoxAnnotation(
    listKey = "userTypesList"
)
@ComboInputAnnotation(
    inputType = ComboInputType.combobox
)
private String userType;

// 日期选择器示例
@CustomAnnotation(
    id = "birthday",
    caption = "出生日期"
)
@ComboDateAnnotation(
    dateEditorTpl = "yyyy-MM-dd"
)
private Date birthday;

// 数据集合示例
@CustomListAnnotation(
    id = "userTypeList",
    bindClass = UserType.class,
    dynLoad = true,
    filter = "status=1"
)
public List<UserType> getUserTypes() {
    // 实现数据获取逻辑
    return userTypeService.findAll();
}

2. 高级使用示例

代码语言:java
复制
// 带懒加载的下拉框
@CustomAnnotation(
    id = "departmentComboBox",
    caption = "部门选择"
)
@ComboBoxAnnotation(
    listKey = "departmentList"
)
@ComboInputAnnotation(
    inputType = ComboInputType.combobox
)
private String departmentId;

// 高级数据集合示例
@CustomListAnnotation(
    id = "departmentList",
    bindClass = Department.class,
    dynLoad = true,
    filter = "status=1 and parentId=:parentId",
    itemsExpression = "${item.name} (${item.code})"
)
public List<Department> getDepartmentList(String parentId) {
    // 实现带参数的数据获取逻辑
    return departmentService.findByParentId(parentId);
}

五、最佳实践

  1. 合理选择注解类型:根据业务需求选择合适的 ComboInput 注解类型,特别是区分 @CustomAnnotation、@ComboBoxAnnotation 和 @ComboInputAnnotation 的使用场景。
  2. 设置唯一标识符:确保每个组件的 id 是唯一的,避免冲突。
  3. 优化数据加载:对于大数据量的情况,使用 @CustomListAnnotation 的 dynLoad 属性实现动态加载,提高性能。
  4. 明确注解职责:遵循 OneCode 3.0 的注解拆分原则,容器属性使用 @ComboBoxAnnotation,字段属性使用 @ComboInputAnnotation,通用属性使用 @CustomAnnotation。
  5. 善用数据集合:对于可复用的数据,使用 @CustomListAnnotation 定义独立的数据集合,避免重复实现数据获取逻辑。

六、常见问题解答

1. 如何实现 ComboInput 组件的数据源动态加载?

可以通过 @CustomListAnnotation 的 dynLoad 属性实现数据源的动态加载。设置 dynLoad = true,并实现数据获取方法。

2. 如何在多个组件间共享同一个数据集合?

使用 @CustomListAnnotation 可以轻松实现数据集合的共享。只需要定义一个数据集合,然后在多个组件中通过 listKey 属性引用它即可。

3. 如何为数据集合设置过滤条件?

可以使用 @CustomListAnnotation 的 filter 属性来设置过滤条件。过滤条件可以包含参数,参数值可以从上下文中获取。

七、总结

OneCode3.0 ComboInput 组件通过注解体系的重构,实现了更高效、更灵活的开发体验。它遵循单一职责原则,将通用属性、容器属性、字段属性和数据集合分离,提高了代码的复用性和可维护性。

无论是简单的下拉选择,还是复杂的文件上传、日期选择,OneCode3.0 ComboInput 组件都能满足你的需求。通过合理选择和配置注解,你可以快速构建出高质量的用户界面,提高开发效率和用户体验。

如果你还没有尝试过 OneCode3.0 ComboInput 组件,那么现在就是最好的时机。相信它会给你的开发工作带来全新的体验。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 前言
    • 一、注解体系重构:从臃肿到清晰的蜕变
    • 二、子组件结构关系
    • 三、核心注解详解
      • 1. CustomAnnotation
      • 2. ComboBoxAnnotation
      • 3. ComboInputAnnotation
      • 4. CustomListAnnotation
    • 四、代码示例
      • 1. 基本使用示例
      • 2. 高级使用示例
    • 五、最佳实践
    • 六、常见问题解答
      • 1. 如何实现 ComboInput 组件的数据源动态加载?
      • 2. 如何在多个组件间共享同一个数据集合?
      • 3. 如何为数据集合设置过滤条件?
    • 七、总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档