Tapestry4自定义组件的方法(操作篇)

ybhuxiao

浏览: 192438 次
性别:
来自: 北京

最近访客更多访客>>

jiduoduo

yhldbl

ilu73

charles751

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

tapestry 4.x

Tapestry Apache XML Web Myeclipse

请参考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

  <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

0
顶

2
踩

分享到：

做个图片的防盗链 | Spring笔记（未完）

2010-04-11 20:36
浏览 3484
评论(0)
分类:编程语言
查看更多

发表评论

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

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论