(A16)Tapestry Core ：Injection with Components

本文翻译出处 http://tapestry.apache.org/tapestry5/tapestry-core/guide/inject.html

本人翻译目的是用来学习Tapestry5的,共享出来希望大家批评指正。计划持续翻译。

chinajavawolf

    

组件注入

注入是 Tapestry 使用的一个重要概念。 Tapestry Ioc 容器（ Tapestry IoC container ）使用一种注入，通过参数提供服务建造者方法（ service builder methods ）。

对于组件， Tapestry 使用了一个完全不同的方针：直接注入到实例变量里。

注入标注

注入标注 (Inject annotation) 被用来确定字段域将包含注入服务和其他资源。

Tapestry 支持两种注入：

1.        外在的注入， 特殊的服务被指定注入

2.        默认的注入， Tapestry 决定对象注入进字段域基于他的类型。

在这两种方案里，字段域被转变为一个只读的值。对于 Tapestry ，这种转变发生在运行时（对于能够测试你的组件方面这是非常重要的）。试图更新一个注入的字段域将产生运行时异常。

另外，有少数特殊的情况被特定的字段类型或附加标注触发，另外，对于注入，是在字段域上。

•   Asset 注入

当 Path 标注也出现的时候，那么注入值（相对于组件的路径）将是一个本地化的 asset. 。

符号在标注值内被扩展。

•   Block 注入

对于 Block 字段域类型，注入标注的值是在组件模板内 < block > 元素的 id 。通常情况， block 的 id 通过字段域的名字确定（去掉前面的 ”_” 和 ”$” 符号）。在不适合的地方，可以制定标注的 id ：

1. @Inject  
2.   private Block _foo;   
3.      
4.   @Inject  
5.   @Id("bar")   
6.   private Block _barBlock;  

第一个注入将用 ”foo” 作为 Block 的 id （通常，此情况被忽视）。第二个注入将用 ”bar” 作为 Block 的 id 。

•   注入资源

对于一些特殊的字段域类型， Tapestry 将注入组件相关的资源，例如它的 Local

一个非常通用的例子，当一个组件需要访问他的资源时，这个组件可以定义一个适当的字段域类型并且用无值的注入标注。

1. @Inject  
2. private ComponentResources _resources;   

Tapestry 使用 ComponentResources 类型的字段域去确定注入什么在这个字段域里

下面的类型被支持作为资源注入：

1.        java.lang.String

完整的组件 id, 其中包含了容器页的完整的类的名称和页面内嵌套的组件 id.

2.        java.util.Locale

组件的 Locale( 一个页面内的所有组件使用同一个 locale)

3.        org.apache.commons.logging.Log

为组件配置的日志实例，基于组件的类名。

4.        org.apache.tapestry.ComponentResources

组件的资源，经常用来产生涉及组件的链接。

5.        org.apache.tapestry.ioc.Messages

组件的信息目录用来产生本地化信息。

外在的服务注入

这里，一个特殊的对象被请求。一个 Service 标注被用来确定服务名。

例如：

1. @Inject  
2. @Service("Request")   
3. private Request _request;  

默认注入

当类型和其他注解都不足以确定对象或服务的注入 , Tapestry 求助于两个保留步骤 . 它假定字段域类型将通过服务接口被用来识别一个服务 .

第一个步骤，被别名服务创建的对象提供者被参考。当有一个以上的实现了同一个服务接口的服务时，这个对象的提供者被用来消除注入歧义。

第二个步骤，发生搜索唯一个实现接口的服务。如果不是没有实现接口的服务就是有多余一个得服务，那么这将失败。在后一种情况下，你必须消除歧义，不是用提供一个别名服务就是用 @Service 标注明确确定服务。

定义新的注入逻辑

匿名注入通过 InjectionProvider 服务被控制。对于这个服务的配置是一个控制组件注入的指挥系统。