Tapestry 4.0 使用简要

来源：互联网发布：数据库通配符%表示什么编辑：程序博客网时间：2024/05/08 18:21

页面对象

在page文件中声明属性，可以不必在java文件中声明以及其get、set方法
t4默认getXXX()抽象方法中的XXX为页面属性，.page不用声明，并使用@InitialValue("value")赋初值.
页面对象实例会被缓存（有潜在非法访问问题），解决方法：
- 覆盖initialize()方法，初始化实例变量。（在放入缓存池时天会调用initialize()）
- 在.page中声明实例变量,.java声明get/set方法(可有可无)，t4自动生成代码初始化
- 实现PageBeginRenderListener接口，在页面render之前初始化参数，可防止空指针异常

开发调试

禁止缓存参数
- -Dorg.apache.tapestry.disable-caching=true -Dorg.apache.tapestry.enable-reset-service=true
调试参数
- set JAVA_OPTS="-Dorg.apache.tapestry.disable-caching=true" set JPDA_ADDRESS=8000 set JPDA_TRANSPORT=dt_socket catalina jpda start

activate()不会立即转页，它仅保存页面对象引用在IRequestCycle中。listener执行结束后才会转业。

获得转页页面对象

使用元数据inject页面和属性，可以不用在.page中进行声明

获得页面使用@injectPage("pageName")
t4中若发现该类包含一个未实现的“getXXX”方法，会默认产生一个实例变量XXX。该实例变量没有初始化方法，可以在getXXX()声明@InitialValue("literal:initValue")解决

表单验证

delegate
- 方案1：打印出错信息需要new一个ValidationDelegate。
- 方案2：.page文件中配置<bean>标签
- 方案3：.page中不配置<bean>，抽象方法上使用元数据@Bean
validators
- .page文件中每个需要验证的表单元素组件绑定一个validators
- 表达式：validators:+判断条件+[错误提示]
空输入问题
- t4默认空都可以验证通过
- 通过[value="validators:required"]来保证输入不为空
Fieldlable可以与TextField绑定显示错误信息
客户端验证
- 在Form组件中绑定<binding name="clientValidationEnabled" value="true"/>
若表单输入验证正确，逻辑上的验证应该在监听方法中进行
- 例如：苹果库存只有20，用户买进50，这是非法的
- 验证时应向ValidationDelegate记录出错信息
创建delegate
- delegate.setFormComponent((IFormComponent) getComponent("XXX"));
- delegate.recordFieldInputValue(Integer.toString(XXXX));
- delegate.record("XXX must be >=0",ValidationConstraint.TOO_SMALL);

每个页面对象都报含一个Map，保存bean。（没有则自动创建，返回页面池时bean自动销毁1）若要在.page中获得一个已定义的Bean，使用beans前缀调用。例如：beans.beanId.beanProperty。

For、Foreach使用时，要在.page中对<source>集合对象内的元素声明<property>。以方便t4，生成get、set方法。

组件复用

“Class@XXX”表示访问一个class的XXX静态方法或静态变量

判断按钮是否clicked三种方式

submit提交原理

监听方法获得参数的方式
- 1、实现IRequestCycle会的监听方法的参数
- 2、声明带正确参数顺序的监听方法，t4自动boxing
  - * public type method(parameters)
  - * public type method(IRequestCycle cycle, parameters)
  - * public type method()
  - * public type method(IRequestCycle cycle)
页面提交后，t4会从页面pool重新获得或创建page object。因此提交前后同一页面的页面对象引用是不一样的，实例变量可能会一样也不可能一样。
因此不要在页面对象在定义成员变量（包括页面组件对应的成员变量），因为跨页面访问他们总是无效的有潜在危险。
上面问题的解决方案
- 1、使用客户端持久化需要访问的持久化成员变量，声明get、set抽象方法，用@Persist("client")注释。使用时应判断get方法是否为null，因为这种持久化方式不会初始化变量
- 2、使用抽象get、set方法，由t4来实现。

HiveMind模块

session

获得方式
- 1、声明抽象方法，通过元数据injectState("ObjectName")注释
- 2、声明抽象方法，在.page中<inject>对象
判断存在方式
- annotation
  - 1、声明抽象方法，该方法命名格式为getXXX()或者isXXX()
  - 2、使用元数据注释@InjectStateFlag("sessionObj")
- .page声明<inject type="state-flag" property="userExists" object="sessionObj"/>
注销：使用Servicelink组件的restart service。该service删除sessionObj，并且从定向到首页。

t4通过无参的构造器来创建对象

安全处理

参数维护

客户端保存参数（推荐）
- 1、使用Hidden组件，并提供该属的get、set方法实现
- 2、使用元数据@Persist("client")，不能够声明abstract的set、get方法
session保存参数

snippets

默认表达式
- .html中为literal
- .page中为OGNL
  - property access
  - mathematical expressions
  - method invocations
  - reference static fields of public classes
  - create new objects, including lists and maps
URL中的sp，t3叫服务参数、t4叫监听参数
page对象查询
- 1、.page中声明
- 2、在.application声明org.apache.tapestry.page-class-packages中查找(推荐)
特殊页面组件
- 1、$remove$，删除该html元素（即仅去掉某元素）
- 2、$content$，只生成该元素标签间的的html code，该元素以外其它元素忽略去掉（即仅保留某元素标签内的内容）

国际化

html中使用技巧
- 1、<span key="hello">Hello</span>指名说用字典key
- 2、必须为<span>标签，且key自不必加前缀（如message：，OGNL：）
不同地区的页面风格，以XXX_CN.html这种方式命名
字典文件
- 1、每个page可以拥有一个poperties
- 2、在WEB-INF下建立${servletname}.properties，所有page共享

自定义组件

组件配置文件推荐最合理是放在WEB-INF下
contrib中的控件的使用
- <library id="contrib" specification-path="/org/apache/tapestry/contrib/Contrib.library"/>
input校验
- 推荐使用writer.beginEmpty("input")
- 使用writer.begin("input")和writer.end()
rewinding（重绕），可以理解为刷新
- form.isRewinding()
- cycle.isRewinding()
参数
- 组件参数初始化
  - .jwc中<parameter>设置初始化
  - finishLoad()方法中初始化
- 参数类型
  - formal：是被定义在组件规范中的组件参数。每个formal parameter有一个特定（区分大小写）的名称，并且被标为required或者optional。
  - informa：是Html元素的属性参数。

页面配置