Tag Attributes


Resin
FAQ
Reference Guide
JavaDoc
Demo
Tutorial

JSP page
Config
URLs
Database Forms
XTP Copy
Hello Tag
Vary Filter
HardCore
Mailing Forms
Beans
Cache
XSL Filter
run-at

Attr Tag
Mail Tag
XSL Tag
Connection Tag

Tag Attributes

Hello Tag

Mail Tag

Tags become more useful once you add attributes. This example creates a ct:href tag.

With session rewriting, even browsers without cookies can support sessions. However, every <a href> needs a call to response.encodeURL(), which is annoying. With the ct:href tag, you get that for free.

Using an attribute taglib

href.jsp
<%@ taglib prefix="ct" uri="WEB-INF/tags.tld" %> Message: <ct:href href="test.jsp">test link</ct:href>

Defining the tag

The href tag has a single attribute href. Corresponding to the attribute href, the HrefTag class implements getHref() and setHref() methods.

HrefTag.java
package test; import java.io.; import javax.servlet.jsp.; import javax.servlet.jsp.tagext.*; public class HrefTag extends TagSupport { private String href; public String getHref() { return href; } public void setHref(String href) { this.href = href; } public int doStartTag() throws JspException { try { JspWriter out = pageContext.getOut(); HttpServletResponse response; response = (HttpServletResponse) pageContext.getResponse(); out.print("<a href=\""); out.print(response.encodeURL(href)); out.print("\">"); } catch (IOException e) { } return EVAL_BODY; } public int doEndTag() throws JspException { try { pageContext.getOut().print("</a>"); } catch (IOException e) { } return EVAL_PAGE; } }

Attribute Configuration

Each expected attribute needs an entry in the .tld. In this case, href is a required attribute, so the configuration needs to set required. By setting required, the JSP parser can detect errors at parse-time, making it easier to develop JSP pages with the tag library.

WEB-INF/tag.tld
<taglib> <tag> <name>href</name> <tagclass>test.HrefTag</tagclass> <attribute> <name>href</name> <required>true</required> </attribute> </tag> </taglib>

Hello Tag

Mail Tag