作者:bluesky35(蓝天)
开发环境: Windows2000 + JBuilderX + Tomcat4.0.6
前言:
大家好,我是bluesky35(蓝天),虽然最近很忙,但还是不忘写几篇原创文章上来和大家一起交流,希望大家能支持我
.这篇文章是关于自定义tag解析的,相信大家都用过struts的自定义标签库吧,在jsp中写<html:text property="XXX">就能显示出一个text框,第一次用struts时我觉得很神奇,IE是怎么识别这个标签并将它解析成text框的呢?下面就让我们一起揭开自定义标签的神秘面纱吧.1.在JBuilderX中新建一个project取名为MyTaglib.
2.接下来我们先做一个servlet,通过servlet调用包含自定义tag的jsp文件.在project根目录下创建一个package名为myservlet.src,然后选择菜单File->New->Web->Servlet创建名为myservlet的servlet,Package选择myservlet.src,Web module新建名为WebModule1的web module,如下图所示:
修改myservlet,代码如下:
package myservlet.src;
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
import java.util.*;
public class myservlet extends HttpServlet {
private static final String CONTENT_TYPE = "text/html; charset=Shift_JIS";
//Initialize global variables
public void init() throws ServletException {
}
//Process the HTTP Get request
public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setContentType(CONTENT_TYPE);
String scope = request.getParameter("txtscope");
request.getRequestDispatcher("/jsp/bluesky.jsp").forward(request,response);
}
//Clean up resources
public void destroy() {
}
}
好了,servlet配置好了,我们看一下现在的环境情况,如下图所示:
休息一下,接下来我们要正式进入自定义tag的编写了.
4.右击Module directory选择New->Directory,建立名为jsp的目录,然后右击jsp目录选择New->JSP新建名为bluesky的jsp文件,内容如下:
<%@ page contentType="text/html; charset=GB2312"%>
<html>
<head>
<%@ taglib prefix="bluesky" uri="bluesky-taglib" %>
<title>
bluesky
</title>
<body bgcolor="#ffffff">
<form method="post">
<br><br>
<bluesky:text color="#ff0000" blueskytext="I am bluesky" name="bluesky"/>
</form>
</body>
</html>
大家或许已经看出来了,<bluesky:text color="#ff0000" blueskytext="I am bluesky" name="bluesky"/>就是我们要解析的框,bluesky:text就是我们自定义的tag,color,blueskytext和name就是我们自定义的property,我们将在下面的代码中解析.好,我们继续吧^-^.
5.为了解析bluesky.jsp里的tag,我们要先定义有关tag的property,右击Module directory选择New->Directory,建立名为tlds的目录,然后右击tlds目录选择New->File,新建Type为tld类型,名为Mytld的tld文件,里面定义了tag相关property的信息,内容如下:
<?xml version="1.0" encoding="GB2312"?>
<!DOCTYPE taglib
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"
"http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">
<taglib>
<tlibversion>1.0</tlibversion>
<jspversion>1.1</jspversion>
<shortname>Bluesky Library</shortname>
<!-- Text -->
<tag>
<name>text</name>
<tagclass>mytag.src.text</tagclass>
<bodycontent>jsp</bodycontent>
<info>My Text Tag</info>
<attribute>
<name>color</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>blueskytext</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>
color,blueskytext和name都已经定义在里面了.
6.修改WebModule1\Module directory\WEB-INF\web.xml,加入以下内容:
<taglib>
<taglib-uri>bluesky-taglib</taglib-uri>
<taglib-location>/tlds/mytld.tld</taglib-location>
</taglib>
至此,web.xml中的全部内容如下所示:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" "http://java.sun.com/j2ee/dtds/web-app_2_2.dtd">
<web-app>
<display-name>WebModule1</display-name>
<servlet>
<servlet-name>myservlet</servlet-name>
<servlet-class>myservlet.src.myservlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>myservlet</servlet-name>
<url-pattern>/myservlet</url-pattern>
</servlet-mapping>
<taglib>
<taglib-uri>bluesky-taglib</taglib-uri>
<taglib-location>/tlds/mytld.tld</taglib-location>
</taglib>
</web-app>
好了,我们的定义工作已经全部完成了,休息一下吧^-^,接下来我们要为这些定义编写代码了,也就是解析color,blueskytext和name的代码.
7.在project根目录下创建一个package名为mytag.src,右击mytag.src选择New->Class,建立名为text的class,我们把解析的代码写在里面,text.java内容如下:
package mytag.src;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.TagSupport;
import javax.servlet.jsp.tagext.TryCatchFinally;
public class text extends TagSupport implements TryCatchFinally {
private String color = "";
private String text = "";
private String name = "";
private String html = "";
public int doStartTag() throws JspException {
return SKIP_BODY;
}
public void doCatch(Throwable arg0) throws Throwable {
}
public int doEndTag() throws JspException {
try {
JspWriter out = pageContext.getOut();
html = "<input type=\"text\"" + " name=\"" + this.name + "\"" + " value=\"" + this.text + "\""+ " style=\"background-color:" + this.color + "\"/>";
out.print(html);
} catch(java.io.IOException e) {
e.printStackTrace();
}
return EVAL_PAGE;
}
public void doFinally() {
}
public void setColor(String value) {
this.color = value;
}
public void setBlueskytext(String value) {
this.text = value;
}
public void setName(String value) {
this.name = value;
}
}
好了,解析代码已经全部写好,接下来我们要配置一下运行设置
8.选择JB的菜单Run->Configurations,按New按钮新建一个运行,在Name里填上你自己喜欢的名字,我填了mytag,Type里选择Servet,因为我们要将他作为一个Servlet运行,然后点击JSP/Servlet,单击Launch URL右边的按钮,在弹出的对话框中选择Servlet mapping中的/myservlet.
好了,至此我们已经做好了所有的工作,接下来运行看看效果吧^-^
9.运行刚刚创建的运行实例mytag,JB会先启动Tomcat服务器,然后运行Servlet,调用jsp并且解析我们的tag,以下是最后配置好的环境以及运行结果:
配置好后的环境:
运行结果:
呵呵,里面的text框就是我们自定义的tag,怎么样?感觉还不错吧,大家可以创建自己的taglib,里面可以包含各式各样自己的tag,爽吧,好了,关于自定义tag的讨论就到这里告一段落了,下次再见!