Reviews : Java Books :
Professional Java Server Programming J2EE Edition : Chapter 12

Title: Professional Java Server Programming J2EE Edition ISBN: 1861004656 US Price: $ 64.99 Canadian Price: C$ 97.95 UK Price: £ 46.99 Publication Date: September 2000 Pages: 1633 © Wrox Press Limited, US and UK.

This amount of access equals power. Note, though, that it is poor style to modify request and response directly from a tag handler. Custom tags should be thought of as generic building blocks intended for use in a wide variety of contexts. In practice tags should not be concerned with the parameters passed to the JSP page. Although a tag handler can access request parameters, relying on doing so will greatly reduce its reusability.

The Simple Example Revisited

To catch our breath after all this theory, let's look again at the Java implementation of the simple example we introduced earlier. We see that the tag handler extends TagSupport, and so gets most of its functionality for free. It has no state and accesses no file or other resources, so there is no need to override release(). We use doEndTag() to access the PageContext, obtain a JspWriter, and generate output:

package tagext;

import java.io.IOException;
import java.util.Date;
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;
//  Implementation of a tag to generate a single piece of HTML.
public class HelloTag extends TagSupport {

//  This method will be called when the JSP engine encounters the start
//  of a tag implemented by this class
	public int doStartTag() throws JspTagException {
		// This return value means that the JSP engine 
		// should evaluate the contents and any child tags of this tag
		return EVAL_BODY_INCLUDE;
}

//  This method will be called when the JSP engine encounters the end
//  of a tag implemented by this class
	public int doEndTag() throws JspTagException {
		String dateString = new Date().toString();
		try {
			pageContext.getOut().write("Hello world.<br/>");
			pageContext.getOut().write("My name is " + getClass().getName() +
				" and it's " + dateString + "<p/>");
}
		catch (IOException ex) {
			throw new JspTagException
				("Fatal error: hello tag could not write to JSP out");
}
		// This return value means that the JSP engine 
		// should continue to evaluate the rest of this page
		return EVAL_PAGE;
}
}  // class HelloTag

Note that we need to check for IOExceptions when generating output. Any exception encountered while processing the tag must be wrapped as a JspException if it is to be rethrown; it is good practice to use the javax.servlet.jsp.JspTagException subclass of JspException. (Note that, confusingly, this isn't in the same package as the other classes specific to tag handlers.)

How to Add Java Applets to Your Site

New on the Java Boutique:

New Review:

Time Management Made Easy with the Quartz Enterprise Job Scheduler
Why not just use the Java timer API? This open source scheduling API boasts simplicity, ease-of-integration, a well-rounded feature set, and it's free!

New Applet:

Reverse Complement
Reverse Complement is a simple applet that converts DNA or RNA sequences into three useful formats.

Elsewhere on internet.com:

WebDeveloper Java
Lots of Java information on webdeveloper.com

WDVL Java
Thorough Java resource at the Web Developer's Virtual Library.

ScriptSearch Java
Hundreds of free Java code files to download.

jGuru: Your View of the Java Universe
Customizable portal with online training, FAQs, regular news updates, and tutorials.