论坛首页 → Java企业应用论坛 →

Tapestry 5 组件类

浏览 5098 次
锁定老帖子 主题：Tapestry 5 组件类
精华帖 (0) :: 良好帖 (0) :: 新手帖 (0) :: 隐藏帖 (0)
作者 正文
  • iRoyce
  • 等级: 二星会员
  • 性别:
  • 文章: 50
  • 积分: 172
  • 来自: 深圳
   发表时间：2007-03-13  
Tapestry 5 组件类
本文档根据 http://tapestry.apache.org/tapestry5/tapestry-core/guide/component-classes.html翻译整理过来，请高手指正，转载请注明出处！
 
Tapestry 5的组件类要比Tapestry 4简单些，它们没有要继承的基类、是具体而非抽象的且没有XML文件，不过还是存在少量的以Java annotations形式的配置，但现在那些都直接声明在类的属性上，优于声明在抽象的getters和settes方法上（Tapestry 4中）。
 
页面、组件和组件混入类都以同种方式创建。
组件类基础
在Tapestry 5中创建页面和组件轻而易举！
 
不同于Tapestry 4，Tapestry 5中组件类不再是抽象的且不继承框架的基类。它们是纯粹的POJOs（Plain Old Java Objects）。
 
仅具有少量约束：
§           类必须声明是公共的（public）。
§           类必须放在正确的包下，按照application configuration。
§           类必须具有一个标准公共的无参构造器。
 
以下是一个非常基础的组件：
 
java 代码
  1. package org.example.myapp.components;   
  2.     
  3. import org.apache.tapestry.MarkupWriter;   
  4. import org.apache.tapestry.annotations.BeginRender;   
  5.     
  6. public class HelloWorld   
  7. {   
  8.     @BeginRender  
  9.     void renderMessage(MarkupWriter writer)   
  10.     {   
  11.         writer.write("Bonjour from HelloWorld component.");   
  12.     }   
  13. }   
这个组件仅用来输出一个固定的信息。BeginRender annotation是一个组件生命周期annotation，用来告诉Tapestry什么时候在什么情况下调用你类中的方法。
 
还有一点与Tapestry 4不同的是，方法不再需要声明为公共的（public），可以具有你想要的任何可见性。
 
组件包
组件类必须存放在一个相应的包中（运行时代码转换和类重载的需要）。
这些包存放在应用根目录${root}包下。
 
页面类放置在${root}.pages下，页面名匹配于这个包下的类名。
 
组件类放置在${root}.components下，组件类型（组件模板中标签属性t:type的引用）匹配于这个包下的类名。
 
混入（mixins）类放置在${root}.mixins下，Mixin类型匹配于这个包下的类名。
 
另外，整个应用存在基类很常见，通常是一些抽象的基类，不需要直接被引用。这些不应直接放在pages、components、mixins包下，因为它们这时看起来是有效的pages、components、mixins，我们用${root}.base包来存放这些基类。
 
子文件夹/子包
 
类不必直接放入${root}包下（pages、components、mixins等等），可以创建子包来存放一些类。子包名将成为页面名或组件类型的一部分。因此你可以定义页面组件com.example.myapp.pages.admin.CreateUser，与此同时页面逻辑名（显示在URL上的）将会是admin/CreateUser。
 
页面与组件
 
在Tapestry 5中，页面与组件的区别已经非常小了。实际上仅有的不同就是包名：${root}.pages.PageName用于页面，${root}. components.ComponentType用于组件。
 
Tapestry 4中，页面与组件的区别很大，暴露出分隔的接口以及用于编码继承的抽象实现体系。
 
Tapestry 5中，页面仍用于表现，但它已真正成为Tapestry的内部（internal）类。页面组件仅仅是页面组件树的根组件。
 
类转换
 
Tapestry 以使用你的类做为出发点，在运行时对类进行转换，其原因就包括Tapestry如何在多个请求中缓存（pools）页面。
For the most part, these transformations are both sensible and invisible. In a few limited cases, they are maginally leaky -- for instance, the requirement that instance variables be private -- but we feel that the programming model in general will support very high levels of developer productivity.
类转换多半是合理的且不可见的，少数受限的情况下，它们的被忽略无关紧要——比如，一个实例需要是私有的——但是我们会发现设计模式通常会支持一个更高的开发效率。
 
因为转换发生在运行时，所以转换时并不会影响你实际中创建的Tapestry应用。此外，测试时你的类完全是简单的POJOs。
 
类重载
Component classes are monitored for changes by the framework. Classes are reloaded when changed. This allows you to build your application with a speed approaching that of a scripting environment, without sacrificing any of the power of the Java platform.
框架监视着组件类的改动，类改变时会被重载。Classes are reloaded when changed.这允许你在不需要牺牲任何Java平台能力的情况下，构建应用的速度接近于脚本环境。
 
实例变量
 
Tapestry组件可以包含实例变量（不同于Tapestry 4，你得使用抽象属性）。
 
实例变量必须是私有的。Tapestry将会执行运行时类的修改来支持实例变量，而且仅对私有变量有效。类中可以有非私有的变量，由于Tapestry池化和重新使用页面与组件，你这时会看到应用中的意外行为。对含有非静态且非私有的属性变量，Tapestry将输出一个错误日志。
 
注意你需要提供getter和settter方法访问你类的实例变量。Tapestry不会自动做这事。
 
瞬态实例变量
 
除非你的实例变量被annotation装饰，否则它就是瞬态的实例变量。这意味着它们的值在每一个请求结束时（当页面从请求中分离时）被重置为默认的值。
 
假如你的变量能够在多个请求中保持它的值，你就需要在变量上使用Retain annotation来打破这一重置的规则。你需要注意的是没有客户相关的数据存入在这个属性变量里，因为后面的请求，相同页面实例可能被不同用户所使用。与此同时，相同用户后来的发出请求，也可能是不同的页面实例被使用。
 
使用持久化属性变量（persistent fields）在多个请求中保持信息。
 
此外，final属性变量不会被重置。
构造器
Tapestry将会使用默认的无参构造器来实例化你的类。其它构造器将被忽略。
注入
依赖注入（Injection）通过附加的annotations发生在属性级别。在运行时阶段，属性包含的注入将变为只读性的。
参数
组件参数（Component parameters）也使用私有的类属性来表示，要在属性上加上Parameter annotation。
持久化属性
属性可以被加上annotation以便它们在跨请求中保持值。
内嵌的组件
组件通常包含其他组件，组件内置在其他组件里时就叫做内嵌的组件。包含内嵌组件的组件，其模板将包含<comp></comp>元素来识别内嵌组件放置在何处。
 
我们可以在模板中定义组件的类型，或者使用Component annotation定义组件类型与参数来创建组件实例变量，对于后者你不能提供<comp></comp>元素的类型属性，在模板中只提供id属性就行（假如你提供类型属性的话，Tapestry将会使用使用被annotation声明的属性的类型并输出一个错误日志）。
Example:
java 代码
  1. package org.example.app.pages;   
  2.     
  3. import org.apache.tapestry.annotations.Component;   
  4. import org.example.app.components.Count;   
  5.     
  6. public class Countdown   
  7. {   
  8.     @Component(parameters =   
  9.     { "start=5", "end=1", "value=countValue" })   
  10.     private Count _count;    
  11.     
  12.     private int _countValue;   
  13.     
  14.     public int getCountValue()   
  15.     {   
  16.         return _countValue;   
  17.     }   
  18.     
  19.     public void setCountValue(int countValue)   
  20.     {   
  21.         _countValue = countValue;   
  22.     }   
  23. }    
 
以上定义的内嵌组件id为"count"（此id源自属性的名字）。组件的类型是org.example.app.components.Count。Count组件的参数start和end绑定了字面值（literal values），value参数绑定了Countdown组件的countValue属性。
 
需要注意的是组件类里默认的绑定前缀是"prop:"，以上实例中我们可以写成"value=prop:countValue"来完整的显示绑定。
 
然而，某些字面值，比如上例中的数字字面值被接受为prop:前缀，即使他们并不是真正的属性（这给应用开发者带来了极大的方便）。我们也可以使用"literal:"前缀，"start=literal:5"可以完成同样的事情。
 
我们可以在组件模板中指定其他的参数，但是组件类里的参数优先。
TODO: May want a more complex check; what if user uses prop: in the template and there's a conflict?
我们可以利用Component annotation的id属性覆盖默认的组件id（即属性名）。
 
如果在组件类中定义一个组件，而模板中没有相应的<comp></comp>元素，Tapestry会输出一个错误日志。
返回顶楼
         
  • jamesby
  • 等级: 一钻会员
  • 性别:
  • 文章: 484
  • 积分: 845
   发表时间：2007-03-13  
论坛上研究Tapestry的人好像不多！
返回顶楼
          回帖地址
0 请登录后投票
论坛首页 → Java企业应用版

跳转论坛:
Global site tag (gtag.js) - Google Analytics