作者: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的讨论就到这里告一段落了,下次再见! 
|