| career | drupal | java | mac | mysql | perl | scala | uml | unix  

Tomcat example source code file (

This example Tomcat source code file ( is included in the "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Java - Tomcat tags/keywords

http, jspcontext, jspcontext, jspfragment, jspfragment, jsptag, jsptag, servlet, simpletag, simpletag

The Tomcat source code

* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements.  See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License.  You may obtain a copy of the License at
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* See the License for the specific language governing permissions and
* limitations under the License.
package javax.servlet.jsp.tagext;

import javax.servlet.jsp.JspContext;

 * Interface for defining Simple Tag Handlers.
 * <p>Simple Tag Handlers differ from Classic Tag Handlers in that instead 
 * of supporting <code>doStartTag() and doEndTag(), 
 * the <code>SimpleTag interface provides a simple 
 * <code>doTag() method, which is called once and only once for any 
 * given tag invocation.  All tag logic, iteration, body evaluations, etc. 
 * are to be performed in this single method.  Thus, simple tag handlers 
 * have the equivalent power of <code>BodyTag, but with a much 
 * simpler lifecycle and interface.</p>
 * <p>To support body content, the setJspBody() 
 * method is provided.  The container invokes the <code>setJspBody() 
 * method with a <code>JspFragment object encapsulating the body of 
 * the tag.  The tag handler implementation can call 
 * <code>invoke() on that fragment to evaluate the body as
 * many times as it needs.</p>
 * <p>A SimpleTag handler must have a public no-args constructor.  Most
 * SimpleTag handlers should extend SimpleTagSupport.</p>
 * <p>Lifecycle

* * <p>The following is a non-normative, brief overview of the * SimpleTag lifecycle. Refer to the JSP Specification for details.</p> * * <ol> * <li>A new tag handler instance is created each time by the container * by calling the provided zero-args constructor. Unlike classic * tag handlers, simple tag handlers are never cached and reused by * the JSP container.</li> * <li>The setJspContext() and setParent() * methods are called by the container. The <code>setParent() * method is only called if the element is nested within another tag * invocation.</li> * <li>The setters for each attribute defined for this tag are called * by the container.</li> * <li>If a body exists, the setJspBody() method is called * by the container to set the body of this tag, as a * <code>JspFragment. If the action element is empty in * the page, this method is not called at all.</li> * <li>The doTag() method is called by the container. All * tag logic, iteration, body evaluations, etc. occur in this * method.</li> * <li>The doTag() method returns and all variables are * synchronized.</li> * </ol> * * @see SimpleTagSupport * @since 2.0 */ public interface SimpleTag extends JspTag { /** * Called by the container to invoke this tag. * The implementation of this method is provided by the tag library * developer, and handles all tag processing, body iteration, etc. * * <p> * The JSP container will resynchronize any AT_BEGIN and AT_END * variables (defined by the associated tag file, TagExtraInfo, or TLD) * after the invocation of doTag(). * * @throws javax.servlet.jsp.JspException If an error occurred * while processing this tag. * @throws javax.servlet.jsp.SkipPageException If the page that * (either directly or indirectly) invoked this tag is to * cease evaluation. A Simple Tag Handler generated from a * tag file must throw this exception if an invoked Classic * Tag Handler returned SKIP_PAGE or if an invoked Simple * Tag Handler threw SkipPageException or if an invoked Jsp Fragment * threw a SkipPageException. * @throws If there was an error writing to the * output stream. */ public void doTag() throws javax.servlet.jsp.JspException,; /** * Sets the parent of this tag, for collaboration purposes. * <p> * The container invokes this method only if this tag invocation is * nested within another tag invocation. * * @param parent the tag that encloses this tag */ public void setParent( JspTag parent ); /** * Returns the parent of this tag, for collaboration purposes. * * @return the parent of this tag */ public JspTag getParent(); /** * Called by the container to provide this tag handler with * the <code>JspContext for this invocation. * An implementation should save this value. * * @param pc the page context for this invocation * @see Tag#setPageContext */ public void setJspContext( JspContext pc ); /** * Provides the body of this tag as a JspFragment object, able to be * invoked zero or more times by the tag handler. * <p> * This method is invoked by the JSP page implementation * object prior to <code>doTag(). If the action element is * empty in the page, this method is not called at all. * * @param jspBody The fragment encapsulating the body of this tag. */ public void setJspBody( JspFragment jspBody ); }

Other Tomcat examples (source code examples)

Here is a short list of links related to this Tomcat source code file:

... this post is sponsored by my books ...

#1 New Release!

FP Best Seller


new blog posts


Copyright 1998-2021 Alvin Alexander,
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.