浏览 3596 次
|
精华帖 (0) :: 良好帖 (0) :: 新手帖 (0) :: 隐藏帖 (0)
|
|
|---|---|
| 作者 | 正文 |
|
发表时间：2007-05-10
本文翻译出处 http://tapestry.apache.org/tapestry5/tapestry-core/guide/rendering.html 本人翻译目的是用来学习Tapestry5的,共享出来希望大家批评指正。计划持续翻译。
组件呈现 Tapestry4 方法
呈现是一个递归的过程。每一个组件实现了一个render()方法（从一个Irender接口继承）。组件将对其模板内的对象调用render()方法，包括其他的组件。
Bruce Tate曾说“如果你有眩晕症，不要站在JavaServer Faces堆栈边向下看”这句话同样可以应用在Tapestry4 。一旦你有很深的嵌套，循环组件，堆栈就会变得非常深。
Tapestry5 方法
组件呈现基于状态机和队列而不是尾递归。这打破了呈现在小块中处理，那样可以容易被实现或取代。不用担心，事实上，这只需要写非常少的代码。
呈现阶段
每个组件的呈现被分为许多阶段，如下图：
 每个橙色的阶段（SetupRender, BeginRender, BeforeRenderBody, 等）与你类中一个或多个方法上放置的标注相对应。标注指示Tapestry调用你的方法作为那阶段的一部分。
被这些标住标记的方法被称为呈现阶段方法。
你的方法应该返回void或者返回一个boolean值。返回值能够强制阶段被跳过,或者可以被重新访问。在这个图里，实线显示的是正常的处理路径。当你的呈现阶段方法返回false而不是true或者void时，虚线代表的备用流将被触发。
呈现阶段方法可以不带参数，或者带一个MarkupWriter类型的参数。方法可以是你愿意的任何可见度，通常使用包级私有，这样的可见度可以让你不用使组件方法为public API就可以测试你的代码（同一个包）。
这些方法是可选的，默认的行为是关联每一个阶段。
一般，你的代码将用到SetupRender, BeginRender, AfterRender 和CleanupRender阶段，通常是这些阶段中的一个或两个。
下面是一个用来在两个值之间上下循环的组件源码，多次在他的body内呈现，并将当前的index值放入参数内。
从next()方法的flase值将引发Tapestry重新运行BeginRender阶段，并且从那里，重新呈现组件的body(这个组件没有模板)。返回true过渡到CleanupRender阶段。
注意 Tapestry 是如何适应你的方法的，可以通过标注记号，也可以根据叁数; 这里的两个被标注的方法没有执行任何的输出，因此他们不需要一个 MarkupWriter
真正兴奋的是模板和组件的body将常常包含更多的组件！这意味着很多不同的组件将在他们自己的状态机制的不同阶段。
这是一个你可以执行任何为你的组件呈现以前设置的地方。这是一个用来读组件参数和用他们设置临时实例变量的好地方。
对于组件这个呈现标签应该在开始标签处被呈现（闭合标签应该在AterRender阶段里被呈现）。组件同样能够防止模板或body由于返回flase被呈现。
组件可以有或没有一个模板。如果组件有模板，那么模板包括一个< body >元素，然后BeforeRenderBody阶段将被触发（让组件选择呈现还是不呈现他的body）。
如果组件模有< body >元素在模板里，那么BeforeRenderBody阶段不会被触发。
如果被BeginRender标注的方法，那么当这个阶段的时候没有特殊的输出方法。但是模板（如果存在）或body（如果当前没有模板，但是组件有body）将被呈现。
这个阶段是用来允许组件去修饰他的模板（在模板形成标签的周围创建标签）或者允许组件跳过他的模板的。
与组件body（组件充当容器模板的部分）相关的阶段。该BeforeRenderBody阶段是让组件的能够跳过body, 同时还呈现组件模板的其余部分(如果有).
如果没有方法被BeforeRenderBody标注，那么body将被默认呈现。当组件模板的< body >元素被展开时，这会再次发生，或者如果组件没有模板（但组件有body）时自动发生。
AfterRenderBody是body被呈现后执行的阶段；这只对组件的body发生。
这个阶段经常被用来呈现闭合标签以匹配BeginRender的起始标签。不管怎样，AfterRender阶段可以继续CleanupRender，或回退到BeginRender（就象上面的Count组件例子）。
如果没有方法被AfterRender标注，那么没有特殊的输出发生，然后CleanupRender阶段被触发。
CleanupRender是SetupRender的互补，他允许最后清除发生。
用方法名代替标注
如果你偏爱不用标注在你的方法上，你可通过为你的方法提供特定的名字这么做。需要的方法名是首字母小写的标注名：setupRender(), beginRender(),等。同标注呈现阶段方法一样，Tapestry对于可见度，返回值和参数是灵活的。
使用这个机制，先前的例子可以被重写成：
这样的风格是一种权衡:获利的一面是,代码更简单了简短了，方法名也是如此，在设计上是较为一致的,从一个类到另一个。损失的一面就是名字是固定的,可能在某些情况下，要比标注方法描述的信息要少 (initializevalue()和next()看起来能描述处更多的信息).
你当然可以搭配使用，在某些场合使用特定的命名呈现阶段方法，在其他场合使用标注呈现阶段方法。
呈现组件
无论如何，返回的组件将排在组件被被呈现之前，这个现行的组件继续呈现。
组件呈现甚至可以来自应用的一个完全不同的页面。
组件递归呈现是不允许的。
这个方法允许Tapestry 页面的呈现是高度动态的。
返回组件实例不是祈祷的短路方法，返回boolean值的方法是。因为可能有多个方法可以返回组件（这是不推荐的---错乱很快就会发生）。
方法冲突和排序
可能有多个方法被相同的呈现阶段标注。这包括同一个类中的方法，或者定义在一个类或者从其他类继承的混合方法。
混合中执行的顺序不能在当时被定义。
顺序始终是父类在前。在父类中定义的方法也总是在子类中定义的方法之前被调用。
AfterXXX阶段是BeginXXX 和BeforeXXX 的配对补充。通常元素在一个较早的阶段开始然后元素被闭合在AfterXXX阶段（在body和组件模板间呈现）。
In order to ensure that operations occur in the correct, and natural order, the render phase methods for these two stages are invoked in reverse order:
为了确保操作正确有序的方生，对于这两个时期的呈现阶段方法被倒序调用
1. 子类方法
2. 父类方法
3. 混合子类方法
4. 混合父类方法
目前,方法是按字母排序。有相同名字的方法通过参数数量排序. 但即使这样,这也不是一个好主意... 只定义一个方法,并且用它以你希望的顺序通知其他方法.
如果一个方法返回ture或false值，这将作短路处理。其他在这个阶段通常将被调用的方法将不被调用。
大多数呈现阶段方法将会返回void，以避免对同一阶段的其他方法短路。
声明：ITeye文章版权属于作者，受法律保护。没有作者书面许可不得转载。
推荐链接
|
| 返回顶楼 | |
|
发表时间：2007-05-21
非常感谢！
我用Webwork 2用了3年多，最近看了看Tapestry 5, 有的心动了。 我感觉Struts2/WebWork2对于Command模式的MVC框架来说，已经是相当完美了。当然不能比非java的ROR. 但是这种开发模式，重用、组件开发很麻烦。我尝试过自定义Webwork2的gird标签，很麻烦。后来还是采用extremetable了。我感觉采用T5会更简单一些。 当然，T5也有一个很大的问题，无法使用各种开源的标签。比如extremtable,displayTag等等。但是我想对于一个公司的核心框架来说，这些都不会问题，你完全可以自己开发。 |
| 返回顶楼 | |
|
发表时间：2007-05-21
Struts与WebWork都有着广泛的群众基础和广泛的技术资料，这是他们仍然存在的根基，Tapestry4与Tapestry5的资料太少了，所以导致群众基础也少，希望我微薄的努力，能够为Tapestry5的发展贡献一份力量。
|
| 返回顶楼 | |
chinajavawolf
