Tapestry入门-技术开发专区

Tapestry入门

作者：Hery Tang 编辑：李宁 2007-06-20 14:16

public void submit(IRequestCycle cycle)
...{
    String inputValue = getInputValue();
    String pigLatinValue = new PigLatinTranslator().translate(inputValue);
    setPigLatinValue(pigLatinValue);
 }

    你要提醒的第一件事或许是这个类为什么是抽象类。它还有几个抽象方法访问inputValue，pigLatinValue属性。这里利用了Tapestry会在运行时刻创建子类的功能，这个子类会创建你在页面规范里声明的属性和生成相应的访问方法。

    在表单提交时页面类的submit方法会被调用。为什么会这样？因为我们在页面模板里将Form控件的listener属性指定为：ognl:listeners.submit。这就意味着一个名叫submit的listener会通过页面类的listeners被访问。

    所有的页面类和控件类都从org.apache.tapestry.AbstractComponent这个类继承来一个叫listeners的属性。当submit方法完成后，页面会显示被翻译好的词。

    最后讲讲Web.xml这个Web发布描述文件。Tapestry,像许多其他的流行的Web应用框架一样，由一个Servlet构成，但是还需要一个发布描述文件。那个发布描述文件应该被存放在WEB-INF目录。

<?xml version="1.0"?>
 <!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd>
 <web-app>
 <display-name>Tapestry Pig Latin Translator</display-name>

 <servlet>
 <servlet-name>tapestry</servlet-name>
 <servlet-class>org.apache.tapestry.ApplicationServlet</servlet-class>
 <load-on-startup>1</load-on-startup>
 </servlet>

 <servlet-mapping>
 <servlet-name>tapestry</servlet-name>
 <url-pattern>/app</url-pattern>
 </servlet-mapping>
 </web-app>

    虽然Pig Latin翻译应用非常简单，但是它会让你对在Tapestry应用中一个页面的3个组成部分有了基本的了解。它也展示了创建一个Tapestry应用的一个页面只需写多么少的代码。

表单输入验证

    Tapestry 提供了一些控件以便校验用户的输入。校验子系统是ValidField控件的核心。在下面的登录应用中我们将使用ValidField控件。ValidField控件位于表单内，对用户在客户端的校验提供了有用的反馈和视觉上的错误提示。

区域化

    在Tapestry中，区域化是相当简单的。Tapestry允许文字和图形的区域化。为了区域化页面的内容，你可以为每一个添加一个properties文件，或者提供一个区域化的模板。为每个页面提供一个资源文件的方式远比管理和维护一个巨大的全局的应用范围的资源文件简单。如果页面的区域化并不仅仅只是文字信息的区域化，例如页面的布局不同或者组成的控件不同，这样情况提供区域化的页面模板就能派上用场了。我们会在下面的登录应用的使用Tapestry区域化。

创建控件

    Tapestry发布时提供了40多个自带的控件。如果你想知道更多的关于Tapestry自带控件的信息，请参考Tapestry Component Reference.想看看Tapestry的控件的应用范例可访问Tapestry Component Workbench.如果你发现你需要一个Tapestry本身没提供的控件，你可以自己创建一个。创建你自己的Tapestry控件跟创建一个页面是相似的。一个典型的Tapestry控件由一个控件规范文件（XML文档），一个HTML控件模板，一个实现了org.apache.tapestry.Icomponent接口的Java类。这个议题有点超出本文的范围，但是如果你有兴趣学习如何创建你自己的Tapestry控件，你可以参考Tapestry的原创人，Tapestry In Action 一书的作者--Howard Lewis Ship写的 Designing Tapestry Mega-Components 。

Tapestry 登录应用

    你在Pig latin翻译器应用中看到了Tapestry的一些基本特性。与其用一个复杂的应用展示Tapestry所有的特性以致于压得你揣不过气来，还不如通过一些简单的应用让你找到一点对Tapestry的感觉。下面这个应用展示Tapestry如何处理页面导航，区域化，验证和其他一些特性。

    这里有一个Home页的屏幕抓图，下面跟着它的页面模板。

第1页：第1页第2页：第2页第3页：第2页第4页：第4页第5页：第5页

关注我们