3.6.1.3.6. 界面控制器依赖注入

这是旧版本的 API。对于从 7.0 开始的新 API，请参阅 界面控制器。

在界面控制器进行依赖注入可以用来请求有效对象的引用。基于这个目的，要求在控制器内声明一个相应类型的字段，或者写一个带有相应参数类型的访问方法（setter），使用下面注解之一：

  • @Inject – 最简单的方法，会按照 JavaBeans 规则搜索匹配字段/方法类型以及字段名称的对象用来注入。

  • @Named("someName") – 显示的定义目标对象的名称。

以下类型可以用来注入到控制器：

  • 在 XML 描述中定义的此界面的可视化组件。如果属性的类型是从 Component 类派生的，系统会搜索当前界面中相应名称的组件。

  • 在 XML 描述中定义的操作行为 - 参考 操作。

  • 在 XML 描述中定义的数据源。如果属性的类型是从 Datasource 派生，系统会搜索当前界面中相应名称的数据源。

  • UserSession。如果属性的类型是 UserSession，系统会注入当前用户会话的对象。

  • DsContext。如果属性的类型是 DsContext，系统会注入当前界面的 DsContext。

  • WindowContext。如果属性的类型是 WindowContext，系统会注入当前界面的 WindowContext。

  • DataSupplier。如果属性的类型是 DataSupplier，系统会注入相应的实例。

  • 任何定义在对应客户端 block 上下文的 bean。包括：

  • 如果以上提到的都不合适，并且控制器有友类，如果类型匹配的话当前客户端的友类会被注入。

还可以在控制器内注入传递给 init() 方法的 map 类型的参数，使用 @WindowParam 注解。此注解有 name 属性用来定义参数的名称（map 的键值）以及一个可选的 required 的属性。如果 required = true 并且 map 中没有相应的参数，则会在日志中添加一行 WARNING 的信息。

下面例子注入了传递给控制器 init() 方法的 Job 实体：

@WindowParam(name = "job", required = true)
protected Job job;