
作为 OneCode 框架中的核心组件,ComboInput 一直以来都是处理复杂输入场景的利器。而在 OneCode3.0 版本中,ComboInput 组件通过全新的注解体系重构,实现了更高效、更灵活的开发体验。今天,我们就来深度剖析 OneCode3.0 ComboInput 的新特性和技术实现。
OneCode3.0 对 ComboInput 组件的最大改进,莫过于注解体系的重构。在旧版本中,数据属性、字段属性和通用属性分散在各个组件注解中,导致代码复用性低、维护困难。3.0 版本通过以下方式实现了注解的清晰拆分:
@CustomAnnotation 负责配置组件的通用属性,如 id、caption 等@ComboBoxAnnotation 专注于下拉框的容器配置,如列表宽度、高度等@ComboInputAnnotation 定义字段相关的属性,如输入类型、提示信息等@CustomListAnnotation 统一管理数据集合,支持动态加载和过滤这种拆分遵循了单一职责原则,使得每个注解的职责更加明确,代码结构更加清晰。
OneCode3.0 ComboInput 组件的子组件结构关系可以用以下图形表示:
+-------------------+
| CustomAnnotation |
+-------------------+
^
|
+---------+---------+
| |
| |
+--------+ +------+------+
| | | |
| | | |
+--------v----v-+ +-------v--------+
| ComboBoxAnnotation | | ComboInputAnnotation |
+----------------------+ +-----------------------+
^ ^
| |
+---------+---------+ +---------+---------+
| | | |
| | | |
+--------+ +------+ +--------+ +------+
| | | | | | | |
| | | | | | | |
+--------v----v-+ +---v--------v----v-+ +---v--------+
| ComboHelpAnnotation | | ComboFileAnnotation | | ComboDateAnnotation |
+---------------------+ +--------------------+ +---------------------+
+-------------------+
| CustomListAnnotation |
+-------------------+
^
|
+---------+---------+
| |
| |
+--------+ +------+
| | | |
| | | |
+--------v----v-+ +---v--------+
| ComboGetterAnnotation | | 其他数据集合注解 |
+-----------------------+ +------------------+从图中可以看出,@CustomAnnotation 是所有组件的基类,负责配置通用属性;@ComboBoxAnnotation 和 @ComboInputAnnotation 分别负责容器和字段属性;而 @CustomListAnnotation 则独立管理数据集合。
@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、是否只读、是否隐藏等通用属性。
@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 属性用于指定下拉列表数据的键名。
@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 属性用于指定输入类型。
@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 新增的注解,用于统一管理数据集合。它支持动态加载、过滤和枚举值设置,提高了数据的复用性和可维护性。
// 下拉框示例 - 结合多个注解
@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();
}// 带懒加载的下拉框
@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);
}@CustomAnnotation、@ComboBoxAnnotation 和 @ComboInputAnnotation 的使用场景。id 是唯一的,避免冲突。@CustomListAnnotation 的 dynLoad 属性实现动态加载,提高性能。@ComboBoxAnnotation,字段属性使用 @ComboInputAnnotation,通用属性使用 @CustomAnnotation。@CustomListAnnotation 定义独立的数据集合,避免重复实现数据获取逻辑。可以通过 @CustomListAnnotation 的 dynLoad 属性实现数据源的动态加载。设置 dynLoad = true,并实现数据获取方法。
使用 @CustomListAnnotation 可以轻松实现数据集合的共享。只需要定义一个数据集合,然后在多个组件中通过 listKey 属性引用它即可。
可以使用 @CustomListAnnotation 的 filter 属性来设置过滤条件。过滤条件可以包含参数,参数值可以从上下文中获取。
OneCode3.0 ComboInput 组件通过注解体系的重构,实现了更高效、更灵活的开发体验。它遵循单一职责原则,将通用属性、容器属性、字段属性和数据集合分离,提高了代码的复用性和可维护性。
无论是简单的下拉选择,还是复杂的文件上传、日期选择,OneCode3.0 ComboInput 组件都能满足你的需求。通过合理选择和配置注解,你可以快速构建出高质量的用户界面,提高开发效率和用户体验。
如果你还没有尝试过 OneCode3.0 ComboInput 组件,那么现在就是最好的时机。相信它会给你的开发工作带来全新的体验。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。