BlogJava-云自无心水自闲-随笔分类-Tapestry

Tapestry5 in action（manning)的第一章免费阅读

云自无心水自闲 — Mon, 28 Mar 2011 21:53:00 GMT

Tapestry5 in action现在还只是提供MEAP形式的订购，MEAP-Manning Early Access Program, 也就是提前试阅的意思，如果读者订购了此版本，那么manning会在作者每完成一章后，将该章节发给订购者，订购者可以提交自己的反馈，manning会根据情况发布相应的错误修改信息。

目前此书的第一章可以免费下载：

http://www.blogjava.net/Files/usherlight/Tapestry5%20in%20action%20MEAP%20ch01.zip

云自无心水自闲 2011-03-29 05:53 发表评论

Tapestry的一些最新动态

云自无心水自闲 — Tue, 23 Nov 2010 22:08:00 GMT

1、Tapestry5.2.4的发布，Tapestry5.2.3版本在内部投票中被否决（主要是因为使用maven快速创建的原型有问题），所以在被否决的3天后便发布了5.2.4,相对5.2.2来说，变动并不大，只有8个错误修复和5个功能改进。但是至少说明Tapestry的项目还在顺利的进行中。
2、Tapestry主页的全新改版。主要是完善了文档。这一点是非常重要的，Tapestry项目组的成员也承认Tapestry在推销自己或者是在市场推广方面做得非常失败(very bad in marketing)，所以最近也采取了一些措施来进行改变，比如，预计明年会发行Tapestry5 in action一书等等。
3、还有一件事需要提及的是：appfuse的作者最近对web框架进行了一番对比http://raibledesigns.com/rd/entry/my_comparing_jvm_web_frameworks，Tapestry在13个框架中名列第7，刚好是中间的位置。Tapestry项目的成员颇有不满，认为作者Matt Raible对Tapestry不够了解，有误导观众之嫌。Tapestry项目成员Igor E. Poteryaev认为Matt在认识度，开发效率，项目健康度，测试友好性，scalability等方面严重低估了Tapestry的能力。

云自无心水自闲 2010-11-24 06:08 发表评论

Tapestry5.2.2(Beta Release)发布了

云自无心水自闲 — Mon, 01 Nov 2010 23:58:00 GMT

主要是一些bug修复和改进，最重要的一点是能够从link对象生成绝对路径了。
这主要是便于ajax的使用。

Bug

    * Element.forceAttribute uses the element's namespace to match the attribute.
    * Element.attribute(String name, String value) adds elements that already exist
    * Element#addClassName can create an additional new 'class' attribute
    * Properties defined in an Interface are not exposed by PropertyAccess for abstract classes that do not directly implement the methods
    * Some services require a notification that they have been reloaded, so they can clean up external dependencies
    * Whitespaces in SymbolConstants.SUPPORTED_LOCALES cause that locales are not persised
    * Validation macros do not work when used in @Validate annotation
    * Client-side validation of @Pattern is broken
    * Linking a Form to a Zone will no longer work unless the Form contains validated fields
    * When using PropertyShadowBuilder to build a service, if the property is null, an immediate exception is needed (rather than a NullPointerException)
    * When using a MultiZoneUpdate, Tapestry will clear the referenced zone

Improvement

    * Add the facility to optionally disable on-focus-change triggered validation while retaining the on-form-submit validation
    * Form component should be able to render a secure URL even on an insecure page
    * New annotations @Decorate and @Advise to identify methods that decorate or annotate services
    * Extend Link with new methods for producing absolute URLs (that include scheme, hostname, etc.)
    * Simplify connecting a link or form to an (enclosing) Zone
    * BeanBlockContribution should be split into two sub-classes: EditBlockContribution and DisplayBlockContribution
    * Define a special CSS class to prevent a client-side form from submitting normally (for Ajax use cases)
    * Additional method for Link: addParameterValue(String,Object) that uses ContextPathEncoder to encode object value to a string
    * SeleniumTestCase should expose the underlying CommandProcessor, to allow execution of commands not defined by the Selenium interface
    * Allow individual SeleniumTestCases to run w/o configuring SeleniumLauncher

云自无心水自闲 2010-11-02 07:58 发表评论

Tapestry5.2.1 Beta已经发布

云自无心水自闲 — Tue, 19 Oct 2010 23:38:00 GMT

今天在网上转了转，发现Tapestry又有了新动作。
1、从5.2.0alpha版8月11日发布到现在，终于发布5.2.1Beta版了。这个版本主要是修改alpha版本中的bug.
5.2相对于5.1进行了许多重大的改进，详细内容可见：Tapestry5.2的新变化
2、据称在5.3版中将引入大量的新功能，具体内容不详。
3、以往最令人诟病的文档问题，目前开发小组也在努力解决。
首先，建立了新的文档网页：http://people.apache.org/~uli/tapestry-site/，不过目前这个网站还没有完全完成，只能算是预览版，但是这毕竟是在正确的道路上前进。
其次，Tapestry 5 in action一书正在写作中，已经完成20%，预计明年一季度能够出版。
我相信，随着功能的不断完善和补充，再加上文档的逐渐充实，Tapestry完全有理由能吸引更多的开发者来关注和使用。

云自无心水自闲 2010-10-20 07:38 发表评论

Tapestry5.2的新变化

云自无心水自闲 — Tue, 17 Aug 2010 23:13:00 GMT

Tapestry开发小组中的一个成员的blog中记录了5.2版本带来的新变化
1、增强了class reload的功能（我个人也认为这一点是5.2版本最令人激动的改进），以前Tapestry和其他的web框架类似，修改页面不需要重新启动application server, 但是修改了类之后，必须重新启动应用服务器才行。但是在Tapestry5.2中，对这一点进行了修改，如果只改变了接口的实现类，而不改变接口的方法签名，就不需要重新启动应用服务器
2、新增了若干个组件，比如：Error和Trigger。
Error和原有的Errors类似，但是Error用于给指定的组件显示验证错误信息。
Trigger提供了在泻染页面过程中触发任务事件的功能，常常用于通过RenderSupport来给页面添加JavaScript代码
3、新的插件(Mixin),包括RenderClientId, RenderNotification
4、集成了JSR-303 Bean的验证，现在可以在页面中使用JSR-303标准的注解来给字段指定需要的验证
5、新的注解，包括@Contribute,@RequestParameter, @ActivationRequestParameter, 使用后两个注解能很容易地获取request中的参数
6、新的页面生命周期事件：pageReset
7、链接修饰过程中的新事件: decoratePageRenderLink, decoreateComponentEventLink
8、页面解析器的更换，原来使用StAX，造成了对Google App Engine和对OSGI的不兼容，5.2版本中使用了标准的SAX解析器
9、页面缓冲池的废除（我认为这是5.2版本的一个相当大而且也是非常重要的一个变化，我认为页面缓冲池技术是tapestry学习曲线陡峭的一个重要原因），5.2版本中所有页面将只有一个实例（也就是lewis howard说的单例化），页面属性的值将会在每个线程中使用一个Map来保存。这样一个页面实例可以在多个线程中使用，而不会有同步问题。
但是，由于这是一个新的尝试，所以lewis也不确定这样做的效果是否很好（详见：http://tapestryjava.blogspot.com/2010/07/everyone-out-of-pool-tapestry-goes.html）所以，在5.2中可以通过配置恢复页面缓冲池的使用。

云自无心水自闲 2010-08-18 07:13 发表评论

prototype版的table filter

云自无心水自闲 — Wed, 28 Jul 2010 03:02:00 GMT

jquery有一个很方便的插件UI Table Filter可以根据输入的内容隐藏显示表格中相应的数据行。
因为目前使用的tapestry捆绑的是prototype，所以就自己写了一个类似的插件。

  filter: Case-Sensitive

name	column1	column2	column3	column4	column5	column6
TEST	00150002331	238156	075	001	172.16.14.20	1-1-05
TEST-2	00150002332	238157	075	002	172.16.14.21	1-1-05
TEST	00150002333	238158	075	003	172.16.14.23	1-1-05
TEST	00150002341	238159	075	004	172.16.14.24	1-1-05
TEST	00150002339	238186	075	006	172.16.14.26	1-1-06

如果页面中多个表格，而只需要对其中的一个表格的数据进行过滤的话，简单地把其中：$$('tr').each(function(ele, index) 改成 $$('#tableId, tr').each(function(ele, index) 就行了，其中的tableId就是表格的id

云自无心水自闲 2010-07-28 11:02 发表评论

Tapestry5.2的alpha版本已经发布

云自无心水自闲 — Thu, 15 Jul 2010 00:20:00 GMT

今天打开tapestry的网站，发现tapestry5.2的alpha版本已经发布出来了。
在5.2中还是新增了不少令人激动的功能
1、QueryParameterMapped注解，使用这个注解可以很方便地把request中的参数映射到bean里的属性
2、（这是最让我期待的功能）服务终于能够动态加载了！
3、在事件处理方法中可以使用QueryParameter来注解参数
4、submit组件现在可以cancel表单里的数据了
5、不再使用StAX作为tml的解析器了，而是采用标准的SAX解析器，这样减少外界引用，而且兼容性更好
6、组件中也可以使用SessionAttribute来获得session中的数据了，以前好像只有在page中才能用
7、引入了JSR-303 Bean Validation Integration Library.

云自无心水自闲 2010-07-15 08:20 发表评论

tapestry5.2 beta版已经完成

云自无心水自闲 — Thu, 03 Jun 2010 02:31:00 GMT

作者相信ga版本将会在不久的未来发布。
所作者透露，在新版本中会增加一个新的组件：dynamic.

这个组件的用途是更换皮肤。在旧版本的tapestry中，由于tapestry的模板是一致的，所以要实现换肤相当困难。
但在新版本中的这个组件比较完美地解决了这个问题。
作者自我评价这个组件是令人激动的一个新事物。

云自无心水自闲 2010-06-03 10:31 发表评论

完美是优秀的敌人The Perfect Is The Enemy Of The Good

云自无心水自闲 — Thu, 18 Mar 2010 23:40:00 GMT

出自伏尔泰的名句。在许多优秀的程序员的编程习惯中，寻找解决方案就如同是寻找女友一般，总是力求完美，如果一个解决方案不够完美的话，那么宁可舍弃也不会降低标准而采用。但是这样的结果很有可能会是一叶障目，不见森林。
举个实际的例子来说，tapestry5的服务动态加载就是一个典型。
大家知道，在Tapestry中，页面模板的动态加载一直是其的一个宣传点。也就是说，页面模板如果修改了，不需要重新启动应用服务器，修改即时生效。但是，Tapestry却一直没有实现服务的动态加载，也就是说服务的类修改了，就必须重新启动服务器。为什么呢，因为追求完美。
其实很久以前在Tapestry的作者的头脑中，包括许多的用户都想在Tapestry中加入服务动态加载的功能，但是最后作者却放弃了。原因是因为，在Tapestry的架构中，服务比页面要复杂的多，服务不是单独存在的，他会被Inject到许多其他的服务，而这些服务又会被inject到其他的服务中，最后导致你很难界定哪些类需要被重新加载。
但是最近有一个人提出一个建议，为什么要实现完整的动态加载呢。其实只实现服务的实现类的动态加载就已经很好了。
确实，如果保持接口不变，只在接口具体实现修改的时候加载，确实大大简化了问题，因为这样变化范围就被限定在单个类之内了。虽然这样并不完美，因为如果改变了对外接口，比如，添加了一个新的方法，或者改变了方法的签名，还是需要重新启动服务器。可是这样也已经在很大程度上提升了用户的使用满意度。
正如有句古语所说：退一步海阔天空。也在此提醒自己在以后的开发过程中，尽量拓展自己的思维，不要一下子钻到牛角尖里。

云自无心水自闲 2010-03-19 07:40 发表评论

Tapestry 最新版5.1.0.5教程（十二）：自定义前缀prefix

云自无心水自闲 — Sat, 06 Mar 2010 07:54:00 GMT

在教程的第四部分（http://www.blogjava.net/usherlight/archive/2009/06/20/283396.html）我们已经粗略地介绍了Tapestry的前缀，其中提及最常用的两种literal和prop。这里顺便再介绍一下其他的几个前缀.
1、context，这个经常在引用图片的时候用到。比如：这样就能够在页面上显示在web-inf/images/icon.png
2、message，这个是需要I18N的应用必用的前缀。${message:some-key}
3、var，用于定义生成一个临时变量。比如：

${var:index}

。如果没有加这个前缀var:的话，就需要在页面类中添加一个property： index以及相应的getter和setter。
我们这次介绍自定义一个cycle前缀，这个可以用于在表格中显示不同背景的行（也就是斑马条）。
比如：

...

或者

aaaa

自定义prefix一般来说是3个步骤，
1、定义一个BindingFactory，这个需要实现BindingFactory接口
2、定义一个Binding继承AbstractBinding
3、注册这个Binding

看一下具体的prefix的类：

1import java.util.ArrayList;
2import java.util.List;
3
4import org.apache.tapestry5.Binding;
5import org.apache.tapestry5.BindingConstants;
6import org.apache.tapestry5.ComponentResources;
7import org.apache.tapestry5.ioc.Location;
8import org.apache.tapestry5.services.BindingFactory;
9import org.apache.tapestry5.services.BindingSource;
10
11/**
12 * Implementation of the cycle: binding prefix -- we parse list of bindings
13 * and generate delegate bindings for each element

14 * default binding is literal, other bindings can be used by specifying prefix.

15 * example: "cycle:prop:name,prop:lastName,sth,sth else"
16 */
17public class CycleBindingFactory implements BindingFactory {
18    private final BindingSource _bindingSource;
19
20    public CycleBindingFactory(BindingSource source){
21        this._bindingSource = source;
22    }
23
24    public Binding newBinding(String description, ComponentResources container, ComponentResources component,
25            String expression, Location location)
26    {
27        List<Binding> delegates = new ArrayList<Binding>();
28        String[] bindingNames = expression.split(",");
29
30        for (String bindingName : bindingNames){
31            String defaultBinding = BindingConstants.LITERAL;
32
33            Binding binding = _bindingSource.newBinding(description, container, component, defaultBinding, bindingName, location);
34            delegates.add(binding);
35        }
36
37        CycleBinding cycleBinding = new CycleBinding(delegates);
38        container.addPageLifecycleListener(cycleBinding);
39
40        return cycleBinding;
41    }
42}

1import java.util.List;
2
3import org.apache.tapestry5.Binding;
4import org.apache.tapestry5.internal.bindings.AbstractBinding;
5import org.apache.tapestry5.runtime.PageLifecycleListener;
6
7
8public class CycleBinding extends AbstractBinding implements PageLifecycleListener{
9    private final List<Binding> delegates;
10    private int index = 0;
11
12    public CycleBinding(List<Binding> delegates) {
13        this.delegates = delegates;
14    }
15
16    public Object get() {
17        Object ret = delegates.get(index).get();
18        index ++;
19        if(index>=delegates.size()) index = 0;
20        return ret;
21    }
22
23    @Override
24    public boolean isInvariant() {
25        return false;
26    }
27
28    @Override
29    public Class<Object> getBindingType() {
30        return Object.class;
31    }
32
33
34    public void containingPageDidDetach() {
35        index=0;
36    }
37
38    public void containingPageDidAttach() {/*not interested*/}
39
40    public void containingPageDidLoad() {/*not interested*/}
41}

Binding和BindingFactory写好了，注册后就可以使用了，注册的过程是在AppModel中添加以下一段代码：

1    public static void contributeBindingSource(
2            MappedConfiguration<String, BindingFactory> configuration,
3            BindingSource bindingSource
4            )
5    {
6        configuration.add("cycle",new CycleBindingFactory(bindingSource));
7    }

云自无心水自闲 2010-03-06 15:54 发表评论

Tapestry 最新版5.1.0.5教程（十一）：自定义组件CheckBoxGroup

云自无心水自闲 — Thu, 11 Feb 2010 23:26:00 GMT

我记得好像是Appfuse的作者曾经这样评价过Tapestry：只要你真正掌握了Tapestry，你的开发效率将会得到极大的提高。为什么呢？我认为他这样说的一个重要原因就是Tapestry的组件机制。Tapestry提供了非常便利的组件定义机制，随着Tapestry的组件不断积累，Tapestry的开发将会变得越来越简单。
本文就用一个实例来看一下Tapestry中是如何添加一个自定义组件的。
Tapestry的内置组件只提供了checkbox，而且只能返回一个boolean，用于表明是否被选中。
比如，要进行一个群众喜爱的水果调查，选项有: 苹果，葡萄，桃子，香蕉...，就需要对应每个选项设置一个布尔型变量，显得比较繁琐。
这里我们将添加一个组件用于将一组checkbox集中起来返回一个逗号分隔的字符串值。
通过查看Tapestry中的checkbox的源码（已经附在文章的后面）可以知道，Tapestry可以很容易地通过Request来获取Form中的变量的值。
遇到的问题：
Tapestry的checkbox组件不允许设置相同的name，如果name相同，Tapestry会自动在name后面添加后缀来使之不同。
If a component renders multiple times, a suffix will be appended to the to id to ensure uniqueness（http://tapestry.apache.org/tapestry5.1/tapestry-core/ref/org/apache/tapestry5/corelib/components/Checkbox.html）。如果各checkbox的name不同，我们无法通过request来获得一组checkbox的值。
思路：
在页面模板中不使用tapestry的checkbox组件，而使用Html的checkbox，这样可以避免tapestry自动修改checkbox的name。
添加一个新的tapestry组件，来映射接受所有同名的checkbox的值，并把值返回给tapestry页面中对应的变量。这个组件需要有一个属性，这个属性的值就是所有同组checkbox的name，这样，这个组件就可以通过Request来获取所有相同name的checkbox的值。
代码：

1 public class CheckBoxGroup extends AbstractField {
2
3     @SuppressWarnings("unused")
4     @Parameter(required = true, autoconnect = true)
5     private String value;
6
7     @Parameter(required = true, autoconnect = true)
8     private String groupName;
9
10     @Inject
11     private Request request;
12
13     @SuppressWarnings("unused")
14     @Mixin
15     private RenderDisabled renderDisabled;
16
17     @Inject
18     private ComponentResources resources;
19
20     @BeginRender
21     void begin(MarkupWriter writer)
22     {
23         writer.element("input", "type", "checkbox",
24                        "name", groupName,
25                        "id", getClientId(),
26                        "style", "display:none");
27
28         resources.renderInformalParameters(writer);
29
30         decorateInsideField();
31     }
32
33     @AfterRender
34     void after(MarkupWriter writer)
35     {
36         writer.end(); // input
37     }
38
39     @Override
40     protected void processSubmission(String elementName)
41     {
42         String elementValue = "";
43         String[] valueArray = request.getParameters(groupName);
44         if ( valueArray != null && valueArray.length > 0 ) {
45             elementValue = valueArray[0];
46             for ( int i = 1; i < valueArray.length; i ++ ) {
47                 elementValue += "," + valueArray[i];
48             }
49         }
50         value = elementValue;
51     }
52 }

组件的使用：
-----tml------

${book.name}

注意checkBoxGroup的groupName和其他checkbox的name必须一致，checkBoxGroup的value的值就是页面中的变量名

-----java-----
    @SuppressWarnings("unused")
    @Property
    private final ValueEncoder encoder = new ValueEncoder() {
        public String toClient(Book value) {
            return String.valueOf(value.getId());
        }
        public Book toValue(String clientValue) {
            return bookDao.getBook(Integer.parseInt(clientValue));
        }
    };

    public List getBookList() {
        return bookDao.getBooks();
    }

    @SuppressWarnings("unused")
    @Property
    private Book book;

    @SuppressWarnings("unused")
    @Property
    private String selectedBooks;

云自无心水自闲 2010-02-12 07:26 发表评论

Tapestry 最新版5.1.0.5教程（十）：页面间传递多个参数

云自无心水自闲 — Sat, 06 Feb 2010 04:36:00 GMT

在tapestry5中，在页面之间传递基本有3种方法
1、存放在Session中
2、使用@Persist进行持久化
3、使用页面context来传递参数。
其中1和2都需要将数据存放在Session中，相对来说系统的开销比较大。尤其是多用户高并发情况下，对于性能可能会有一定的影响。
使用页面Context来传递则需要在开发时写一些代码，增加了一些开发量，显得没有前两种方法方便。
第3种方法的实现是需要在页面中添加onActivate和onPassivate方法来完成页面参数的传递。
我们先来看一下其背后的故事。
举个例子，比如说我们有两个页面，第一个是查询条件输入页面input，另一个是查询结果输出页面output。input页面中有两个查询条件，起始时间dateFrom和终止时间dateTo
在Input.java中，我们可以很直观地这样写：
@InjectPage
private Output output;

@Property
private String dateFrom;

@Property
private String dateTo;

Object onFormSubmit() {
        output.setDateFrom(dateFrom);
        output.setDateTo(dateTo);
        return output;
}
首先使用注解注入output页面，然后在表单的提交事件中，返回output，这样就在程序中定义了返回页面，而不是使用配置文件的方式。
但是这样的实现却不能正确运行，原因是因为Tapestry5的使用了页面池技术，页面在每次渲染前都是从页面池中随机获取一个页面，而从页面池中取得的页面，所有的属性都是被清空了的。
也就是说在上例中，虽然我们注入了output页面，但是此页面马上就被放入了页面池，而且其中的属性值马上就被清空了。这就是引入onActivate和onPassivate这丙个方法的原因。tapestry5在清空属性前会首先查看是否包含onPassivate方法，如果有，就把其返回值保存起来，然后从页面池中取得页面后，再把刚才保存的值作为参数传递给onActivate方法。
这就是方法3的基本原理，但是无论是在官方的文档或是示例或者网上其他的应用中，可以发现大部分都是使用单个参数的，比如说id。这也很容易理解，因为onPassivate的方法的返回值只能有一个。
在Tapestry5的官方文档中，只有一句非常简要的话介绍了如果传递多个文档的方法： The activation context may consist of a series of values, in which case the return value of the method should be an array or a List. （参见：http://tapestry.apache.org/tapestry5.1/guide/pagenav.html）。
但是这并不是说只要在onPassivate中把参数的值加入到List中，返回一个List，而在onActivate中接受一个List参数，然后就可以得到其中的参数了，因为Tapestry5把参数传给onActivate的方法其实是通过将参数作为HttpRequest中的参数的。如果试图使用上述方法就是得到一个“无法将List转换成String的错误”
所以方法应该是这样的，在Output中：

private List paramList;
public void setParamList(List paramList) {
        this.paramList = paramList;
}
public List getParamList() {
        return paramList;
}
List onPassivate() {
        return paramList;
}
void onActivate(String dateFrom, String dateTo) {
        this.dateFrom = dateFrom;
        this.dateTo = dateTo;
}
private String dateFrom;
private String dateTo;

在Input页面中，需要把onFormSubmit改一下：
Object onFormSubmit() {
        List list = new ArrayList();
        output.setParamList(list);
        return output;
}

其中，需要注意的是output中的onActivate方法，基参数的顺序必须和List中放入的参数顺序一致。

云自无心水自闲 2010-02-06 12:36 发表评论

Tapestry最新版5.1.0.5教程（九）：权限控制框架的实现-进阶篇

云自无心水自闲 — Thu, 04 Feb 2010 11:17:00 GMT

在上一篇中我们研究了如何实现SpringSecurity中Jsp Tag的的功能。这一次我们一起研究一下如何实现在Tapestry5.1中添加一个Filter来对所有的操作进行权限的过滤控制。
在SpringSecurity中，我们一般是在application-context.xml中，添加一个SpringSecurity的Filter，然后在另外一个xml中详细配置如何根据Url的规则进行权限的控制。而Tapestry的哲学是尽量减少Xml中的配置（其IOC容器也基本上是借鉴Guice而不Spring的），所以我们也是在代码中实现权限规则的控制。
总体上来看，可以用两种方式来实现url规则，一种是Request级别的Filter，一种是页面组件级别的Filter，如果是Request级别的话，可以从Request对象中获取Url路径，这样就与SpringSecurity基本一样了。本文主要介绍页面组件级别的Filter，从中我们也可以体会到Tapestry5.1中的IOC容器的强大和便利。

这就是Filter的代码，这个Filter必须实现ComponentRequestFilter接口。值得注意的是其构造函数所需要用到的4个参数，这4个参数都是Tapestry5本身自有的服务，所以我们什么也不用做，Tapestry5自动会将服务的实例注入进来，这就是Tapestry-IOC的威力。
ComponentRequestFilter接口一共有4个方法需要实现，具体代码如下：

1 public class RequiresLoginFilter implements ComponentRequestFilter {
2
3     private final PageRenderLinkSource renderLinkSource;
4
5     private final ComponentSource componentSource;
6
7     private final Response response;
8
9     private final ApplicationStateManager appStateManager;
10
11     public RequiresLoginFilter(PageRenderLinkSource renderLinkSource,
12             ComponentSource componentSource, Response response,
13             ApplicationStateManager appStateManager
14             ) {
15         this.renderLinkSource = renderLinkSource;
16         this.componentSource = componentSource;
17         this.response = response;
18         this.appStateManager = appStateManager;
19     }
20
21     public void handleComponentEvent(
22             ComponentEventRequestParameters parameters,
23             ComponentRequestHandler handler) throws IOException {
24
25         if (dispatchedToLoginPage(parameters.getActivePageName())) {
26             return;
27         }
28
29         handler.handleComponentEvent(parameters);
30
31     }
32
33     public void handlePageRender(PageRenderRequestParameters parameters,
34             ComponentRequestHandler handler) throws IOException {
35         if (dispatchedToLoginPage(parameters.getLogicalPageName())) {
36             return;
37         }
38         handler.handlePageRender(parameters);
39
40     }
41
42     private boolean dispatchedToLoginPage(String pageName) {
43         Component page = componentSource.getPage(pageName);
44
45         if (page.getClass().isAnnotationPresent(RequiresLogin.class)) {
46             if ( ! appStateManager.exists(Authentication.class)) {
47                 redirect();
48                 return true;
49             }
50             Authentication auth = appStateManager.get(Authentication.class);
51             if ( auth == null ) {
52                 redirect();
53                 return true;
54             }
55
56              if ( ! auth.isLoggedIn()) {
57                  redirect();
58                  return true;
59              }
60
61             RequiresLogin requireLogin = page.getClass().getAnnotation(
62                     RequiresLogin.class);
63             String ifNotGranted = requireLogin.ifNotGranted();
64             String ifAllGranted = requireLogin.ifAllGranted();
65             String ifAnyGranted = requireLogin.ifAnyGranted();
66             boolean permitted = auth.checkPermission(ifNotGranted, ifAllGranted, ifAnyGranted);
67             if ( ! permitted ) {
68                 return true;
69             }
70         }
71
72         return false;
73     }
74
75     private void redirect() {
76          Link link = renderLinkSource.createPageRenderLink("Logout");
77
78          try {
79              response.sendRedirect(link);
80          } catch (Exception e) {
81          }
82     }
83
84 }

在ComponentRequestFilter中，我们无法使用@SessionState注解来直接注入Session中的变量，但是我们可以通过ApplicationStateManager来取得。

现在我们需要把刚定义的Filter注册到系统中，很简单，只要在AppModule中添加以下函数就行了：

1 public static void contributeComponentRequestHandler(
2 OrderedConfiguration<ComponentRequestFilter> configuration) {
3 configuration.addInstance("RequiresLogin", RequiresLoginFilter.class);
4 }
5

从本例子中我们可以看到Tapesty Ioc容器使用的便利性，也认识到了Ioc容器在Tapestry体系中的重要性

云自无心水自闲 2010-02-04 19:17 发表评论

Tapestry5.1中java.lang.ClassFormatError: Invalid length nnn in LocalVariableTable in class file 错误的解决

云自无心水自闲 — Wed, 20 Jan 2010 23:28:00 GMT

最近在使用tapestry5.1.0.5开发项目的时候，突然报错：
Exception in thread "main" java.lang.ClassFormatError: Invalid length 561 in LocalVariableTable in class file

在网上搜索后，发现有人也有同样的错误，解决方法有两种：
http://mail-archives.apache.org/mod_mbox/tapestry-users/200909.mbox/%3Cecd0e3310909040909id5275beld935fc60d54d490a@mail.gmail.com%3E
其中一个人的错误原因是在其类路径中有不同版本的javassists的jar文件。
另一个的解决方法是使用eclipse自带的jdk来编译java类。
而我自己仔细检查了类路径中的文件，并没有重复的javassists，不过我觉得问题应该就在javassists上，
因为这显然是javassists在操作class文件时报的错误，
我去网上搜索这方面的信息，发现有好几个人都和我一样在使用javassists3.11.0GA版本的时候，会出现这个错误。
后来，我改用Tapestry5中自带的javassists3.9.0GA后，问题消失了。
这次经验教训是并不是所有最新的东西都是最好的。合适的才是最好的。

云自无心水自闲 2010-01-21 07:28 发表评论

Tapestry最新版5.1.0.5教程（八）：权限控制框架的实现-基础篇

云自无心水自闲 — Tue, 12 Jan 2010 12:17:00 GMT

Tapestry中并没有类似于Spring Security这样的专门的权限框架。对此Tapestry的作者Lewis认为主要是用户对于权限的要求实在太多变化了。他认为很难抽象出一个通用的权限框架来满足所有的用户，所以他干脆就不费事去做这件事了。但其实我们很容易就能利用Tapestry已有的工具来完成类似于SpringSecurity的功能。
本文主要介绍如何实现类似于SpringSecurity的jsp tag的功能。在Tapestry中，利用Components实现这一点非常容易。
其基本原理是Tapestry5中一个页面或者组件的渲染生成过程是基于一个状态机和队列完成的。这样，渲染生成过程就被细分成了很多个小模块，我们可以非常容易地覆写这些小模块。具体内容详见官方文档：http://tapestry.apache.org/tapestry5.1/guide/rendering.html。如果权限校验不通过，我们就可以控制不显示组件的内容。
我们这里就是主要依赖这个过程来实现在页面这一层面对权限进行校验和控制。
代码主要包含两大部分，一个组件和一个用于权限控制的服务。
参考了Tapestry-Spring-Security的实现，我也将组件命名为IfRole（当然，我们也可以和Tapestry-Spring-Security一样，也再生成一个IfLoggedIn组件）。权限控制的服务我命名为：AuthenticationService。
主要的实现思路：
将AuthenticationService申明为SessionState变量。这样这个变量就可以在所有的页面和组件之间很方便地共享了。一般情况下，是在登录页面对AuthenticationService进行赋值，而在退出页面清空AuthenticationService这个变量。
代码（这部分代码完全根据应用的需求进自行更改）：
AuthenticationService的代码：

public class AuthenticationService {
    private List<String> privilegeList;
    // privilegeList 的getter and setter

    public boolean checkPermission(String ifNotGranted, String ifAllGranted,
            String ifAnyGranted) {
        if (((null == ifAllGranted) || "".equals(ifAllGranted))
                && ((null == ifAnyGranted) || "".equals(ifAnyGranted))
                && ((null == ifNotGranted) || "".equals(ifNotGranted))) {
            return false;
        }

        if ((null != ifNotGranted) && !"".equals(ifNotGranted)) {
            StringTokenizer st = new StringTokenizer(ifNotGranted, ",");
            while (st.hasMoreTokens()) {
                String value = st.nextToken();
                if (privilegeList.contains(value)) {
                    return false;
                }
            }
        }

        if ((null != ifAllGranted) && !"".equals(ifAllGranted)) {
            StringTokenizer st = new StringTokenizer(ifAllGranted, ",");
            while (st.hasMoreTokens()) {
                String value = st.nextToken();
                if (!privilegeList.contains(value)) {
                    return false;
                }
            }
        }

        if ((null != ifAnyGranted) && !"".equals(ifAnyGranted)) {
            StringTokenizer st = new StringTokenizer(ifAnyGranted, ",");
            while (st.hasMoreTokens()) {
                String value = st.nextToken();
                if (privilegeList.contains(value)) {
                    return true;
                }
            }
            return false;
        }

        return true;
    }
}

IfRole的代码（这个类需要放在Components目录下）：

public class IfRole {
    /**
     * A comma-separated list of roles is supplied to one or more of the
     * following parameters. If none are supplied, the default behavior is to
     * forbid access. Behavior should be self-explanatory.
     */
    @Parameter(required = false, defaultPrefix = "literal")
    private String ifAllGranted;

    @Parameter(required = false, defaultPrefix = "literal")
    private String ifAnyGranted;

    @Parameter(required = false, defaultPrefix = "literal")
    private String ifNotGranted;

    /**
     * An alternate {@link Block} to render if the test parameter is false. The default, null, means
     * render nothing in that situation.
     */
    @Parameter(name = "else")
    private Block elseBlock;

    private boolean test;

    @SessionState
    private AuthenticationService auth;

    private boolean checkPermission() {
        return auth.checkPermission(ifNotGranted, ifAllGranted, ifAnyGranted);
    }

    void setupRender() {
        test = checkPermission();
    }

    /**
     * Returns null if the test method returns true, which allows normal
     * rendering (of the body). If the test parameter is false, returns the else
     * parameter (this may also be null).
     */
    Object beginRender() {
        return test ? null : elseBlock;
    }

    /**
     * If the test method returns true, then the body is rendered, otherwise not. The component does
     * not have a template or do any other rendering besides its body.
     */
    boolean beforeRenderBody() {
        return test;
    }

}

示例：
1. 在登录页面：
@SessionState
private Authentication auth;

......

// if user name and password is valid:
auth.setPrivliegeList(.....);

2. 在需要权限控制的页面模板中：

administrator can see this block

云自无心水自闲 2010-01-12 20:17 发表评论

Tapestry最新版5.1.0.5教程（七）：与IBatis3的整合

云自无心水自闲 — Wed, 06 Jan 2010 04:20:00 GMT

与现在最流行的SSH相比较，Tapestry能够完全替代其中Struts2和Spring，但是他还是需要一个ORM的框架。IBatis由于比较低的学习曲线，也受到很多人的喜爱。尤其是在IBatis3中引入了许多新的概念和想法，使用更加安全和便利。
本文主要介绍如何将Tapestry5.1和IBatis3进行整合。
简要步骤：
1. 准备工作
2. 数据库的建立
3. POJO的建立
4. IBatis相关配置文件的创建
5. Tapestry相关代码的完成
概要说明：
1、准备工作。这一部分是比较简单的，Eclipse之类的开发环境是必需的。Tapestry5.1、IBatis3（目前还是Beta7）、数据库（我使用的是MySql）的下载安装。
2、数据库的建立，由于是示例，所以数据库的建立也非常简单，只有一张User表，3个字段，Id，Name，Password
3、com.sample.User类，对应数据库表的3个字段，生成User类
4、IBatis配置文件：Configuration.xml，UserMapper.xml，jdbc.properties的生成, 前两个必需，最后一个可选.
5、在AppModule里，使用build方法, 添加服务生成IBatis3的SqlSessionFactory, 在需要使用SqlSessionFactory的地方，使用@InjectService注入即可
详细说明：
1、大家到各自的网站上下载相应的包好了。我只罗列一下我所用到的Lib：
    antlr-runtime-3.1.1.jar
    commons-codec-1.3.jar
    commons-lang-2.4.jar
    ibatis-3-core-3.0.0.216.jar
    javassist.jar
    log4j-1.2.14.jar
    mysql-connector-java-5.0.5.jar
    slf4j-api-1.5.10.jar
    slf4j-log4j12-1.5.10.jar
    stax2-api-3.0.1.jar
    tapestry-core-5.1.0.5.jar
    tapestry-ioc-5.1.0.5.jar
    tapestry5-annotations-5.1.0.5.jar
    woodstox-core-lgpl-4.0.7.jar
2、Create Table
DROP TABLE IF EXISTS `test`.`user`;
CREATE TABLE `test`.`user` (
`id` int(10) unsigned NOT NULL AUTO_INCREMENT,
`name` varchar(45) NOT NULL,
`password` varchar(45) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB;

3、
package com.sample.model;
public class User {
    private long id;
    private String name;
    private String password;
// getter and setter    ....
}

4、我把Configuration.xml和UserMapper.xml都放在src目录下，这样在部署的时候，就是生成在classes，也就是类路径的根目录下。
Configuration.xml:

PUBLIC "-//ibatis.apache.org//DTD Config 3.0//EN"
"http://ibatis.apache.org/dtd/ibatis-3-config.dtd">





















UserMapper.xml:

    PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN"
    "http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd">




jdbc.properties:
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost/test?autoReconnect=true
jdbc.username=root
jdbc.password=root
pingenable=true
pingquery=SELECT 1
pingoldertime=0
pingnotusetime=3600000

5、
package com.sample.web.services;
public class AppModule {
    public static SqlSessionFactory buildSqlSessionFactory() {
        try {
            String resource = "Configuration.xml";
            Reader reader = Resources.getResourceAsReader(resource);
            return new SqlSessionFactoryBuilder().build(reader);
        } catch (Exception e) {
            logger.warn("failed to build SqlSessionFactory: ", e);
            return null;
        }
    }

    private static Logger logger = LoggerFactory.getLogger(AppModule.class);
}

package com.sample.model;
public interface UserMapper {
    public User selectUser(int id);
}

package com.pc.sample.web.pages;
public class Layout {
    @InjectService("SqlSessionFactory")
    private SqlSessionFactory sqlMapper;
    public String getUserName() {
        if ( sqlMapper == null ) {
            return "null-mapper";
        }
        SqlSession session = sqlMapper.openSession();
        try {
            UserMapper userMapper = session.getMapper(UserMapper.class);
            if ( userMapper == null ) {
                return "null-userMapper";
            }
            User user = userMapper.selectUser(1);
            if ( user == null ) {
                return "null-user";
            }
            return user.getName();
        } catch (Exception e) {
            return "exception-" + e.getMessage();
        } finally {
            session.close();
        }
    }
}

几个注意事项：
1，因为我的IBatis的配置文件Configuration.xml是放在类路径的根目录下，所以在初始化SqlSessionFactory的时候，直接用String resource = "Configuration.xml";就行了，否则需要添加相应的路径，比如：把Configuration.xml与User类放在一起，也就是在 com.sample.model这个package中，那么就要写成：String resource = "com/sample/model/Configuration.xml";
同样，在Configuration.xml中，指定UserMapper.xml的规则也是这样的。
2，UserMapper的使用。Mapper的使用是IBatis3中才有的新功能，也是IBatis用户指南中推荐使用的方式。因为这样使用的话，就完全避免了类型的强制转换，实现了类型安全。
需要注意的是UserMapper只是一个接口。我们不需要提供这个接口的具体实现。IBatis3会自动生成一个具体的实例。

其中的方法名必须与UserMapper.xml中的select语句的id一样。在我的例子中是selectUser.
另外，此方法的返回值的类型必须与UserMapper.xml中配置的returnType一致。
最后要提醒的是UserMapper.xml中的namespace必须是UserMapper的全类名,在本例中就是com.sample.model.UserMapper

云自无心水自闲 2010-01-06 12:20 发表评论

Tapestry最新版5.1.0.5教程（六）：核心利器-IoC容器介绍

云自无心水自闲 — Sat, 12 Sep 2009 14:07:00 GMT

摘要: Tapestry IoC容器从历史上来说，是从从HiveMind继承发展而来，但是HiveMind和目前大红大紫的Spring都不能满足Tapestry的一些特定的需求，所以全新开发了一套IoC的容器。
其核心思想就是使用Java代码自身来解决依赖注入而不是由Xml之类的配置文件来完成，这和Guice的思想是非常相似的，Lewis也承认从Guice那里借鉴了不少。
另外需要说明一下的是，Tapesty还从中国的一个非常古老但又充满哲理的游戏--围棋中借鉴了一些术语和思想。大意是围棋中经常要把棋子走的轻盈(Lightness)，让每个棋子都能尽量地高效。编程也一样要轻量(Lightness)。阅读全文

云自无心水自闲 2009-09-12 22:07 发表评论

Tapestry最新版5.1.0.5教程（五）：Hello示例程序的剖析

云自无心水自闲 — Fri, 10 Jul 2009 12:15:00 GMT

根据前面的4部分内容，我们已经了解了Tapestry的基本概念，掌握了配置、组件等内容。现在我们通过剖析Tapestry的入门示例来对Tapestry进行一个总体上认识。
1、web.xml

    app Tapestry 5 Application


        tapestry.app-package
        t5demo


        app
        org.apache.tapestry.TapestryFilter


        app
        /*

这就是一个最简单的Tapestry应用所需要配置的内容了。
a.context-param中的tapestry.app-package配置，这在第一部分说过：这是Tapestry要求配置的java package的名称，Tapestry相关内容都需要在这个package下面的pages, services, componets子package下。这里的配置是t5demo
b.TapestryFileter的配置。这个非常容易理解，几乎所有现在流行的web框架都需要一个类似的定义。

2、start.tml以及相应的java class，例子中就是t5demo.pages.Start.java
Start.java非常简单，只定义了一个get方法：
public class Start
{
        public Date getCurrentTime()
        {
                return new Date();
        }
}
相应的页面start.tml


        app Start Page

app Start Page

This is the start page for this application, a good place to start your modifications.
Just to prove this is live:

The current time is: ${currentTime}.

[refresh]

首先要注意在html的tag中加入了Tapestry的命名空间。
第二、${currentTime}就是Tapestry的Tag了，这里就会调用对应class的getCurrentTime方法在页面上显示对应的值。
第三、定义一个到自己本身页面的链接，来完成刷新的任务。t:pagelink在本系列的第4部分介绍过。

3、需要的library：
commons-codec.jar
javassist.jar
log4j.jar
slf4j-api.jar
slf4j-log4j.jar
tapestry5-annotations-5.1.0.5.jar
tapestry-core-5.1.0.5.jar
tapestry-ioc-5.1.0.5.jar

4、再加上一个log4j.properties，这就是一个最简单的tapestry应用所需要的全部东西了。
怎么样，感觉还是挺简单的吧。

云自无心水自闲 2009-07-10 20:15 发表评论

Tapestry最新版5.1.0.5教程（四）

云自无心水自闲 — Sat, 20 Jun 2009 11:57:00 GMT

摘要: Tapestry最基本的组成部分：页面组件阅读全文

云自无心水自闲 2009-06-20 19:57 发表评论

Tapestry最新版5.1.0.5教程（三）

云自无心水自闲 — Fri, 05 Jun 2009 06:24:00 GMT

摘要: Tapestry重要特性之一：页面的缓存以及页面间值的传递阅读全文

云自无心水自闲 2009-06-05 14:24 发表评论

Tapestry最新版5.1.0.5教程（二）续

云自无心水自闲 — Wed, 03 Jun 2009 09:17:00 GMT

摘要: Tapestry的页面模板语言阅读全文

云自无心水自闲 2009-06-03 17:17 发表评论

Tapestry最新版5.1.0.5教程（二）

云自无心水自闲 — Sun, 31 May 2009 12:31:00 GMT

摘要: Tapestry的页面阅读全文

云自无心水自闲 2009-05-31 20:31 发表评论

Tapestry最新版5.1.0.5教程（一）

云自无心水自闲 — Sat, 30 May 2009 05:55:00 GMT

摘要: Tapestry的基本配置和目录结构阅读全文

云自无心水自闲 2009-05-30 13:55 发表评论

Tapestry5.1.0.5的性能测试

云自无心水自闲 — Sat, 16 May 2009 11:38:00 GMT

Ben Gidley进行了一个关于Tapestry5.1.0.5的性能测试。原文见：http://blog.gidley.co.uk/2009/05/tapestry-load-testing-round-up.html
最后，他得出的结论是：
１、Tapestry的速度是比较快的。即使在一定的压力下Tapestry的反应时间也相当短。Tapestry并不总是最快的解决方案，但它对于我（译注：Gidley）已经足够快了。
２、Tapestry没有内存泄漏。我以前曾经听说过Tapestry会占用大量的内存，实际上，正好相反。它使用的内存比struts/jsp还要少。内存使用曲线相当的平坦。
３、Tapestry在表单应用中比struts要快。Tapestry在应用变得非常复杂的时候有一定的优势。这可能利益于其模块池技术。
４、Tapestry不轻易崩溃，即使崩溃，也会恢复。Tapestry在极大压力的情况下确实会相应变慢，但是它会暂停或者遇到瓶颈（译注：我怀疑是作者这里有笔误，从语气和上下文来看，感觉应该不是暂停和没有瓶颈），这的确是一个好事情。另外在压力减轻之后，Tapestry能够自动恢复。
５、更多的CPU并一定会提升性能。在一系列的测试中，性能与CPU的数量并不是线性增长。２个CPU确实比一个CPU的性能翻倍了，但是４个CPU并不比２个CPU的性能翻倍。因此，建议在多个双核CPU的虚拟机上运行，而不是少数的４核CPU上运行。
６、６４位比３２位要快。这一点很让我惊奇。不管在Solaris还是Linux上，运行在６４位JVM中要比在３２位JVM要快。
７、Linux要比Open Solaris X86要快。这一点同样让我惊奇。我本来以为性能应该是相似的。
最终的结论是：Tapestry即使是对于一个大并发量的Web应用来说也已经足够快了。如果你的应用有性能问题的话，那么问题应该出在你自己本身的代码上。

上述是原文的翻译。下面是一些评论：
Howard（应该是Tapestry的作者）：Taptestry５和Struts相比，我认为差别应该是在反射的使用上（包括在java.bean.Introspector中大量的synchronization）。因此在Struts将查询参数的名称映射成JavaBean属性的时候，会比较耗时。而Tapestry５是不使用反射的，Tapestry在查询参数和JavaBean的属性之间使用一种“预编程”向量组件，也许这就是两者（Tapestry和Struts）的差别。当然，这只是猜想，如果要证实的话，是需要花费很多时间的。我认为OGNL的教训不是说反射很慢，而是在于一个关键代码上的序列存取对于性能的影响是相当大的。
最后一个小提示：我觉得在Tapestry5应用中如果把BeanModel从BeanModelSource中只提取一次，然后给Grid，BeanEditForm等等提供一个可以存取的方法，将会获得相当的性能提升。这样就不是需要每次都重建BeanModel，将减少操作的消耗。
jeverest：我也进行了Tapestry的性能测试，并且同意Tapestry５的性能比较以前版本的要快。

云自无心水自闲 2009-05-16 19:38 发表评论

Tapestry5.1正式发布

云自无心水自闲 — Thu, 07 May 2009 13:08:00 GMT

Tapestry5.1经过数个alpha,Beta版的非正式发布，今天终于在主页看到最终正式版5.1.0.5的发布。

这次的版本算得上是比较迅速了，从官方主页中可以看到，第一版5.1.0.1是２月２４日发布了，短短３个月不到的时间，发了４个版本，动作不可谓不迅速。

5.1中具有以下几个新特性
１、Tapestry现在开始采用BlackBird作为JavaScript的调试工具
２、一个Ajax的事件请求现在可以返回一个MultiZoneUpdate实例来更新浏览器中的多个区
３、客户端数字的检验实现了国际化
４、相对于5.0.18有显著的性能提升，主要是页面的加载时间和页面的渲染时间大大缩短
５、Tapestry的IoC服务现在既可以是Advised也可以是Decorated
６、Tapestry的服务现在可以注入到Spring的Bean中
７、对于支持Gzip的客户端，Tapestry现在可以压缩返回包
８、有序的和Mapped的配置信息现在可以被重新赋值
９、属性表达式得到加强，现在可以调用有参数的方法，或者创建一个列表
１０、IoC的贡献既可以是类（自动生成实例）也可以是具体的实例
１１、现在提供了一个简单的可以重写内建服务的方法

这里面最让我感兴趣的还是性能的提升，不知道在展示大数据量的时候性能的提升到底有多少，有机会一定要测试一下。

云自无心水自闲 2009-05-07 21:08 发表评论

Tapestry和JSF比较

云自无心水自闲 — Tue, 21 Apr 2009 15:09:00 GMT

最近把Tapestry和JSF都研究了一下，最后还是决定选择Tapestry。
最主要的原因还是从性能上的考虑。
Tapestry的5.1版的最主要改动就是想提升性能，而JSF似乎还没有这方面的行动。
而且从Tapestry5.1的版本发布情况来看，动作相当的迅速。预计Final版马上就要出来了。
据Lewis的说法，Tapestry5.0在页面内容比较少的时候，速度几乎和纯JSP页面一样快。只是在展示大量数据的会有一定的性能瓶颈。
所以，他推出5.1来解决这个问题。

而JSF的实现和组件库呈现一种百花齐放的状态，难免会有一些良莠不齐。
当然大家需要选择其中比较好的，但是选型本身就是一件非常头疼的事情。
我选择的是MyFaces＋RichFaces，但是我查看了RichFaces的在线Demo后，对其展示速度不是很满意。
不知道是演示网站的问题还是RichFaces本身的问题。
也欢迎大家进行讨论。

不过Tapestry相对JSF而言的一个缺点就是文档不够丰富。毕竟JSF是标准啊。

云自无心水自闲 2009-04-21 23:09 发表评论