- 浏览: 283616 次
- 性别:
- 来自: 深圳
文章分类
最新评论
-
xlhtc007:
这篇文章写得不错!有空了好好学习一下你分享的这本书!
深入:FLASH视频播放传输方式——渐进式与流式 -
jelver:
不错,最近也在整cas
CAS单点登录连接超时解决办法及原因分析 -
bjlfp:
org.jasig.cas.authentication.ha ...
phpBB开源论坛单点登录整合 -
bjlfp:
先谢谢了!
phpBB开源论坛单点登录整合 -
iRoyce:
bjlfp 写道
cas server 端怎么配阿&n ...
phpBB开源论坛单点登录整合
Tapestry 5 组件参数
本文根据http://tapestry.apache.org/tapestry5/tapestry-core/guide/parameters.html翻译整理过来,请高手指正,转载请注明出处!
组件参数是Tapestry一个重要的方面。组件类实例的存在还不够,它必须还要配置以达到处理正确的事情。配置依据组件参数。
一个组件可以带有许多参数,每一个参数都有一个明确的名字、明确的Java类型(可以是一个简单类型),是可选的或必须的。
以下列出的是一个循环组件;通过它的start和end参数(用来设置循环的边界),组件的body将多次呈现(renders)。组件可以更新value参数(参数所在容器的属性),它能依据start或end哪一个大来自动加减:
package org.example.app.components;
import org.apache.tapestry.annotations.AfterRender;
import org.apache.tapestry.annotations.Parameter;
import org.apache.tapestry.annotations.SetupRender;
public class Count
{
@Parameter
private int _start = 1;
@Parameter(required = true)
private int _end;
@Parameter
private int _value;
private boolean _increment;
@SetupRender
void initializeValue()
{
_value = _start;
_increment = _start < _end;
}
@AfterRender
boolean next()
{
if (_increment)
{
int newValue = _value + 1;
if (newValue <= _end)
{
_value = newValue;
return false;
}
}
else
{
int newValue = _value - 1;
if (newValue >= _end)
{
_value = newValue;
return false;
}
}
return true;
}
}
参数名字来自属性名(去掉首字符"_" 和 "$")——实际情况是匹配getter方法"get"后字串。这里的参数名字是:"start", "end" 和 "value"。
绑定参数
<html t:type="layout" xmlns:t="http://tapestry.apache.org/schema/tapestry_5_0_0.xsd">
<p> Merry Christmas: <t:count end="3"> Ho! </t:comp>
</p>
</html>
end属性用来绑定Count组件的end参数,这里它被绑定到一个字符值"3",它将被Tapestry自动强制转换为int值3。
许多参数都可以采用这种绑定方式。
表达式绑定
前面例子模板中的值“3”是一个表达式绑定。通过在参数值前面使用不同的前缀,我们可以改变Tapestry如何解释表达式的剩余部分(冒号后面的部分):
前缀
|
描述
|
block
|
模板中block的id。
|
component
|
同一模板中另一组件的id。
|
literal
|
字面字符常量。
|
message
|
|
prop
|
容器组件属性名,用于读写。
|
translate
|
配置的translator的名字。
|
validate
|
被用来创建许多字段校验的校验说明。
|
参数有一个默认前缀,通常是"prop:",未指定前缀时用此前缀。
属性绑定
"prop:"绑定前缀意味着属性绑定。
属性绑定的表达式是一个点分隔的属性名序列。简单的属性表达式就仅仅是一个属性的名字,如:"prop:userName"。复杂的属性表达式可以在属性前加上部分导航来进行读写,如:"prop:userData.name"。
除了属性名之外,我们还可以调用任意方法,方法必须是公共的、返回一个非void值、抛出的异常为非检查型的且是无参的。为区分方法名和属性名,我们需要加上一个圆括号“()”。因此,先前的例可以写成"prop:getUserName()"和"prop:getUserData().getName()"。注意当表达式最后一项是一个方法名,绑定将是只读的,而非可读写的。
这一特性对于访问标准集合类一对的属性(没有命名相应的属性)来说非常有用,如Collection.size()或Map.keySet()。
一但获值失败,会不会因为这一表达式中存在空指针而绊倒?你可以使用"?."替换"."作为分隔符。这会增加一个空值检测,忽略掉表达项的空值。假设"foo?.bar?.baz"中foo或bar为null,表达式将会返回null,与此同时,"foo?.bar?.baz"中如果foo或bar为null,则更新此表达式将转变为一个空操作。
另外,还支持少数特殊的情况。大多数情况下,这些特殊的值可以减少你在值前面添加前缀"literal:"。这些少数情况相当于属性表达式:
- "true" 和 "false" 将被转换成布尔值。
- "null" 将被转换成值null。
- "this" 将是组件自己的引用。
- 简单的数字值也可以被接收,这些将会被解析成Long或Double对象。比如:"prop:3.14"。
- 被句点分隔的一个整数范围。如:"1..10"。
- 单引号里的字面字符串,如:"'Hello World'"。
这些情况下,多出的空格将被忽略。对于关键字("true","false","this" 和 "null"),忽略大小写。
这些值都是只读且无变化的。
验证绑定
绑定前缀"validate:"非常特殊,它允许一个简短的字符串来创建和配置对象执行的表单控制组件的输入验证,如TextField 和 Checkbox。
这些字符串是一个逗号分隔的验证类型(validator types)列表,验证类型是对象执行验证的简短别名。在许多情况下,验证是多方式可配置的:比如,一个强制最小字符长度验证,想知道最小的字符长度是多少的,这个值被指定在一个等号(=)后面。
如:validate:required,minLength=5强制该字段域必填且最少5个字符。
TODO: More ability to escape or quote constraint values. Ability to reference methods or properties of the container to perform some of the validation. Links to proper discussion of validation, once the code and documentation is ready.
转换绑定
非正式(informal)参数
一些组件支持非正式参数,额外的参数超过了正式定义的参数。非正式参数将在组件标签呈现时作为额外的属性输出。一般来说,组件与特有的HTML标签有1:1的对应关系(比如TextField和<input>支持非正式参数)。
非正式参数通常且于设置一个元素的样式,或者指定客户端的事件句柄(处理)。
非正式参数默认的绑定前缀依赖于指定的参数绑定方式。如果参数绑定在Java类中的Component annotation里面,这里的默认绑定为"prop:",如果参数绑定在模板中,默认的绑定前缀为"literal:"。这反映出用annotation使参数指定在Java类里,很可能就是一个用来计算的值,反之,一个指定在模板中的值将被简单的拷贝,按照原样输出到HTML(结果)流中。
参数双向性
参数并非简单的变量;在组件和它的容器组件(包含组件的组件)的属性之间,每一个参数等同于一个连接或者说绑定,当使用前缀prop:时,组件能将改变通过赋值的方式强制到它的容器组件的属性里。
<t:layout xmlns:t="http://tapestry.apache.org/schema/tapestry_5_0_0.xsd">
<p> Countdown:
<t:count start="5" end="1" value="index">
${index} ...
</t:count>
</p>
</t:layout>
因为Count组件更新value参数(_value属性),容器组件的index属性将被更新。在Count的body内,我们通过扩展表达式(等同于JSP中表达式语言)${index}输出当前index属性的值。输出结果大至如下:
<p> Countdown: 5 ... 4 ... 3 ... 2 ... 1 ... </p>
(尽管空格完全不同)
它们的关系是组件可以读取固定的值或者其容器组件中可变的属性值,同样能更改其容器组件中的属性值。
必选参数
必选参数必须要绑定。如果一个组件有未绑定的必选参数将会发生运行时异常。
可选参数
参数不是必要的,是可选的。
我们可以设置可选参数的默认值以提供其他属性使用。在Count组件中,参数 min有默认值为1,如果参数min绑定了一个值,则绑定的值将替代默认值。
参数的默认绑定
Parameter annotation的value()属性可以用来指定一个绑定的表达式,用以参数未绑定的情况下作为默认绑定。典型地,绑定的表达式是一个属性的名字,这个属性将会在运行时被计算值。
Example:
@Parameter("defaultMessage")
private String _message;
@Parameter(required=true)
private int _maxLength;
public String getDefaultMessage()
{
return String.format("Maximum field length is %d.", _maxLength);
}
在其他地方,我们可以在value上使用前缀。一个普通的前缀"message:"用以访问国际化信息(localized message)。
计算方式的参数默认绑定
方法名以"default"加上首字母大写的参数名。
使用这种方法,先前的例子可以写成:
@Parameter
private String _message;
@Parameter(required=true)
private int _maxLength;
@Inject
private ComponentResources _resources;
@Inject("infrastructure:BindingSource")
private BindingSource _bindingSource;
Binding defaultMessage()
{
return _bindingSource.newBinding("default value", _resources, "defaultMessage");
}
public String getDefaultMessage()
{
return String.format("Maximum field length is %d.", _maxLength);
}
:
在这个例子中,属性表达式"defaultMessage"用来动态访问信息。
以上例子可以写得更简洁:
@Parameter
private String _message;
@Parameter(required=true)
private int _maxLength;
@Inject
private ComponentResources _resources;
@Inject("infrastructure:BindingSource")
private BindingSource _bindingSource;
String defaultMessage()
{
return String.format("Maximum field length is %d.", _maxLength);
}
这种形式很像使用绑定前缀"literal:",但是字面值是通过defaultMessage()方法计算出来的。
显然,这要比简单地指定一个默认的参数值做更多的工作。
In the few real cases where this is approach is used, the default binding method will usually deduce a proper binding, typically in terms of the component's id. For example, the TextField component will deduce a value parameter that binds to a property of its container with the same name.
这种方法在一些少量的实际情况中被采用,默认的绑定方法将通常会根据组件的id产生适当的绑定。比如,TextField组件将产生value参数,用它容器中具有相同名字的一个属性绑定到此value参数。
默认的绑定方法只有在Parameter annotation未提供默认值时才被调用。
未绑定的参数
如果一个参数没有被绑定(可选参数),那么它的值可以在任何时候被读写。
更新对于未绑定的参数并没有作用。在第一个例子中,Count组件的value参数没有绑定,这完全是可以的。
注意:更新对于这个属性是临时性的;当组件完成呈现时,属性将被置为默认值。
TODO: This seems contradictory. What does it mean to update an unbound component parameter when the component is not rendering?
参数缓存
读取一个参数值会耗费不少资源的(因为类型的强制转换)。因此,缓存参数值是有意义的,至少当组件正在呈现自己时。极少情况下,我们可以通过设置Parameter annotation的cache()属性为false来打破这种缓存机制。
参数类型的强制转换
参数名
缺省情况,Tapestry将去掉首字母"$" 和 "_"的属性名转换为参数名。
我们也可以使用Parameter annotation的name()属性覆盖这种缺省情况。
决定是否绑定
public class MyComponent
{
@Parameter
private int _myParam;
@Inject
private ComponentResources _resources;
@BeginRender
void setup()
{
if (_resources.isBound("myParam"))
{
. . .
}
}
}
以上粗略举例这种方法。因为参数类型是简单类型int,我们很难区分没有绑定和显示地绑定0。
Inject annotation将注入组件的资源(ComponentResources),这些资源是我们写的Java类与Tapestry底层构建我们类的类之间的桥梁。任何情况,资源一但被注入,就可以被访问。
发表评论
-
Tapestry 4下扩展Yale CAS Java client filter
2007-04-30 16:40 3372Tapestry 4下扩展Yale CAS Java clie ... -
Tapestry 5 页面生命周期方法
2007-04-21 09:25 4909页面生命周期方法 本文根据http://tapestry. ... -
Tapestry 5组件事件
2007-04-01 00:09 7882Tapestry 5组件事件 本 ... -
Tapestry 5 输入验证
2007-03-22 16:00 6201Tapestry 5输入验证 本文根据http://tap ... -
Tapestry 5 页面导航
2007-03-16 23:50 5725Tapestry 5 页面导航 本文根据http:// ... -
获取Tapestry5学习资源——Maven与SVN
2007-03-16 14:09 6658获取Tapestry 5学习资源 ... -
Tapestry 5 组件模板
2007-03-15 00:02 5728Tapestry 5 组件模板 本文根据http:// ... -
Tapestry 5 组件类
2007-03-13 11:44 6376Tapestry 5 组件类 本文档根据 http://t ... -
Tapestry 5简介
2007-03-05 17:47 6033Tapestry 5简介 本文是在Tapestry官方文档的基 ... -
Tapestry页面国际化实现方式——权衡效率
2007-02-17 17:18 3646Tapestry国际化实现方式 ——权衡效率 在Tapest ... -
Annotation与Tapestry4.0页面拦截
2006-12-05 17:45 4554<o:p> </o:p> 在Tapes ...
相关推荐
在 Tapestry 5 框架中,自定义组件是扩展其功能的关键方式,它允许开发者根据特定需求创建个性化和可重用的 UI 元素。Tapestry 5 是一个强大的 Java Web 应用程序开发框架,它强调组件化、模块化以及声明式编程模型...
tapestry部分组件绑定参数的列表!
接下来,我们转向"tapestry组件.docx",组件是Tapestry的核心组成部分,它们是可重用的、自包含的代码单元,可以处理用户交互、展示数据或执行业务逻辑。组件可以是简单的HTML元素,也可以是复杂的UI部件。组件的...
- **链接生成**:生成安全、语义化的链接是Tapestry 5的强项,它会自动处理URL参数和安全需求。 6. **国际化和本地化** - **资源包**:使用资源包来管理多语言文本,支持应用的国际化。 - **时区支持**:...
在Tapestry中,开发者是通过对象及其方法和属性来构建应用程序的,而不是通过URL和查询参数。这种模式使真正的面向对象开发在Java Web应用程序中成为可能。 #### 2. 设置开发环境 为了开始使用Tapestry 5进行开发...
1. **组件化编程**:Tapestry 5 强调基于组件的开发模式,每个组件都是一个可重用的 UI 单元,这使得代码更易于管理和维护。 2. **自动表单处理**:Tapestry 5 自动管理表单提交过程中的数据绑定和验证,极大地简化...
5. **URL构建与参数映射**:遵循RESTful原则,Tapestry5支持优雅的URL结构,将URL与页面和操作关联起来,使得URL更具可读性,并且易于SEO优化。 6. **类重加载**:Tapestry5的类重加载特性极大地提升了开发效率,...
3. **类型安全的绑定**:Tapestry 5提供了类型安全的属性绑定,允许将表单字段或URL参数直接绑定到组件或页面的Java对象属性上,无需手动转换数据类型,增强了代码的健壮性。 4. **服务容器**:Tapestry 5使用依赖...
Apache Tapestry 5 是一个强大的 Java Web 开发框架,它通过组件化的设计理念,极大地简化了 Web 应用的开发过程。无论是对于初学者还是有经验的开发者来说,Tapestry 都是一个值得学习和使用的框架。通过掌握其核心...
**自定义组件** 是 Tapestry5 强大的地方之一,下面列举了一些常用的自定义组件: 1. **上传组件 Upload**:支持同步上传。 2. **ajax 上传图片组件 Uploads**:支持异步上传,提高了交互性。 3. **二级省市级联...
1. **请求处理**:当用户发起HTTP请求时,Tapestry会解析请求参数,确定目标页面和组件。 2. **组件实例化**:根据页面和组件定义,Tapestry 创建必要的组件实例。 3. **状态管理**:Tapestry 自动处理组件状态的...
组件之间可以通过参数进行数据传递,实现页面属性和组件属性的联动。 Tapestry遵循MVC(模型-视图-控制器)架构模式。在这里,组件扮演控制器的角色,连接模型层(业务逻辑)和视图层(HTML模板)。页面通过属性...
4. **类型安全的URL**:Tapestry 5.1提供了类型安全的URL映射,避免了传统URL参数的潜在错误。学习如何定义和使用页面链接和页面事件。 **二、高级组件与服务** 1. **内置组件**:Tapestry 5.1内建了许多有用的...
2. Tapestry 由“对象、方法、域”这些面像对象元素构成,但是它更关注于开发者关心的 Servlet API 的请求,回复,会话,属性,参数,URLs 等等开销。 3. Tapestry 关注的是如何联系用户的动作和这些动作所引响到的...
页面作为Tapestry组件,可以通过配置属性表达式与模型对象进行数据交互。属性表达式通常使用OGNL(Object Graph Navigation Language)来读取和更新Java Bean属性。OGNL是Tapestry中不可或缺的一部分,它简化了对象...
总结来说,Tapestry5是一个全面的Web开发解决方案,以其组件化、高效和易用性赢得了开发者们的青睐。通过深入学习和实践,开发者可以利用Tapestry5构建出更优雅、更易用、更安全且更具弹性的Web应用程序。
这部分内容没有提供,但通常可以创建一个Tapestry组件或服务,维护一个计数器状态,并在每次页面访问时增加。这将涉及组件的属性、方法以及事件处理。 Tapestry的组件系统非常强大,允许开发者定义自己的可复用...
Tapestry是一款强大的Java Web应用程序框架,由Apache软件基金会维护,它强调了组件化、类型安全和高可测试性。本开发指南将深入探讨Tapestry的核心概念、工作原理以及如何利用它来构建高效、可维护的Web应用。 1. ...
##### 第一节:熟悉Tapestry组件 **1. ForEach组件:** - **用途:**用于循环遍历集合或数组。 - **示例代码:** ```xml <tapestry:foreach each="${list}" var="item"> ${item.name} </tapestry:foreach> ``...