`
chinajavawolf
  • 浏览: 117086 次
  • 性别: Icon_minigender_1
  • 来自: 哈尔滨
社区版块
存档分类
最新评论

(A4)Tapestry Core :Component Parameters

TapestryApacheCSSCache 
阅读更多

本文翻译出处 http://tapestry.apache.org/tapestry5/tapestry-core/guide/parameters.html

本人翻译目的是用来学习Tapestry5的,共享出来希望大家批评指正。计划持续翻译。

chinajavawolf

组件参数
组件参数是Tapestry的一个很重要方面。组件类实例的存在还不足够，它必须被配置去做正确的事。配置要根据组件的参数。
组件可以拥有多个参数。每一个参数都有一个明确的名字，一个明确的Java类型（也可以是一个简单的值），并且是可选或必需的。
参数定义可以通过在私有属性上放置参数标注。
这个组件列出了一个循环组件；通过定义他的start和end参数(用来设置循环边界)，他的body将多次呈现.组件可以更新绑定在组件容器内属性的value参数，他将根据是start还是end大而自动进行加减。
  1. package org.example.app.components;   
  2.     
  3. import org.apache.tapestry.annotations.AfterRender;   
  4. import org.apache.tapestry.annotations.Parameter;   
  5. import org.apache.tapestry.annotations.SetupRender;   
  6.     
  7. public class Count   
  8. {   
  9.     @Parameter  
  10.     private int _start = 1;   
  11.     
  12.     @Parameter(required = true)   
  13.     private int _end;   
  14.     
  15.     @Parameter  
  16.     private int _value;   
  17.     
  18.     private boolean _increment;   
  19.     
  20.     @SetupRender  
  21.     void initializeValue()   
  22.     {   
  23.         _value = _start;   
  24.     
  25.         _increment = _start < _end;   
  26.     }   
  27.     
  28.     @AfterRender  
  29.     boolean next()   
  30.     {   
  31.         if (_increment)   
  32.         {   
  33.             int newValue = _value + 1;   
  34.     
  35.             if (newValue <= _end)   
  36.             {   
  37.                 _value = newValue;   
  38.                 return false;    
  39.             }   
  40.         }   
  41.         else  
  42.         {   
  43.             int newValue = _value - 1;   
  44.     
  45.             if (newValue >= _end)   
  46.             {   
  47.                 _value = newValue;   
  48.                 return false;    
  49.             }   
  50.         }   
  51.     
  52.         return true;   
  53.     }   
  54. }   
参数名来源于属性名(通过去除前面的“_”和“$”字符).这里，参数名是“start”，“end”和“value”。
绑定参数
上面的组件可以被其他组件或者页面模板所引用。
  1. <html t:type="layout" xmlns:t="http://tapestry.apache.org/schema/tapestry_5_0_0.xsd">  
  2.     <p> Merry Christmas: <t:count end="3"> Ho! </t:count>  
  3.     p>  
  4. html>  
End属性被用来绑定Count组建的end参数。这里，被绑定为string值“3”,Tapestry会自动强制将他转换为int值3.
许多参数都可以这样绑定。
组件参数也可以在组件类里通过组件标注绑定。
当两种绑定方式有冲突的时候，使用组件标注绑定的参数将接管在模板中绑定的参数。
绑定表达式
在前面的例子中模板值为3就是一个绑定了的表达式。
通过在值前面放置不同的前缀，你可以改变Tapestry如何解释表达式的剩余部分（冒号后面的部分）：
前缀
描述
block
模板中的block id.
component
同一个模板中的另一个组件的id.
literal
一个字面字符串。
message
从组件的信息目录中找回一个值。
prop
容器组件的属性名用来读写。
translate
配置的转换者的名字。
validate
一个被用来创建一些属性验证的验证规范。
参数有一个默认的前缀，通常是“prop:”,当没有提供验证的时候就用它。
属性绑定
前缀为“prop”的绑定就是属性绑定。
属性绑定的表达式是一个点分隔的属性名序列。简单的属性表达式就是一个属性名，“prop:userName”。 复杂的属性表达式可以在获得属性前加上少量导航来进行读写，如："prop:userData.name"。
除了属性名之外，你也可以调用任意方法。这个方法必须是公有的，返回一个非void值，抛出的是不需检查且无参的异常。你只需要通过添加圆括号就可以区分方法名和属性名了。这样先前的例子可以被重写成“prop:getUserName()”和“prop:getUserData().getName()”. 注意当表达式最后一项是一个方法名，绑定将是只读的，而非可读写的。
这一特性对于访问标准集合类的一对属性来说非常有用，如Collection.size()或Map.keySet()。
当获得失败的时候，是否会因为在这个异常里存在空指针而被绊倒呢?你可以使用“?.”来替换“.”作为分隔符。这会增加一个空值检测并且如果这项是空值将会忽略表达式。如果不是foo就是bar为null那么"foo?.bar?.baz"将会返回null，同样如果foo或bar为null，则"foo?.bar?.baz"将转变为一个空操作。
另外，还支持少数特殊的情况。在多数情况下，这些特殊的值可以省去你在值前面添加前缀"literal:"。这些少数情况对于属性表达式是可选的。
  • "true" 和 "false" 将被转换成布尔值。
  • "null" 将被转换成值null。
  • "this" 将是组件自身。
  • 简单的数字值也可以被接受，这些将会被解析成Long或Double对象。比如："prop:3.14"。
  • 被分隔成两个周期的一个整数范围。如："1..10"。
  • "单引号里的字面字符串，如："'Hello World'"。
在这些情况里，多余的空格是被忽略的。对于关键词(“true”,“false”,“this”和“null”)是被忽略大小写的。
这些值都是只读和不变的。
验证绑定
"validate:"绑定前缀非常特别，它允许一个简短的字符串被用来创建和配置对象执行表单控制组件的输入验证，如TextField 和 Checkbox。
这个字符串是一个逗号分隔的验证类型列表.这些简短别名对对象执行验证。在很多情况下，验证是可以多方式进行配置的：例如，一个验证强制一个字符串的所需的最小长度，最小的字符串长度是多少，这个值被指定在一个等号后面。
例如：validate:required, ,minLength=5 意思就是强制该字段必须填写并且且不得少于5个字符。
转换绑定
 
有效的转换列表通过TranslatorSource服务被配置。
非正式参数
一些组件支持非正式参数，额外的参数超过了正式定义的参数。非正式参数将在组件标签呈现时作为额外的属性被呈现。一般来说，组件与特别的HTML标签有1:1的对应关系（比如TextField和＜input＞支持非正式参数）。
非正式参数通常被用来设置一个元素的CSS样式，或者用来指定客户端的事件处理器。
非正式参数默认的绑定前缀依赖于指定的参数绑定在那里。如果参数绑定在Java类中的组件标记里，那么这个的默认绑定为"prop:"，如果参数绑定在组件模板中，默认的绑定前缀为"literal:"。这反映个事实，一个用标注在Java类里指定的参数，很可能就是一个计算的值，反之，一个在模板中的值将被简单的拷贝，按照原样放入到HTML结果流中。
参数是双向的
 
参数不是简单的变量；在组件和它的容器的属性之间，每一个参数代表一个连接或者绑定。当使用绑定前缀prop:时，组件能够通过赋值到他自己的实例变量里强制改变到该组件容器的属性中。
 
  1. <t:layout xmlns:t="http://tapestry.apache.org/schema/tapestry_5_0_0.xsd">  
  2.     <p> Countdown:   
  3.         <t:count start="5" end="1" value="index">    
  4.           ${index} ...    
  5.         t:count>  
  6.     p>  
  7. t:layout>  
 
因为Count组件更新value参数（_value属性），容器组件的index属性被更新。在Count的body内，我们通过扩展表达式${index}输出当前index属性的值。输出结果大至如下：
 

Countdown: 5 ... 4 ... 3 ... 2 ... 1 ...

（尽管空格完全不同）
 
相关的部分是组件可以读取固定的值或者他的容器中可变的属性值，并且能更改其容器中的属性值。
必选参数
必选参数必须要被绑定。如果一个组件没有绑定必选的参数将会发生运行时异常。
可选参数
参数不是必需的，是可选的。
你可以设置一个默认值给可选参数为其他属性使用。在Count组件中，参数 min有默认值为1，如果参数min绑定了一个值，则绑定的值将替代默认值。
参数的默认绑定
参数标注的value()属性可以被用来指定一个绑定的表达式，用来当参数未绑定的时候作为默认绑定。典型地，绑定的表达式是一个属性的名字，这个属性将会在运行时被计算值。
例如:
  1. @Parameter("defaultMessage")   
  2.  private String _message;   
  3.     
  4.  @Parameter(required=true)   
  5.  private int _maxLength;   
  6.     
  7.  public String getDefaultMessage()   
  8.  {   
  9.     return String.format("Maximum field length is %d.", _maxLength);   
  10.  }   
 
在别处，你可以在value上使用前缀。一个普通的前缀"message:"用来访问本地化信息。
 
计算参数默认绑定
在少数情况下，你可能需要用计算绑定的方式来作为参数的默认值。此时，你可以提供一个默认的无参的绑定方法。方法的返回值被用来绑定参数。返回值可以是一个绑定实例或者是一个简单的值（比较多的使用）。
 
方法名以"default"加上首字母大写的参数名。
 
使用这种方法，前面的例子可以写成这样：
 
  1. @Parameter  
  2.  private String _message;   
  3.     
  4.  @Parameter(required=true)   
  5.  private int _maxLength;   
  6.     
  7.  @Inject  
  8.  private ComponentResources _resources;   
  9.     
  10.  @Inject("alias:BindingSource")   
  11.  private BindingSource _bindingSource;   
  12.     
  13.  Binding defaultMessage()   
  14.  {   
  15.     return _bindingSource.newBinding("default value", _resources, "defaultMessage");   
  16.  }   
  17.     
  18.  public String getDefaultMessage()   
  19.  {   
  20.     return String.format("Maximum field length is %d.", _maxLength);   
  21.  }   
 
在这个例子中，属性表达式"defaultMessage"被用来动态访问信息。
 
再换一个，上面的例子可以被写得更简洁：
  1. @Parameter  
  2.  private String _message;   
  3.     
  4.  @Parameter(required=true)   
  5.  private int _maxLength;   
  6.     
  7.  @Inject  
  8.  private ComponentResources _resources;   
  9.     
  10.  String defaultMessage()   
  11.  {   
  12.     return String.format("Maximum field length is %d.", _maxLength);   
  13.  }    
 
这种形式更像使用"literal:"绑定前缀，只是字面值是通过defaultMessage()方法计算的。
 
很明显，这要比简单地用参数标注指定一个默认的参数值做更多的工作。这种方法在一些少量的实际情况中被使用，默认的绑定方法将经常会依据组件的id产生正确的绑定。例如，TextField组件将产生一个value参数绑定到它容器中具有相同名字的一个属性。
默认的绑定方法只有在参数标注没有提供默认值时才被调用。
没有绑定的参数
 
如果一个参数没有被绑定（可选参数），那么它的值可以在任何时候被读写。
 
更新对于未绑定的参数不起作用。在第一个例子中，Count组件的value参数没有绑定，这完全是有效的。
 
注意：更新对于这样的属性是临时性的；当组件完成呈现时，属性将被恢复为默认值。
参数缓存
读取一个参数值会耗费不少资源（因为类型的强制转换）。因此，缓存参数值是有意义的，至少当组件正在呈现自己时。
只有在极少情况下去掉缓存是有意义的。可以通过设置参数标注的cache()属性为false来实现。
参数类型强制转换
Tapestry包含一个自动强制类型转换机制。大多情况下，它被用来将字面字符串转换成相应的值，但在许多情况下，将发生更复杂的转换。
参数名
默认情况，Tapestry通过去掉首字母"$" 和 "_"的属性名转换为参数名。
 
也可以使用参数标注的name()属性。
决定是否绑定
极少数情况，你需要依据参数是否绑定来产生不同的行为。这可以通过查询组件资源来完成，组件资源可以通过injected标注注入到组件中：
  1. public class MyComponent   
  2. {   
  3.  @Parameter  
  4.  private int _myParam;   
  5.     
  6.  @Inject  
  7.  private ComponentResources _resources;   
  8.     
  9.  @BeginRender  
  10.  void setup()   
  11.  {   
  12.       if (_resources.isBound("myParam"))   
  13.       {   
  14.         . . .   
  15.       }   
  16.  }   
  17. }  
以上粗略举例这种方法。因为参数类型是简单类型int，很难区分没有绑定和明确地绑定0。
Inject标注向组件将注入组件的资源。这些资源是连接你提供的Java类与Tapestry底层构建你的类之间的桥梁。任何情况，资源一但被注入，就可以被访问。
分享到：
| (A3)Tapestry Core:Component Templates
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

    Tapestry.5.Building.Web.Applications.pdf

    ### Tapestry 5：构建 Web 应用程序 #### 一、Tapestry 5 概述 Tapestry 5 是一个强大的 Java Web 开发框架，它为开发者提供了高效且简洁的方式去创建复杂的 Web 应用程序。本书《Tapestry 5：构建 Web 应用程序》...

    Tapestry5.1-Component工程源码

    Tapestry是一项基于组件的web展现层技术,这里将它划分成业务工程HelloTapestry及Component工程源码两项.实际项目中,Component可以成为不同项目中抽离出来的通用的模块,与具体的业务脱离。

    Tapestry字典0.1.pdf

    - **实现方式**: 通过`&lt;tapestry:link&gt;`标签或`&lt;tapestry:component&gt;`中的`href`属性来实现页面间的跳转。 - **应用场景**: 用户操作后导航到新的页面。 **1.3 初始化** - **初始化方法**: `init()`方法是在组件...

    Tapestry开发

    &lt;tapestry:propertySelection name="country" label="Country" model="${countries}" /&gt; ``` **14. Table组件：** - **用途：**用于创建表格。 - **示例代码：** ```xml &lt;tapestry:table data-model="${users}...

    tapestry源码 api等

    1. **Tapestry Core**: 这是Tapestry框架的基础部分，包含了核心组件、服务容器（Tapestry IoC）和页面生命周期管理。通过源码分析，我们可以理解其如何实现页面组件的渲染、事件处理和依赖注入。 2. **Tapestry ...

    tapestry学习入门资料

    "tapestry学习入门资料" Tapestry 是一个开源的基于 servlet 的应用程序框架，它使用组件对象模型来创建动态的、交互的 web 应用。 Tapestry 使得 Java 代码与 HTML 完全分离，利用这个框架开发大型应用变得...

    apache-tapestry-5.3.8-bin.zip

    2. **Tapestry Core**：`tapestry-core-5.3.8.jar`是Tapestry框架的核心库，包含了框架的基础组件、服务和API。它提供了页面、组件、事件处理、URL映射等功能，是构建Tapestry应用的基础。 3. **Plastic**：`...

    优化大使tapestry-bin-5.0.18.zip

    这个压缩包包含了多个以"Tapestry"开头的子文件，如 "tapestry-core", "tapestry-hibernate", "tapestry-ioc", "tapestry-upload", 和 "tapestry-spring"，这些都是Tapestry框架的不同模块或插件。这些文件的后缀是...

    tapestry-react：Apache Tapestry和React的集成

    挂毯React 将React（ ）与Tapestry（ ）一起使用。 该库提供了将Tapestry与JSX模板结合... define ( [ 't5/core/dom' , 'react' , 'react-dom' ] , function ( dom , React , ReactDOM ) { var HelloMessage = React

    tapestry官方中文文档

    Tapestry是一款强大的Java Web应用程序框架，由Apache软件基金会维护，它强调了组件化、模块化和可重用性，使得开发复杂的Web应用变得更加简单。本文将深入介绍Tapestry 4的相关知识点。 1. **组件化编程**： ...

    Tapestry5.0.7

    - **tapestry-core**：Tapestry的核心库，包含了框架的主要功能和API。 - **tapestry-test**：测试支持模块，提供了针对Tapestry应用的单元测试和集成测试工具。 - **tapestry-spring**：Tapestry与Spring框架的...

    tapestry-bin-5.1.0.5

    8. **tapestry-hibernate-NOTICE.txt, tapestry-hibernate-core-NOTICE.txt, tapestry-ioc-NOTICE.txt**：与对应的LICENSE文件类似，这些NOTICE文件列出了在Tapestry的这些特定模块中使用到的第三方组件和它们的版权...

    Tapestry简单入门.rar_java Tapestry_tapestry

    Tapestry是一款强大的Java Web应用程序框架，由Apache软件基金会维护，它提供了一种基于组件的模型来构建动态、数据驱动的Web应用。本教程将帮助初学者了解Tapestry的基本概念，带你逐步入门并掌握其核心组件的使用...

    tapestry5 build web application-alexander

    《Tapestry 5：构建Web应用程序》是关于Tapestry 5框架的一本权威指南。Tapestry 5是一个强大的Java Web应用框架，由Apache软件基金会开发并维护，它致力于提供一种更高效、更优雅的方式来构建动态、交互式的Web应用...

    深入浅出Tapestry

    资源名称：深入浅出Tapestry内容简介：本书以循序渐进的方式，从Tapestry框架技术的基本概念入手，讲解Tapestry框架在J2EE Web应用程序中的整体架构实现。使读者在学习如何使用Tapestry框架技术的同时，还能够获得在...

    Tapestry4开发指南

    《Tapestry4开发指南》是由干煸四季豆编写的，旨在帮助开发者深入理解并熟练运用Tapestry4这一框架进行应用开发。Tapestry4是一个基于Java的Web应用程序框架，它强调组件化、模版驱动和声明式编程，极大地提高了开发...

    Tapestry5, Packt.Publishing.Tapestry.5.Building.Web.Applications.Jan.2008.RETAiL.eBOOk-sUppLeX.pdf

    ### Tapestry5：构建Web应用程序 #### 一、Tapestry5概述 Tapestry5是一种先进的、基于Java的Web开发框架，它以其强大的功能、灵活性以及易用性著称。该框架由Howard Lewis Ship创建，并由Apache软件基金会维护。...

    (Tapestry)An infrastructure for Fault-Tolerant Wide-area Location and Routing.ppt

    Tapestry是一个分布式系统基础设施，专门设计用于实现容错性的广域定位和路由。这个系统由Ben Y. Zhao、John Kubiatowicz和Anthony D. Joseph等人在加州大学伯克利分校的计算机科学部开发，旨在应对无处不在计算的...

    tapestry-project-4.1.5

    《深入理解 Tapestry 4.1.5：项目实例与核心库解析》 Tapestry 是一个基于 Java 的开源Web 应用程序框架，它强调组件化开发，提供了一种强大的方式来构建动态、高性能的Web 应用。在"tapestry-project-4.1.5"这个...

Magicbox
Global site tag (gtag.js) - Google Analytics