(A2)Tapestry Core:Component Classes

 

本文翻译出处 http://tapestry.apache.org/tapestry5/tapestry-core/guide/component-classes.html本人翻译目的是用来学习Tapestry5的,共享出来希望大家批评指正。计划持续翻译。

chinajavawolf

组件类

Tapestry5中的组件类比Tapestry4中的轻松容易很多。不在需要继承基类。类就是具体的类（没有抽象）也没有XML文件。仍然有一点是以Java标注形式进行配置的，但那些标注现在直接声明在你的类属性上要优于放在抽象的getters和setters方法上（这是Tapestry4的方案）。.

对于页面、组件和混合类都是使用同一种方法创建的。

组件类基础

在Tapestry5中创建页面和组件类是很容易的。

与Tapestry4不同，在Tapestry5中组件类不再是抽象的，也不用继承框架的基础类。他们都是单纯的POJOs对象。

只有一些约束：

类必须是公有的。

类必须在正确的包中，按照application configuration.。

类必须有一个标准的公用的无参的构造器。

以下是一个非常基础的组件：

package org.example.myapp.components;



import org.apache.tapestry.MarkupWriter;

import org.apache.tapestry.annotations.BeginRender;



public class HelloWorld

{

    @BeginRender

    void renderMessage(MarkupWriter writer)

    {

        writer.write("Bonjour from HelloWorld component.");

    }

}

这个组件只有一个工作用来输出一个固定的信息。

另一个和Tapestry4不同的是，这些方法不是必须为公有的。他们可以是你愿意的任何可见度方法。

组件包

组件类必须存在于适当的包内（这是对于运行时代码转换和类加载操作必须的）。

这些包存在于应用程序的根包下。

对于page页面，类应该放在root.pages下。页面的名字被映射到在这个包内的类名。

对于components组件，类应该放在root.components下。组件类型被映射到在这个包内的类名。

对于混合组件，类应该放在root.mixins.混合类型被映射到在这个包内的类名。

另外。对于应用程序要用到的共同的基础类，通常是抽象基础类，他们不被直接引用。这些应该不放在pages,components 或者mixins包内。因为他们随后会被有效的页面、组件和混合所替换。使用root.base包存放这些基础的类。

子文件夹/子包

类不是必须直接放在包里（pages,components,mixins等）。可以正确的创建一个子包用来存储这些类。这个子包名成为页面或者组件类型的一部分。这样你可以定义一个页面组件 com.example.myapp.pages.admin.CreateUser ，这个逻辑页面名（显示在URLs上的）就会是admin/CreateUser.

Tapestry 执行一些简化的最佳的逻辑页面名（或者是组件类型或者是混合类型） 。他检查看如果包名是一个前缀或者后缀不合格的类名就删除前缀或者后缀。最终的结果是一个类名像这样 com.example.myapp.pages.user.EditUser 将有一个user/Edit（不是user/EditUser）的页面名.这样的目的是为了提供一个简单自然的URLs.

页面 vs. 组件

在Tapestry5中二者的区别是非常非常小的。他们仅有的区别是包名。root.pages.PageName用于页面。root.components.ComponentType用于组件.

在Tapestry4中，页面和组件有着很大差别。 表现在当你的类从隔离接口和抽象层次继承的时候。

在Tapestry5中，页面仍旧用于表现。但已是真正的Tapestry内部类。页面组件仅是页面组件树的根组件。

类的转换

Tapestry 使用你的类作为一个起点。他在运行时转换你的类。这是必要的，原因就包括Tapestry如何处理在请求间缓存页面。

在大多数情况下,这些转变都是合理而无形的.

在几个有限的情况下，他们被遗漏—例如，需要一个被私有的实例变量—但是我们感觉设计模式在通常都将支持非常高水平的开发效率。

因为转换不会出现在运行时之前，事实上在你创建一个Tapestry程序，并且在构建程序阶段是不受影响的。此外，你的类在测试时是绝对简单的POJOs对象。

动态类重载

组件类的改变是被框架监听的。当类改变的时候将被重载。这允许你在不需要牺牲任何Java平台性能的情况下，构建应用的速度接近于脚本环境。

他是如此的快速。你都注意不到类魔术般的重载已经发生了。

最终的结果：卓越的生产能力---改变你的类，立刻就能够看到变化。

可是，类的重载只被应用在组件类上。其他的类，例如服务接口和实现，或者其他数据对象被普通的类加载器加载不被动态类重载。

实例变量

Tapestry 组件可以有实例变量（不像Tapestry 4,你不得不使用抽象属性）

实例变量必须是私有的。Tapestry必须执行运行时类的修改来支持实例变量，并且只对私有变量。在你的类中可以有非私有的变量，但是这样你就会在你的程序中看到不可预料的异常行为，这是因为Tapestry对页面和组件的缓冲和重用。对含有非静态并且非私有的属性变量，Tapestry将输出一个错误日志。

要知道的是你需要提供getter和setter方法以访问你类的实例变量。Tapestry不会自己做的。

瞬时的实例变量

除非一个实例变量被标注修饰，否则他将成为一个瞬时变量。这意味着当请求范围结束后他的值将被设回默认值（当页面被丛请求中分离时）。

如果你希望保留你的变量值在多个请求之间已打破重置逻辑，那么你应该在你的属性上增加一个Retain标注。你需要注意的是没有客户细节的数据被存在这个属性变量里，因为后面的请求，相同页面实例可能被不同用户使用。同样，相同用户后来的请求，也可能是不同的页面实例被使用。

使用持久属性在一个请求到另一个请求间保留信息.

此外，final属性是最终的。是不会被重置的。

构造器

Tapestry 将会使用默认的无参构造器来实例化你的类。其他的构造器将被忽略。

注入

依赖注入通过附加的标注发生在属性级别。在运行时，属性包含的注入会变成只读的。

参数

在你的类中组件参数也被定义为使用私有属性，使用参数标注。

持久化属性

属性被标注以便他们在请求间保留他们的值。

内嵌组件

组件经常包含其他组件。在其他组件的模板内部的组件被称为内嵌组件。这个包含内嵌组件的模板将包含Tapestry命名空间的专有元素，确定那个内嵌组件的位置。

你可以在模板中定义组件类型，或者你可以使用组件标注去定义组件类型和参数为组件产生一个实例变量。

例如

package org.example.app.pages;

import org.apache.tapestry.annotations.Component;

import org.example.app.components.Count;

public class Countdown

{

    @Component(parameters =

    { "start=5", "end=1", "value=countValue" })

    private Count _count;



    private int _countValue;



    public int getCountValue()

    {

        return _countValue;

    }



    public void setCountValue(int countValue)

    {

        _countValue = countValue;

    }

}

以上定义组件的内嵌组件

注意在组件类里默认的绑定前缀是"prop:"，在上面的例子中我们可以写成"value=prop:countValue"来完整的显示绑定。 

然而，某些字面值，比如上例中的数字字面值被接受绑定prop:前缀，即使他们并不是真正的属性（这给程序开发者带来了极大的方便）。我们也可以使用"literal:"前缀，"start=literal:5"可以完成同样的事情。我们可以在组件模板中指定其他的参数，但是组件类里的参数优先