Tapestry4自定义组件的方法(操作篇)
请参考tapestry官方文档中的一篇文章
Creating Tapestry components
我用的是tapestry 4.1.6，开发环境MyEclipse 6.5，容器是tomcat6
转载请注明：
原文地址： http://huxiao.iteye.com/blog/641343
一、首先是搭建一个简单的环境
参见tapestry的 hello world程序
1. 新建一个web项目
2. 把jar包copy到lib目录下
3. 在web.xml中配置tapestry
4. 在WebRoot目录下新建一个Home.html
5. 测试
这时候请使用http://localhost:8080/app访问（地址端口等如果你改了你自己看着搞）
如果能打印出一个时间(如Sun Apr 11 19:55:36 CST 2010)就算配置成功了
二、创建一个名叫Test的组件
我们的目的：使用这个标签<span jwcid="@Test" ...parameters... />，能出来一些我们想要的东西
首先，我们在Home.html中加上这一句，<span jwcid="@Test" />，访问，他会告诉你Exception: Component 'Test' not found in Namespace@4be179[<application>]，这是当然的，因为我们还没有Test这个组件，当tapestry发现你用这个标签的时候，他回去WEB-INF下面去找，如果找不到，就会exception了
1. 新建一个Test.java
继承自org.apache.tapestry.AbstractComponent类，然后Override一个方法叫renderComponent
2. 在WEB-INF目录下新建一个文件叫Test.jwc，内容如下:
注意，其中class="huxiao.components.test.Test"是刚才的Test.java的全路径，这样就把两个文件关联起来了。
3. 测试：
重启tomcat，再访问，已经不报错了，这时候我们的组件其实已经ok了，但是现在他什么都还不能干
那么我们就来实现一个小小的功能吧，
当我输入<span jwcid="@Test" link="http://huxiao.iteye.com" value="huxiao" />的时候，输出一个连接<a href="http://huxiao.iteye.com">huxiao</a>
4. 修改Test.jwc，配置了两个parameter，link和value，其中link配置为required="yes"，value为不必须，如果配置为必须又不写这个参数的话，会报一个没有传参数的exception
5. 修改Test.java
6. 刷新页面，可以看到我们想要的效果了
三、使用标签库，或者叫命名空间是不是更合适些？whatever
到上面为止，我们已经自定义了标签，这一节，我们来让使用更为灵活
1. 在WEB-INF下面新建一个配置文件t4.application
其中hx，就是我们的library的名字了。后面的是路径
2. so，我们自然也要在刚才那个路径下面新建这个文件了my.library
格式都是固定的，每新建一个component，添加一个<component-type />标签就ok了，刚才我们不是吧*.jwc文件都要放到WEB-INF下面吗？现在看到了吧，我们这里加一个specification-path属性之后，jwc文件就可以随意放置了，这样我们就可以把相应的jwc文件，java文件都放在一起，省的到处乱放了。而在WEB-INF下，我们只需要一个t4.application文件，即使你有n个components
3. 测试
ok，重启运行一下，效果不变
done！
----------------------------------------------------------------------
四、reference
Creating Tapestry components
我用的是tapestry 4.1.6，开发环境MyEclipse 6.5，容器是tomcat6
转载请注明：
原文地址： http://huxiao.iteye.com/blog/641343
一、首先是搭建一个简单的环境
参见tapestry的 hello world程序
1. 新建一个web项目
2. 把jar包copy到lib目录下
3. 在web.xml中配置tapestry
<servlet>
<servlet-name>t4</servlet-name>
<servlet-class>org.apache.tapestry.ApplicationServlet</servlet-class>
<load-on-startup>0</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>t4</servlet-name>
<url-pattern>/app</url-pattern>
</servlet-mapping>
4. 在WebRoot目录下新建一个Home.html
<html> <head> <title>Home.html</title> </head> <body> <span jwcid="@Insert" value="ognl:new java.util.Date()"></span> </body> </html>
5. 测试
这时候请使用http://localhost:8080/app访问（地址端口等如果你改了你自己看着搞）
如果能打印出一个时间(如Sun Apr 11 19:55:36 CST 2010)就算配置成功了
二、创建一个名叫Test的组件
我们的目的：使用这个标签<span jwcid="@Test" ...parameters... />，能出来一些我们想要的东西
首先，我们在Home.html中加上这一句，<span jwcid="@Test" />，访问，他会告诉你Exception: Component 'Test' not found in Namespace@4be179[<application>]，这是当然的，因为我们还没有Test这个组件，当tapestry发现你用这个标签的时候，他回去WEB-INF下面去找，如果找不到，就会exception了
1. 新建一个Test.java
继承自org.apache.tapestry.AbstractComponent类，然后Override一个方法叫renderComponent
package huxiao.components.test;
import org.apache.tapestry.AbstractComponent;
import org.apache.tapestry.IMarkupWriter;
import org.apache.tapestry.IRequestCycle;
public abstract class Test extends AbstractComponent {
@Override
protected void renderComponent(IMarkupWriter writer, IRequestCycle cycle) {
}
}
2. 在WEB-INF目录下新建一个文件叫Test.jwc，内容如下:
<?xml version="1.0"?> <!DOCTYPE component-specification PUBLIC "-//Apache Software Foundation//Tapestry Specification 4.0//EN" "http://jakarta.apache.org/tapestry/dtd/Tapestry_4_0.dtd"> <component-specification allow-body="yes" allow-informal-parameters="yes" class="huxiao.components.test.Test"> </component-specification>
注意，其中class="huxiao.components.test.Test"是刚才的Test.java的全路径，这样就把两个文件关联起来了。
3. 测试：
重启tomcat，再访问，已经不报错了，这时候我们的组件其实已经ok了，但是现在他什么都还不能干
那么我们就来实现一个小小的功能吧，
当我输入<span jwcid="@Test" link="http://huxiao.iteye.com" value="huxiao" />的时候，输出一个连接<a href="http://huxiao.iteye.com">huxiao</a>
4. 修改Test.jwc，配置了两个parameter，link和value，其中link配置为required="yes"，value为不必须，如果配置为必须又不写这个参数的话，会报一个没有传参数的exception
<?xml version="1.0"?>
<!DOCTYPE component-specification PUBLIC
"-//Apache Software Foundation//Tapestry Specification 4.0//EN"
"http://jakarta.apache.org/tapestry/dtd/Tapestry_4_0.dtd">
<component-specification allow-body="yes" allow-informal-parameters="yes" class="huxiao.components.test.Test">
<parameter name="link" required="yes"/>
<parameter name="value" required="no"/>
</component-specification>
5. 修改Test.java
package huxiao.components.test;
import org.apache.tapestry.AbstractComponent;
import org.apache.tapestry.IMarkupWriter;
import org.apache.tapestry.IRequestCycle;
public abstract class Test extends AbstractComponent {
public abstract String getLink();
public abstract String getValue();
@Override
protected void renderComponent(IMarkupWriter writer, IRequestCycle cycle) {
/**
* 表示新建一个标签a，所以说，我们完全可以根据我们获取的一个参数来决定新建什么标签
* 比如<span jwcid="@Test" tag="div" />，然后根据tag的值来定新建什么参数，
* 我这里就需要一个a，所以新建a了
*/
writer.begin("a");
/**
* 新建一个属性href，值为getLink()，这个getLink()对应上面的public abstract String getLink()方法
*/
writer.attribute("href", getLink());
//同上
writer.print(getValue());
/**
* 有两个方法，一个是这个，另一个是renderBody(IMarkupWriter writer, IRequestCycle cycle)
* 区别在于，如果是成对的标签<span>ddd</span>，那么renderBody把标签中间的值放回原位，
* 我表达的可能不清楚，大家试一下就知道了
*/
renderInformalParameters(writer, cycle);
//关闭writer
writer.close();
}
}
6. 刷新页面，可以看到我们想要的效果了
三、使用标签库，或者叫命名空间是不是更合适些？whatever
到上面为止，我们已经自定义了标签，这一节，我们来让使用更为灵活
1. 在WEB-INF下面新建一个配置文件t4.application
<?xml version="1.0"?> <!DOCTYPE application PUBLIC "-//Apache Software Foundation//Tapestry Specification 4.0//EN" "http://jakarta.apache.org/tapestry/dtd/Tapestry_4_0.dtd"> <application> <library id="hx" specification-path="/huxiao/components/my.library"/> </application>
其中hx，就是我们的library的名字了。后面的是路径
2. so，我们自然也要在刚才那个路径下面新建这个文件了my.library
<?xml version="1.0"?>
<!DOCTYPE library-specification PUBLIC "-//Apache Software Foundation//Tapestry Specification 4.0//EN"
"http://jakarta.apache.org/tapestry/dtd/Tapestry_4_0.dtd">
<library-specification>
<component-type type="Test" specification-path="test/Test.jwc"/>
</library-specification>
格式都是固定的，每新建一个component，添加一个<component-type />标签就ok了，刚才我们不是吧*.jwc文件都要放到WEB-INF下面吗？现在看到了吧，我们这里加一个specification-path属性之后，jwc文件就可以随意放置了，这样我们就可以把相应的jwc文件，java文件都放在一起，省的到处乱放了。而在WEB-INF下，我们只需要一个t4.application文件，即使你有n个components
3. 测试
ok，重启运行一下，效果不变
done！
----------------------------------------------------------------------
四、reference
Creating Tapestry components