原创作者: chinajavawolf
阅读:1160次
评论:0条
更新时间:2011-05-26
本人翻译目的是用来学习Tapestry5的,共享出来希望大家批评指正。计划持续翻译。
chinajavawolf
符号
Tapestry IOC 使用运行时-评估符号(runtime-evaluated symbols)处理配置任务的特定类型。
符号的语法格式基于Ant表达式,也就是说,第一位为$ {符号名前,然后结尾}在后。在内的值是这个符号名。通过命名约定,这个符号名按照周期分割。
这些符号被用在Value和InjectService标注内。
例如:
- public static MyService build(
- @InjectService("${some-service-id}") Collaborator collab)
- {
- return . . . ;
- }
这里,符号some-service-id是一个服务id,比如WackyCollaborator。
尽管没在这里显示, 以符号在字符串、或混合实字文本内使用多个符号是可能的。
符号解析
符号通过SymbolSource服务处理。SymbolSource核对一个SymbolProvider对象的有序列表。
另外的符号提供器可以通过贡献给tapestry.ioc.SymbolSource服务配置被使用,这个配置是一个有序的SymbolProviders列表。
默认,有三个提供器:
1. SystemProperties
一个提供器允许JVM System Properties提供符号值。这允许使用java 命令的 –D 选项来提供运行时替代。当测试代码识这最常用,由于用在产品阶段。
2. ApplicationDefaults
在System Properties内没有找到值,就在ApplicationDefaults内搜索。这个服务,ApplicationDefaults可以使用映像配置提供值。
来自前面的例子:
- public void contributeApplicationDefaults(MappedConfiguration<String, String> configuration)
- {
- configuration.add("some-service-id", "WackyCollaborator");
- }
3. FactoryDefaults
与ApplicationDefaults一样,但只有在如果通过SystemProperties或ApplicationDefaults提供的值不满意的时候才核对。
Libraries将会代表性的设置合理的默认作为贡献给FactoryDefaults服务配置。个别的应用可能硬编码替代那些ApplicationDefalults默认应用。个别的开发者甚至可能通过设置JVM System Properties替换那些默认。
递归符号
这是可能并有效的根据一个或多个符号定一个符号。
- public void contributeFactoryDefaults(MappedConfiguration<String, String> configuration)
- {
- configuration.add("report.url", "http://${report.host}:${report.port}/${report.path}");
- configuration.add("report.host", "www.myreportsite.com");
- configuration.add("report.port", "80");
- configuration.add("report.path", "/report.cgi");
- }
对于report.url的默认将会是http://www.myreportsite.com:80/report.cgi.
然而,这可以通过制造一个替代的贡献给ApplicationDefaults服务配置来改变。
Tapestry 检查没有符号直接或间接的依赖自身。例如,下面的贡献是违法的:
- public void contributeApplicationDefaults(MappedConfiguration<String, String> configuration)
- {
- configuration.add("report.path", "${report.url}/report.cgi");
- }
当report.url被引用,一个异常将抛出信息是:符号'report.path'被递归定义((report.path --> report.url --> report.path)。
评论 共 0 条 请登录后发表评论