You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ba...@apache.org on 2014/01/19 04:42:47 UTC
svn commit: r1559462 [3/4] - in /tomcat/site/trunk/docs/taglibs: ./ css/
site/ standard/
Modified: tomcat/site/trunk/docs/taglibs/site/tutorial.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/taglibs/site/tutorial.html?rev=1559462&r1=1559461&r2=1559462&view=diff
==============================================================================
--- tomcat/site/trunk/docs/taglibs/site/tutorial.html (original)
+++ tomcat/site/trunk/docs/taglibs/site/tutorial.html Sun Jan 19 03:42:46 2014
@@ -1,5 +1,5 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 1, 2012 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.4 at 18 January 2014 -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -12,7 +12,7 @@
</style>
<link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
<meta name="author" content="Justyna Horwat" />
- <meta name="Date-Revision-yyyymmdd" content="20121001" />
+ <meta name="Date-Revision-yyyymmdd" content="20140118" />
<meta http-equiv="Content-Language" content="en" />
</head>
@@ -30,10 +30,9 @@
</div>
<div id="breadcrumbs">
-
+
<div class="xleft">
- <span id="publishDate">Last Published: 01 October 2012</span>
- | <span id="projectVersion">Version: 1-SNAPSHOT</span>
+ <span id="publishDate">Last Published: 18 January 2014</span>
</div>
<div class="xright"> <a href="http://www.apachecon.com/" class="externalLink" title="ApacheCon">ApacheCon</a>
|
@@ -41,7 +40,7 @@
|
<a href="../../../" title="Tomcat">Tomcat</a>
-
+
</div>
<div class="clear">
<hr/>
@@ -50,7 +49,7 @@
<div id="leftColumn">
<div id="navcolumn">
-
+
<h5>Apache Taglibs</h5>
<ul>
<li class="none">
@@ -63,6 +62,9 @@
<strong>Tutorial</strong>
</li>
<li class="none">
+ <a href="../site/building.html" title="Building/Source">Building/Source</a>
+ </li>
+ <li class="none">
<a href="../site/news.html" title="News Archives">News Archives</a>
</li>
</ul>
@@ -86,12 +88,6 @@
<li class="none">
<a href="../../../bugreport.html" title="Bugs">Bugs</a>
</li>
- <li class="none">
- <a href="../integration.html" title="CI">CI</a>
- </li>
- <li class="none">
- <a href="http://wiki.apache.org/jakarta-taglibs/FrontPage" class="externalLink" title="Wiki">Wiki</a>
- </li>
</ul>
<h5>ASF</h5>
<ul>
@@ -109,7 +105,7 @@
<img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
</a>
-
+
</div>
</div>
<div id="bodyColumn">
@@ -118,7 +114,9 @@
-<div class="section"><h2>Overview<a name="Overview"></a></h2>
+<div class="section">
+<h2>Overview<a name="Overview"></a></h2>
+
<p>This tutorial will give you an overview of how some of the basic tags in the
Jakarta-Taglibs library were created. Tag libraries allow you to create custom
actions and encapsulate functionality. Custom tags can clearly separate the
@@ -126,365 +124,576 @@
components that have access to all the objects available to JSP pages. Please
consult the <a class="externalLink" href="http://www.jcp.org/aboutJava/communityprocess/final/jsr053">JavaServer
Pages Specification, version 1.2</a> for more details. </p>
+
<p>Servers that implement JSP, v1.1+ support tag libraries. You can find a description
of various servers and what they currently support at the
<a class="externalLink" href="http://java.sun.com/products/jsp/industry.html">
JavaServer Pages Industry Momentum</a> page. There is also has a very good
<a class="externalLink" href="http://java.sun.com/webservices/docs/ea1/tutorial/index.html"> Java Web Services Tutorial</a> available on Sun's website that includes sections on <a class="externalLink" href="http://java.sun.com/webservices/docs/ea1/tutorial/doc/JSPTags.html"> Custom Tags</a> and the <a class="externalLink" href="http://java.sun.com/webservices/docs/ea1/tutorial/doc/JSTL.html">JSP Standard Tag Library (JSTL)</a>.</p>
+
<ul>
- <div class="section"><h3>
+
+<div class="section">
+<h3>
<a href="#tag_handler">Tag Handler</a>
<a name="Tag_Handler"></a></h3>
server-side object that helps evaluate actions during the execution of a JSP
page
- </div><div class="section"><h3>
+ </div>
+<div class="section">
+<h3>
<a href="#tag_library">Tag Library Descriptor</a>
<a name="Tag_Library_Descriptor"></a></h3>
xml file that defines tag names and tag attributes
- </div><div class="section"><h3>
+ </div>
+<div class="section">
+<h3>
<a href="#tag_jsp">JSP</a>
<a name="JSP"></a></h3>
tag library is made available to the JSP page using the <tt>taglib</tt>
directive
- </div><div class="section"><h3>
+ </div>
+<div class="section">
+<h3>
<a href="#tag_install">Installation and Deployment</a>
<a name="Installation_and_Deployment"></a></h3>
how to install a pre-existing tag library
- </div><div class="section"><h3>
+ </div>
+<div class="section">
+<h3>
<a href="#tag_examples">Examples</a>
<a name="Examples"></a></h3>
code illustrations
</ul>
</div></div>
-<div class="section"><h2>Tag Handler<a name="Tag_Handler"></a></h2>
+
+<div class="section">
+<h2>Tag Handler<a name="Tag_Handler"></a></h2>
+
<p>The Tag Handler is responsible for the interaction between the JSP page and
additional server-side objects. The handler is invoked during the execution
of a JSP page when a custom tag is encountered. The <tt>doStartTag()</tt>
and <tt>doEndTag()</tt> methods are invoked when the start and end custom
tags, respectively, are encountered. The<tt> release()</tt> method releases
resources allocated by the tag handler.</p>
+
<p>There are two interfaces that describe a tag handler: </p>
+
<table class="bodyTable" width="75%" border="1" align="center">
- <tr class="a">
- <td width="27%"><tt>Tag</tt></td>
- <td width="73%">used for simple tag handlers not interested in manipulating
+
+<tr class="a">
+
+<td width="27%"><tt>Tag</tt></td>
+
+<td width="73%">used for simple tag handlers not interested in manipulating
their body content</td>
</tr>
- <tr class="b">
- <td width="27%"><tt>BodyTag</tt></td>
- <td width="73%">an extension of Tag and gives the handler access to its body</td>
+
+<tr class="b">
+
+<td width="27%"><tt>BodyTag</tt></td>
+
+<td width="73%">an extension of Tag and gives the handler access to its body</td>
</tr>
</table>
+
<p> The Tag Handler has two main action methods:</p>
+
<table class="bodyTable" width="75%" border="1" align="center">
- <tr class="a">
- <td width="28%" height="32"><tt>doStartTag()</tt></td>
- <td width="72%" height="32">
- <p>process the start tag of this action.</p>
+
+<tr class="a">
+
+<td width="28%" height="32"><tt>doStartTag()</tt></td>
+
+<td width="72%" height="32">
+
+<p>process the start tag of this action.</p>
</td>
</tr>
- <tr class="b">
- <td width="28%" height="40"><tt>doEndTag()</tt></td>
- <td width="72%" height="40">process the end tag of this action. Called after
+
+<tr class="b">
+
+<td width="28%" height="40"><tt>doEndTag()</tt></td>
+
+<td width="72%" height="40">process the end tag of this action. Called after
returning from doStartTag.</td>
</tr>
- <tr class="a">
- <td width="28%" height="40"><tt>release()</tt></td>
- <td width="72%" height="40">release resources</td>
+
+<tr class="a">
+
+<td width="28%" height="40"><tt>release()</tt></td>
+
+<td width="72%" height="40">release resources</td>
</tr>
</table>
+
<blockquote>
- <p><tt>doStartTag</tt>() returns the following: </p>
- <ul>
- <li><tt>EVAL_BODY_INCLUDE</tt>
- <ul>
- <li>process the body of the action but do not create a new BodyContent. Pass the body through without manipulating it. Only valid if you <b>DON'T</b> implement the <tt>BodyTag</tt> interface.</li>
+
+<p><tt>doStartTag</tt>() returns the following: </p>
+
+<ul>
+
+<li><tt>EVAL_BODY_INCLUDE</tt>
+
+<ul>
+
+<li>process the body of the action but do not create a new BodyContent. Pass the body through without manipulating it. Only valid if you <b>DON'T</b> implement the <tt>BodyTag</tt> interface.</li>
</ul>
</li>
- <li><tt>EVAL_BODY_TAG</tt>
- <ul>
- <li>process the body of the action and create a new BodyContent. Only valid if you <b>DO</b> implement the <tt>BodyTag</tt> interface.</li>
+
+<li><tt>EVAL_BODY_TAG</tt>
+
+<ul>
+
+<li>process the body of the action and create a new BodyContent. Only valid if you <b>DO</b> implement the <tt>BodyTag</tt> interface.</li>
</ul>
</li>
- <li><tt>SKIP_BODY</tt>
- <ul>
- <li>do not evaluate the body of the tag</li>
+
+<li><tt>SKIP_BODY</tt>
+
+<ul>
+
+<li>do not evaluate the body of the tag</li>
</ul>
</li>
</ul>
- <p><tt>doEndTag</tt>() returns the following: </p>
- <ul>
- <li><tt>EVAL_PAGE</tt>
- <ul>
- <li>the rest of the JSP page will be evaluated</li>
+
+<p><tt>doEndTag</tt>() returns the following: </p>
+
+<ul>
+
+<li><tt>EVAL_PAGE</tt>
+
+<ul>
+
+<li>the rest of the JSP page will be evaluated</li>
</ul>
</li>
- <li><tt>SKIP_PAGE</tt>
- <ul>
- <li>the rest of the JSP page will not be evaluated </li>
+
+<li><tt>SKIP_PAGE</tt>
+
+<ul>
+
+<li>the rest of the JSP page will not be evaluated </li>
</ul>
</li>
</ul>
</blockquote>
+
<p>The return values direct the JSP container on how to evaluate the rest of the
JSP page. The <tt>release()</tt> method releases resources allocated by
the tag handler.</p>
+
<p><tt>TagSupport</tt> and <tt>BodyTagSupport</tt> are subclasses of <tt>Tag</tt>
and can be used as base classes when creating new tag handlers. </p>
+
<p>The <tt>TagSupport</tt> class is a utility class that implements the <tt>Tag</tt>
interface and adds additional convenience methods including:</p>
+
<ul>
- <li> getter method for <tt>Tag</tt> properties</li>
+
+<li> getter method for <tt>Tag</tt> properties</li>
</ul>
+
<p>If the tag handler manipulates the body of an action, it must implement the
<tt>BodyTag</tt> interface. <tt>doStartTag</tt>() must return <tt>EVAL_BODY_TAG</tt>
in order for the body of the tag to be evaluated. If <tt>SKIP_BODY</tt>
is returned, the body will be ignored. Methods that interact with the body content
include:</p>
+
<table class="bodyTable" width="75%" border="1" align="center">
- <tr class="a">
- <td width="27%"><tt>doInitBody</tt>()</td>
- <td width="73%">invoked before the body of the tag is evaluated but after
+
+<tr class="a">
+
+<td width="27%"><tt>doInitBody</tt>()</td>
+
+<td width="73%">invoked before the body of the tag is evaluated but after
body content is set</td>
</tr>
- <tr class="b">
- <td width="27%"><tt>doAfterBody</tt>()</td>
- <td width="73%">invoked after body content is evaluated</td>
+
+<tr class="b">
+
+<td width="27%"><tt>doAfterBody</tt>()</td>
+
+<td width="73%">invoked after body content is evaluated</td>
</tr>
</table>
+
<p> <tt> </tt>The <tt>BodyTagSupport</tt> class implements the <tt>BodyTag</tt>
interface and adds additional convenience methods. Some of these methods include:</p>
+
<ul>
- <li>getter for the <tt>bodyContent</tt> property</li>
- <li>getter for the previous <tt>out</tt> JSPWriter</li>
+
+<li>getter for the <tt>bodyContent</tt> property</li>
+
+<li>getter for the previous <tt>out</tt> JSPWriter</li>
</ul>
+
<p>In a Web Application handlers must reside in one of the following standard
locations for Java classes:</p>
+
<ul>
- <li>in a JAR file in the <tt>/WEB-INF/lib</tt> directory</li>
- <li>in a directory in the <tt>/WEB-INF/classes</tt> directory</li>
+
+<li>in a JAR file in the <tt>/WEB-INF/lib</tt> directory</li>
+
+<li>in a directory in the <tt>/WEB-INF/classes</tt> directory</li>
</ul>
+
<p>A tag handler has access to some properties that are set by the JSP container
using setter methods. This includes the <tt>pageContext</tt> and <tt>parent</tt>
objects. The tag handler also has access to server-side objects and enclosing
actions. If the tag is nested, the parent handler of the enclosing tag can be
accessed by using either:</p>
+
<ul>
- <li><tt> TagSupport.getParent()</tt></li>
- <li><tt>TagSupport.findAncestorWithClass(from, class)</tt></li>
+
+<li><tt> TagSupport.getParent()</tt></li>
+
+<li><tt>TagSupport.findAncestorWithClass(from, class)</tt></li>
</ul>
+
<p>The parent handler's statically and dynamically created objects can be obtained
once the parent object is retrieved.</p>
</div>
-<div class="section"><h2>Tag Library Descriptor<a name="Tag_Library_Descriptor"></a></h2>
+
+<div class="section">
+<h2>Tag Library Descriptor<a name="Tag_Library_Descriptor"></a></h2>
+
<p>The Tag Library Descriptor (TLD) is used by the JSP container to interpret pages that include the taglib directives referring to that tag library. It is an XML document that maps action tags to tag handler classes. You can locate a TLD in two ways:</p>
+
+<ul>
+
+<li><tt>web.xml</tt> <tt>taglib</tt> element
+
+<ul>
+
+<li><tt>taglib-uri</tt>
+
<ul>
- <li><tt>web.xml</tt> <tt>taglib</tt> element
- <ul>
- <li><tt>taglib-uri</tt>
- <ul>
- <li>uri identifying a Tag Library</li>
+
+<li>uri identifying a Tag Library</li>
</ul>
</li>
- <li><tt>taglib-location</tt>
- <ul>
- <li>location, as a resource, where the TLD file can be found</li>
+
+<li><tt>taglib-location</tt>
+
+<ul>
+
+<li>location, as a resource, where the TLD file can be found</li>
</ul>
</li>
</ul>
</li>
- <li>default mapping</li>
+
+<li>default mapping</li>
</ul>
+
<p>You can find more information about the web.xml <tt>taglib</tt> element in the Servlet 2.2 and JSP 1.1 specifications.</p>
+
<p>You will need to explicitly reference the external DOCTYPE because of a recent change to call the validating parser:</p>
-<div><pre>
+
+<div>
+<pre>
<!DOCTYPE taglib
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"
"http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">
</pre></div>
+
<p>The TLD <tt>taglib</tt> element is the document root. It has the following subelements:
</p>
+
<table class="bodyTable" width="75%" border="1" align="center">
- <tr class="a">
- <td width="23%" height="22"><tt>tlibversion</tt></td>
- <td width="77%" height="22">version of the tag library implementation</td>
+
+<tr class="a">
+
+<td width="23%" height="22"><tt>tlibversion</tt></td>
+
+<td width="77%" height="22">version of the tag library implementation</td>
</tr>
- <tr class="b">
- <td width="23%"><tt>jspversion</tt></td>
- <td width="77%">version of the JSP specification the tag library requires</td>
+
+<tr class="b">
+
+<td width="23%"><tt>jspversion</tt></td>
+
+<td width="77%">version of the JSP specification the tag library requires</td>
</tr>
- <tr class="a">
- <td width="23%"><tt>shortname</tt></td>
- <td width="77%">name that could be used to reference the tag library from
+
+<tr class="a">
+
+<td width="23%"><tt>shortname</tt></td>
+
+<td width="77%">name that could be used to reference the tag library from
a JSP page</td>
</tr>
- <tr class="b">
- <td width="23%"><tt>uri</tt></td>
- <td width="77%">uri uniquely identifying the tag library - info string describing the "use" of the tag library </td>
+
+<tr class="b">
+
+<td width="23%"><tt>uri</tt></td>
+
+<td width="77%">uri uniquely identifying the tag library - info string describing the "use" of the tag library </td>
</tr>
- <tr class="a">
- <td width="23%"><tt>info</tt></td>
- <td width="77%">string describing the "use" of the tag library </td>
+
+<tr class="a">
+
+<td width="23%"><tt>info</tt></td>
+
+<td width="77%">string describing the "use" of the tag library </td>
</tr>
</table>
+
<p>The tag element defines an action in the tag library. It may have several subelements that define the action: </p>
+
<table class="bodyTable" width="75%" border="1" align="center">
- <tr class="a">
- <td><tt>name</tt></td>
- <td>unique action name</td>
+
+<tr class="a">
+
+<td><tt>name</tt></td>
+
+<td>unique action name</td>
</tr>
- <tr class="b">
- <td><tt>tagclass</tt></td>
- <td>tag handler class implementing <tt>javax.servlet.jsp.tagext.Tag</tt></td>
+
+<tr class="b">
+
+<td><tt>tagclass</tt></td>
+
+<td>tag handler class implementing <tt>javax.servlet.jsp.tagext.Tag</tt></td>
</tr>
- <tr class="a">
- <td><tt>teiclass</tt></td>
- <td>optional subclass of <tt>javax.servlet.jsp.tagext.TagExtraInfo</tt></td>
+
+<tr class="a">
+
+<td><tt>teiclass</tt></td>
+
+<td>optional subclass of <tt>javax.servlet.jsp.tagext.TagExtraInfo</tt></td>
</tr>
- <tr class="b">
- <td height="18"><tt>bodycontent</tt></td>
- <td height="18">
- <p>one of three body content types</p>
+
+<tr class="b">
+
+<td height="18"><tt>bodycontent</tt></td>
+
+<td height="18">
+
+<p>one of three body content types</p>
</td>
</tr>
- <tr class="a">
- <td><tt>info</tt></td>
- <td>
- <p>optional tag-specific information</p>
+
+<tr class="a">
+
+<td><tt>info</tt></td>
+
+<td>
+
+<p>optional tag-specific information</p>
</td>
</tr>
- <tr class="b">
- <td><tt>attribute</tt></td>
- <td>
- <p>all attributes of the action</p>
+
+<tr class="b">
+
+<td><tt>attribute</tt></td>
+
+<td>
+
+<p>all attributes of the action</p>
</td>
</tr>
</table>
+
<blockquote>
- <p><tt>bodycontent</tt> is included if the tag has a body. It is used by
+
+<p><tt>bodycontent</tt> is included if the tag has a body. It is used by
page composition tools so it does not affect the composition of the body.
It can be one of the three following types:</p>
- <ul>
- <li><tt>JSP</tt> (default)
- <ul>
- <li> the JSP container should evaluate any body of the tag, but it can
+
+<ul>
+
+<li><tt>JSP</tt> (default)
+
+<ul>
+
+<li> the JSP container should evaluate any body of the tag, but it can
also be empty</li>
</ul>
</li>
- <li><tt>tagdependent</tt>
- <ul>
- <li>any body of the tag would be handled by the tag itself, but it can
+
+<li><tt>tagdependent</tt>
+
+<ul>
+
+<li>any body of the tag would be handled by the tag itself, but it can
also be empty</li>
</ul>
</li>
- <li><tt>empty</tt>
- <ul>
- <li>body must be empty</li>
+
+<li><tt>empty</tt>
+
+<ul>
+
+<li>body must be empty</li>
</ul>
</li>
</ul>
- <p>the <tt>teiclass</tt> defines the scripting variable and includes the
+
+<p>the <tt>teiclass</tt> defines the scripting variable and includes the
following information:</p>
- <ul>
- <li>name</li>
- <li>type</li>
- <li>whether variable needs to be created or not</li>
- <li>scope</li>
+
+<ul>
+
+<li>name</li>
+
+<li>type</li>
+
+<li>whether variable needs to be created or not</li>
+
+<li>scope</li>
</ul>
- <p><tt>attributes</tt> can have the following fields:</p>
- <ul>
- <li><tt>name</tt> (required)
- <ul>
- <li>attribute name</li>
+
+<p><tt>attributes</tt> can have the following fields:</p>
+
+<ul>
+
+<li><tt>name</tt> (required)
+
+<ul>
+
+<li>attribute name</li>
</ul>
</li>
- <li><tt>required</tt>
- <ul>
- <li>if attribute is required or optional</li>
+
+<li><tt>required</tt>
+
+<ul>
+
+<li>if attribute is required or optional</li>
</ul>
</li>
- <li><tt>rtexprvalue</tt>
- <ul>
- <li>if attribute value may be dynamically calculated at runtime by a scriptlet.
+
+<li><tt>rtexprvalue</tt>
+
+<ul>
+
+<li>if attribute value may be dynamically calculated at runtime by a scriptlet.
NOTE: default value is "false", meaning that the attribute
has a static value. Make sure you set it to "true" if the
attribute value is determined at request time.</li>
</ul>
</li>
</ul>
- <p>For every attribute you must have a JavaBeans style get and set methods in
+
+<p>For every attribute you must have a JavaBeans style get and set methods in
the Tag Handler. If your attribute is named <tt>id</tt>, the <tt>TagSupport</tt>
class defines the <tt>setId</tt>() and <tt>getId</tt>() methods for
you.</p>
</blockquote>
</div>
-<div class="section"><h2>JavaServer Pages<a name="JavaServer_Pages"></a></h2>
+
+<div class="section">
+<h2>JavaServer Pages<a name="JavaServer_Pages"></a></h2>
+
<p>JavaServer Pages can handle XML content encapsulated in Tag Library actions.</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
<%@ taglib uri="identifier" prefix="prefix" %>
</pre></div>
</tt>
+
<p>To use a Tag Library, you need to tell the JSP container where it is located
using a <tt>taglib</tt> directive. The directive must come <b>before</b> any actions.</p>
+
<ul>
- <li>The "identifier" will need to match the one used in <tt><taglib-uri></tt>
+
+<li>The "identifier" will need to match the one used in <tt><taglib-uri></tt>
in the web.xml file.</li>
- <li>The "prefix" distinguishes which tag library will be used.</li>
+
+<li>The "prefix" distinguishes which tag library will be used.</li>
</ul>
</div>
-<div class="section"><h2>Installation and Deployment<a name="Installation_and_Deployment"></a></h2>
-<div class="section"><h3>a) Creating a Generic Tag Library <a name="a_Creating_a_Generic_Tag_Library"></a></h3>
+<div class="section">
+<h2>Installation and Deployment<a name="Installation_and_Deployment"></a></h2>
+
+
+<div class="section">
+<h3>a) Creating a Generic Tag Library <a name="a_Creating_a_Generic_Tag_Library"></a></h3>
+
<p>To Install a tag library you need to take the following steps:</p>
+
<ol style="list-style-type: decimal">
- <li>bundle the tag classes in a jar file. Make sure to include the taglib <tt>{library}.tld</tt> file located in the <tt>/WEB-INF</tt> directory</li>
- <li>add the tag <tt>{library}.jar</tt> file to the <tt>CLASSPATH</tt></li>
- <li>copy the <tt>{library}.jar</tt> file to the <tt>/WEB-INF/lib</tt> directory</li>
- <li>define the taglib element in the <tt>/WEB-INF/web.xml</tt> file. For example:
- <div><pre>
+
+<li>bundle the tag classes in a jar file. Make sure to include the taglib <tt>{library}.tld</tt> file located in the <tt>/WEB-INF</tt> directory</li>
+
+<li>add the tag <tt>{library}.jar</tt> file to the <tt>CLASSPATH</tt></li>
+
+<li>copy the <tt>{library}.jar</tt> file to the <tt>/WEB-INF/lib</tt> directory</li>
+
+<li>define the taglib element in the <tt>/WEB-INF/web.xml</tt> file. For example:
+
+<div>
+<pre>
<taglib>
<taglib-uri>http://jakarta.apache.org/taglibs/{library}</taglib-uri>
<taglib-location>/WEB-INF/{library}.tld</taglib-location>
</taglib>
</pre></div>
</li>
- <li>define the tag extension in the jsp page. The <tt><taglib-uri></tt> and the <tt>uri</tt> directive must match. The <tt>prefix</tt> identifies the tags in the tag library within the jsp page. For example:</li>
- <div><pre>
+
+<li>define the tag extension in the jsp page. The <tt><taglib-uri></tt> and the <tt>uri</tt> directive must match. The <tt>prefix</tt> identifies the tags in the tag library within the jsp page. For example:</li>
+
+<div>
+<pre>
<%@ taglib uri="http://jakarta.apache.org/taglibs/{library}" prefix="x" %>
</pre></div>
</ol>
-</div><div class="section"><h3>b) Adding a Jakarta-Taglibs Library <a name="b_Adding_a_Jakarta-Taglibs_Library"></a></h3>
+</div>
+<div class="section">
+<h3>b) Adding a Jakarta-Taglibs Library <a name="b_Adding_a_Jakarta-Taglibs_Library"></a></h3>
+
<p>To add a tag library subproject to Jakarta-Taglibs you need to do the following:</p>
+
<ol style="list-style-type: decimal">
- <li>create a top level directory for the project.</li>
- <li>copy the following top-level files from one of the existing subprojects:
- <ul>
- <li><tt>build.sh</tt></li>
- <li><tt>build.bat</tt></li>
- <li><tt>build.xml</tt></li>
+
+<li>create a top level directory for the project.</li>
+
+<li>copy the following top-level files from one of the existing subprojects:
+
+<ul>
+
+<li><tt>build.sh</tt></li>
+
+<li><tt>build.bat</tt></li>
+
+<li><tt>build.xml</tt></li>
</ul>
</li>
- <li>change the <tt>taglib.name</tt> property to the new custom tag library subproject name</li>
- <li>duplicate the directory structure from one of the existing subprojects</li>
- <li>modify the top-level Jakarta-Taglibs <tt>build.xml</tt> file to include the new library</li>
+
+<li>change the <tt>taglib.name</tt> property to the new custom tag library subproject name</li>
+
+<li>duplicate the directory structure from one of the existing subprojects</li>
+
+<li>modify the top-level Jakarta-Taglibs <tt>build.xml</tt> file to include the new library</li>
</ol>
-</div><div class="section"><h3>c) Deploying a Tag Library<a name="c_Deploying_a_Tag_Library"></a></h3>
+</div>
+<div class="section">
+<h3>c) Deploying a Tag Library<a name="c_Deploying_a_Tag_Library"></a></h3>
+
<p>Use the build scripts in the <tt>jakarta-taglibs</tt> project to create the war files.
Once you have a war file built you can simply place that file in the <tt>$TOMCAT_HOME/webapps</tt>
directory. Tomcat will load your classes and create the new context.</p>
+
<p>The war file should have the following structure:</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
META-INF/
META-INF/MANIFEST.MF
WEB-INF/
@@ -495,50 +704,78 @@ directory. Tomcat will load your classes
WEB-INF/{tagLibrary}.tld
</pre></div>
</tt>
+
<p>If you do not want to use a jar file, you can place all the class files in the
<tt>/WEB-INF/classes</tt> directory.</p>
+
<p>Consult the <a class="externalLink" href="http://java.sun.com/products/servlet/download.html">Java
Servlet Specification, v2.2</a> for more information on war files.</p>
</div></div>
-<div class="section"><h2>Examples<a name="Examples"></a></h2>
+
+<div class="section">
+<h2>Examples<a name="Examples"></a></h2>
+
<p>Some examples include:</p>
+
<ul>
- <li><a href="#tag_basic">Basic Tag</a></li>
- <li><a href="#tag_nested">Simple Nested Tag</a></li>
- <li><a href="#tag_UtilityTags">UtilityTags Library Documentation</a></li>
+
+<li><a href="#tag_basic">Basic Tag</a></li>
+
+<li><a href="#tag_nested">Simple Nested Tag</a></li>
+
+<li><a href="#tag_UtilityTags">UtilityTags Library Documentation</a></li>
</ul>
</div>
-<div class="section"><h2>Basic Tag<a name="Basic_Tag"></a></h2>
+
+<div class="section">
+<h2>Basic Tag<a name="Basic_Tag"></a></h2>
+
<p>This basic tag is the "Hello World" example. The text "Hello World" will print whenever the
tag is encountered.</p>
+
<ul>
- <li><a href="#basic_tag_handler">Tag Handler</a></li>
- <li><a href="#basic_tag_library">Tag Library Descriptor</a></li>
- <li><a href="#basic_tag_webxml">web.xml file</a></li>
- <li><a href="#basic_tag_jsp">JSP</a></li>
+
+<li><a href="#basic_tag_handler">Tag Handler</a></li>
+
+<li><a href="#basic_tag_library">Tag Library Descriptor</a></li>
+
+<li><a href="#basic_tag_webxml">web.xml file</a></li>
+
+<li><a href="#basic_tag_jsp">JSP</a></li>
</ul>
-<div class="section"><h3><a name="basic_tag_handler">Hello World Tag Handler</a><a name="Hello_World_Tag_Handler"></a></h3>
+
+<div class="section">
+<h3><a name="basic_tag_handler">Hello World Tag Handler</a><a name="Hello_World_Tag_Handler"></a></h3>
+
<p>You can find the Tag Handler for the Hello World tag in the <tt>/WEB-INF/classes/basic</tt>
directory since it is a part of the basic package</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
package basic;
</pre></div>
</tt>
+
<p>Import the jsp and tag classes:</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;
</pre></div>
</tt>
+
<p>The Hello World Tag Handler implements the <tt>doStartTag</tt>() method which is invoked when the start tag is encountered.</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
public int doStartTag() throws JspException {
try {
pageContext.getOut().print("Hello World");
@@ -549,26 +786,37 @@ tag is encountered.</p>
}
</pre></div>
</tt>
+
<p>The <tt>pageContext</tt> is set by the JSP container and is available to
the Tag Handler. The <tt>SKIP_BODY</tt> value makes sure that no evaluation
of the tag body takes place.</p>
-</div><div class="section"><h3><a name="basic_tag_library">Hello World Tag Library Descriptor</a><a name="Hello_World_Tag_Library_Descriptor"></a></h3>
+</div>
+<div class="section">
+<h3><a name="basic_tag_library">Hello World Tag Library Descriptor</a><a name="Hello_World_Tag_Library_Descriptor"></a></h3>
<tt>
-<div><pre>
+
+<div>
+<pre>
<?xml version="1.0" encoding="ISO-8859-1" ?>
</pre></div>
</tt>
+
<p>XML header describing the deployment descriptor DOCTYPE. The deployment descriptor
includes the elements and configuration information of a web application.</p>
<tt>
-<div><pre> <!DOCTYPE taglib
+
+<div>
+<pre> <!DOCTYPE taglib
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"
"http://java.sun.com/j2ee/dtds/web-jsptaglib_1_1.dtd">
</pre></div>
</tt>
+
<p>Initial taglibrary description</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
<taglib>
<!-- The version number of this tag library -->
<tlibversion>1.0</tlibversion>
@@ -588,13 +836,19 @@ tag is encountered.</p>
</info>
</pre></div>
</tt>
+
<p>Hello World tag description.</p>
+
<ul>
- <li>tagclass element associates the Hello World tag handler with the Hello World tag</li>
- <li><tt>bodycontent</tt> tag tells us that the tag will not contain any body</li>
+
+<li>tagclass element associates the Hello World tag handler with the Hello World tag</li>
+
+<li><tt>bodycontent</tt> tag tells us that the tag will not contain any body</li>
</ul>
<tt>
-<div><pre>
+
+<div>
+<pre>
<!-- Hello tag -->
<tag>
<name>Hello</name>
@@ -605,14 +859,20 @@ tag is encountered.</p>
</info>
</tag></pre></div>
</tt>
-</div><div class="section"><h3><a name="basic_tag_webxml"></a>web.xml file<a name="web.xml_file"></a></h3>
+</div>
+<div class="section">
+<h3><a name="basic_tag_webxml"></a>web.xml file<a name="web.xml_file"></a></h3>
+
<p>The <tt>web.xml</tt> file describes the mapping between the taglib <tt>uri</tt>
and the location of the Tag Library Descriptor.</p>
+
<p>Here the unique <tt>taglib-uri</tt> "<tt>http://jakarta.apache.org/taglibs/utilitytags</tt>"
is associated with the Tag Library Descriptor in <tt>/WEB-INF/tld/utilitytags.tld</tt>.</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
<web-app>
<taglib>
<taglib-uri>
@@ -625,57 +885,84 @@ tag is encountered.</p>
</web-app>
</pre></div>
</tt>
-</div><div class="section"><h3><a name="basic_tag_jsp">Hello World jsp</a><a name="Hello_World_jsp"></a></h3>
+</div>
+<div class="section">
+<h3><a name="basic_tag_jsp">Hello World jsp</a><a name="Hello_World_jsp"></a></h3>
+
<p>The following directive tells the JSP container to use the "<tt>http://jakarta.apache.org/taglibs/utilitytags</tt>"
<tt>uri</tt> defined in <tt>web.xml</tt>. "<tt>jLib</tt>" is defined
as the prefix value for the tag.
</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
<%@ taglib uri="http://jakarta.apache.org/taglibs/utilitytags" prefix="jLib" %>
</pre></div>
</tt>
+
<p>The Hello World tag is called. The tag name "Hello" is defined in the the Tag
Library Descriptor.</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
<jLib:Hello/>
</pre></div>
</tt>
</div></div>
-<div class="section"><h2>Simple Nested Action<a name="Simple_Nested_Action"></a></h2>
+
+<div class="section">
+<h2>Simple Nested Action<a name="Simple_Nested_Action"></a></h2>
+
<p>This nested tag is an example of an "If" conditional tag. Based on the value of the attribute
the included scriptlet will be evaluated or skipped.</p>
+
<ul>
- <li><a href="#nested_tag_handler">Tag Handler</a></li>
- <li><a href="#nested_tag_library">Tag Library Descriptor</a></li>
- <li><a href="#nested_tag_webxml">web.xml file</a></li>
- <li><a href="#nested_tag_jsp">JSP</a></li>
+
+<li><a href="#nested_tag_handler">Tag Handler</a></li>
+
+<li><a href="#nested_tag_library">Tag Library Descriptor</a></li>
+
+<li><a href="#nested_tag_webxml">web.xml file</a></li>
+
+<li><a href="#nested_tag_jsp">JSP</a></li>
</ul>
-<div class="section"><h3><a name="nested_tag_handler">If Tag Handler</a><a name="If_Tag_Handler"></a></h3>
+
+<div class="section">
+<h3><a name="nested_tag_handler">If Tag Handler</a><a name="If_Tag_Handler"></a></h3>
+
<p>The <tt>BodyTagSupport</tt> class implements the <tt>BodyTag</tt> interface and has getter methods for the <tt>bodyContent</tt> property.
</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
public class IfTag extends BodyTagSupport {
</pre></div>
</tt>
+
<p>The <tt>doStartTag()</tt> method which is invoked when the start tag is encountered and calls the local <tt>getPredicate()</tt> method. If the return value is true, the rest of the the tag body is evaluated, otherwise it is skipped.
</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
public int doStartTag() {
if (getPredicate()) return EVAL_BODY_TAG;
else return SKIP_BODY;
}
</pre></div>
</tt>
+
<p><tt>doAfterBody()</tt> is called after some body has been evaluated. It is not invoked
in empty tags or in tags returning <tt>SKIP_BODY</tt> in <tt>doStartTag()</tt>.</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
public int doAfterBody() throws JspException {
try {
bodyContent.writeOut(bodyContent.getEnclosingWriter());
@@ -686,18 +973,25 @@ the included scriptlet will be evaluated
}
</pre></div>
</tt>
-</div><div class="section"><h3><a name="nested_tag_library">If Tag Library Descriptor</a><a name="If_Tag_Library_Descriptor"></a></h3>
+</div>
+<div class="section">
+<h3><a name="nested_tag_library">If Tag Library Descriptor</a><a name="If_Tag_Library_Descriptor"></a></h3>
<tt>
-<div><pre>
+
+<div>
+<pre>
<!-- IF tag -->
<tag>
<name>If</name>
<tagclass>lang.IfTag</tagclass>
</pre></div>
</tt>
+
<p>The If tag has one required attribute. Since the <tt>rtexprvalue</tt> is set to true, the attribute can have scriptlet expressions as a value. The value can be dynamically calculated at request time.</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
<attribute>
<name>predicate</name>
<required>true</required>
@@ -709,18 +1003,27 @@ the included scriptlet will be evaluated
</tag>
</pre></div>
</tt>
-</div><div class="section"><h3><a name="nested_tag_webxml"></a>web.xml file<a name="web.xml_file"></a></h3>
+</div>
+<div class="section">
+<h3><a name="nested_tag_webxml"></a>web.xml file<a name="web.xml_file"></a></h3>
+
<p>The <tt>web.xml</tt> file describes the mapping between the taglib <tt>uri</tt>
and the location of the Tag Library Descriptor.</p>
+
<p>Here the unique <tt>taglib-uri</tt> "<tt>http://jakarta.apache.org/taglibs/utilitytags</tt>"
is associated with the Tag Library Descriptor in <tt>/WEB-INF/tld/utilitytags.tld</tt>.</p>
-</div><div class="section"><h3><a name="nested_tag_jsp">If JSP</a><a name="If_JSP"></a></h3>
+</div>
+<div class="section">
+<h3><a name="nested_tag_jsp">If JSP</a><a name="If_JSP"></a></h3>
+
<p>The If tag requires one attribute. The predicate attribute includes a scriptlet
which will be evaluated at runtime. Based on the predicate attribute value,
the <tt>jLib:Hello</tt> tag will be evaluated or skipped.</p>
<tt>
-<div><pre>
+
+<div>
+<pre>
<jlib:if predicate="<%= x==5 %>">
<jLib:Hello/>
</jlib:if>
@@ -728,30 +1031,47 @@ the included scriptlet will be evaluated
</tt>
</div></div>
-<div class="section"><h2>Documentation for the UtilityTags Tag Library<a name="Documentation_for_the_UtilityTags_Tag_Library"></a></h2>
-<div class="section"><h3>1. INTRODUCTION<a name="a1._INTRODUCTION"></a></h3>
+<div class="section">
+<h2>Documentation for the UtilityTags Tag Library<a name="Documentation_for_the_UtilityTags_Tag_Library"></a></h2>
+
+
+<div class="section">
+<h3>1. INTRODUCTION<a name="a1._INTRODUCTION"></a></h3>
+
<p>The <tt>utilitytags</tt> custom tag library contains examples of some basic
tags. It illustrates several straightforward custom tag library code techniques.</p>
-</div><div class="section"><h3>2. PREREQUISITE SOFTWARE<a name="a2._PREREQUISITE_SOFTWARE"></a></h3>
+</div>
+<div class="section">
+<h3>2. PREREQUISITE SOFTWARE<a name="a2._PREREQUISITE_SOFTWARE"></a></h3>
+
<p>This custom tag library requires no software other than a servlet container
that supports the <a class="externalLink" href="ftp://ftp.java.sun.com/pub/jsp/11final-87721/jsp1_1-spec.pdf">
JavaServer Pages Specification, version 1.1</a>.</p>
-</div><div class="section"><h3>3. CONFIGURATION INFORMATION<a name="a3._CONFIGURATION_INFORMATION"></a></h3>
+</div>
+<div class="section">
+<h3>3. CONFIGURATION INFORMATION<a name="a3._CONFIGURATION_INFORMATION"></a></h3>
+
<p>Follow these steps to configure your web application with this tag library:</p>
+
<ul>
- <li>Copy the tag library descriptor file (<tt>utilitytags/utilitytags.tld</tt>)
+
+<li>Copy the tag library descriptor file (<tt>utilitytags/utilitytags.tld</tt>)
to the <tt>/WEB-INF</tt> subdirectory of your web application.</li>
- <li>Copy the tag library JAR file (<tt>utilitytags/utilitytags.jar</tt>)
+
+<li>Copy the tag library JAR file (<tt>utilitytags/utilitytags.jar</tt>)
to the <tt>/WEB-INF/lib</tt> subdirectory of your web application.</li>
- <li>Add a <tt><taglib></tt> element to your web application deployment
+
+<li>Add a <tt><taglib></tt> element to your web application deployment
descriptor in <tt>/WEB-INF/web.xml</tt> like this:
- <div><pre>
+
+<div>
+<pre>
<taglib>
<taglib-uri>http://jakarta.apache.org/taglibs/utilitytags</taglib-uri>
<taglib-location>/WEB-INF/utilitytags.tld</taglib-location>
@@ -760,374 +1080,615 @@ JavaServer Pages Specification, version
</li>
</ul>
+
<p>To use the tags from this library in your JSP pages, add the following
directive at the top of each page:</p>
-<div><pre>
+
+<div>
+<pre>
<%@ taglib uri="http://jakarta.apache.org/taglibs/utilitytags" prefix="x" %>
</pre></div>
where "x" is the tag name prefix you wish to use for tags from this library. You
can change this value to any prefix you like.
-</div><div class="section"><h3>4. TAG DOCUMENTATION<a name="a4._TAG_DOCUMENTATION"></a></h3>
+</div>
+<div class="section">
+<h3>4. TAG DOCUMENTATION<a name="a4._TAG_DOCUMENTATION"></a></h3>
+
<p>The <tt>utilitytags</tt> Tag Library contains the following tags:</p>
+
<ol style="list-style-type: decimal">
- <li>
- </div><div class="section"><h3>Hello Tag<a name="Hello_Tag"></a></h3>
- <p>The <tt>Hello</tt> tag prints out the text "Hello World". It does not
+
+<li>
+ </div>
+<div class="section">
+<h3>Hello Tag<a name="Hello_Tag"></a></h3>
+
+<p>The <tt>Hello</tt> tag prints out the text "Hello World". It does not
have any attributes.</p>
- <table class="bodyTable" width="75%" border="1">
- <tr class="a">
- <th>
- <div align="center">Attribute</div>
+
+<table class="bodyTable" width="75%" border="1">
+
+<tr class="a">
+
+<th>
+
+<div align="center">Attribute</div>
</th>
- <th>
- <div align="center">Description</div>
+
+<th>
+
+<div align="center">Description</div>
</th>
- <th>
- <div align="center">Required</div>
+
+<th>
+
+<div align="center">Required</div>
</th>
</tr>
- <tr class="b">
- <td>
- <div align="center">-</div>
+
+<tr class="b">
+
+<td>
+
+<div align="center">-</div>
</td>
- <td>
- <div align="center">-</div>
+
+<td>
+
+<div align="center">-</div>
</td>
- <td>
- <div align="center">-</div>
+
+<td>
+
+<div align="center">-</div>
</td>
</tr>
</table>
</li>
- <li>
- </div><div class="section"><h3>Copy Tag<a name="Copy_Tag"></a></h3>
- <p>The <tt>MacroCopy</tt> tag copies the attribute text to a Writer.</p>
- <table class="bodyTable" width="75%" border="1">
- <tr class="a">
- <th>
- <div align="center">Attribute</div>
- </th>
- <th>
- <div align="center">Description</div>
- </th>
- <th>
- <div align="center">Required</div>
- </th>
- </tr>
- <tr class="b">
- <td>
- <div align="center">name</div>
+
+<li>
+ </div>
+<div class="section">
+<h3>Copy Tag<a name="Copy_Tag"></a></h3>
+
+<p>The <tt>MacroCopy</tt> tag copies the attribute text to a Writer.</p>
+
+<table class="bodyTable" width="75%" border="1">
+
+<tr class="a">
+
+<th>
+
+<div align="center">Attribute</div>
+ </th>
+
+<th>
+
+<div align="center">Description</div>
+ </th>
+
+<th>
+
+<div align="center">Required</div>
+ </th>
+ </tr>
+
+<tr class="b">
+
+<td>
+
+<div align="center">name</div>
</td>
- <td>
- <div align="center">Name associated with the text to be copied. Any
+
+<td>
+
+<div align="center">Name associated with the text to be copied. Any
string value.</div>
</td>
- <td>
- <div align="center">yes</div>
+
+<td>
+
+<div align="center">yes</div>
</td>
</tr>
</table>
</li>
- <li>
- </div><div class="section"><h3>Paste Tag<a name="Paste_Tag"></a></h3>
- <p>The <tt>MacroPaste</tt> tag pastes the text specified by a Writer.</p>
- <table class="bodyTable" width="75%" border="1">
- <tr class="a">
- <th>
- <div align="center">Attribute</div>
- </th>
- <th>
- <div align="center">Description</div>
- </th>
- <th>
- <div align="center">Required</div>
- </th>
- </tr>
- <tr class="b">
- <td>
- <div align="center">name</div>
+
+<li>
+ </div>
+<div class="section">
+<h3>Paste Tag<a name="Paste_Tag"></a></h3>
+
+<p>The <tt>MacroPaste</tt> tag pastes the text specified by a Writer.</p>
+
+<table class="bodyTable" width="75%" border="1">
+
+<tr class="a">
+
+<th>
+
+<div align="center">Attribute</div>
+ </th>
+
+<th>
+
+<div align="center">Description</div>
+ </th>
+
+<th>
+
+<div align="center">Required</div>
+ </th>
+ </tr>
+
+<tr class="b">
+
+<td>
+
+<div align="center">name</div>
</td>
- <td>
- <div align="center">Name associated with the text to be pasted. Any
+
+<td>
+
+<div align="center">Name associated with the text to be pasted. Any
string value.</div>
</td>
- <td>
- <div align="center">yes</div>
+
+<td>
+
+<div align="center">yes</div>
</td>
</tr>
</table>
</li>
- <li>
- </div><div class="section"><h3>ShowSource Tag<a name="ShowSource_Tag"></a></h3>
- <p>The <tt>ShowSource</tt> tag takes a jspFile and copies the contents
+
+<li>
+ </div>
+<div class="section">
+<h3>ShowSource Tag<a name="ShowSource_Tag"></a></h3>
+
+<p>The <tt>ShowSource</tt> tag takes a jspFile and copies the contents
to a Writer.</p>
- <table class="bodyTable" width="75%" border="1">
- <tr class="a">
- <th>
- <div align="center">Attribute</div>
+
+<table class="bodyTable" width="75%" border="1">
+
+<tr class="a">
+
+<th>
+
+<div align="center">Attribute</div>
</th>
- <th>
- <div align="center">Description</div>
+
+<th>
+
+<div align="center">Description</div>
</th>
- <th>
- <div align="center">Required</div>
+
+<th>
+
+<div align="center">Required</div>
</th>
</tr>
- <tr class="b">
- <td>
- <div align="center">jspFile</div>
+
+<tr class="b">
+
+<td>
+
+<div align="center">jspFile</div>
</td>
- <td>
- <div align="center">The filename and relative path of the jsp file.
+
+<td>
+
+<div align="center">The filename and relative path of the jsp file.
Any string value.</div>
</td>
- <td>
- <div align="center">yes</div>
+
+<td>
+
+<div align="center">yes</div>
</td>
</tr>
</table>
</li>
- <li>
- </div><div class="section"><h3>Include Tag<a name="Include_Tag"></a></h3>
- <p>The <tt>Include</tt> tag includes in-line the output of the specified
+
+<li>
+ </div>
+<div class="section">
+<h3>Include Tag<a name="Include_Tag"></a></h3>
+
+<p>The <tt>Include</tt> tag includes in-line the output of the specified
url.</p>
- <table class="bodyTable" width="75%" border="1">
- <tr class="a">
- <th>
- <div align="center">Attribute</div>
+
+<table class="bodyTable" width="75%" border="1">
+
+<tr class="a">
+
+<th>
+
+<div align="center">Attribute</div>
</th>
- <th>
- <div align="center">Description</div>
+
+<th>
+
+<div align="center">Description</div>
</th>
- <th>
- <div align="center">Required</div>
+
+<th>
+
+<div align="center">Required</div>
</th>
</tr>
- <tr class="b">
- <td>
- <div align="center">url</div>
+
+<tr class="b">
+
+<td>
+
+<div align="center">url</div>
</td>
- <td>
- <div align="center">Any valid url.</div>
+
+<td>
+
+<div align="center">Any valid url.</div>
</td>
- <td>
- <div align="center">yes</div>
+
+<td>
+
+<div align="center">yes</div>
</td>
</tr>
</table>
</li>
- <li>
- </div><div class="section"><h3>If Tag<a name="If_Tag"></a></h3>
- <p>The <tt>If</tt> tag is a basic conditional tag.</p>
- <table class="bodyTable" width="75%" border="1">
- <tr class="a">
- <th>
- <div align="center">Attribute</div>
- </th>
- <th>
- <div align="center">Description</div>
- </th>
- <th>
- <div align="center">Required</div>
- </th>
- </tr>
- <tr class="b">
- <td>
- <div align="center">predicate</div>
+
+<li>
+ </div>
+<div class="section">
+<h3>If Tag<a name="If_Tag"></a></h3>
+
+<p>The <tt>If</tt> tag is a basic conditional tag.</p>
+
+<table class="bodyTable" width="75%" border="1">
+
+<tr class="a">
+
+<th>
+
+<div align="center">Attribute</div>
+ </th>
+
+<th>
+
+<div align="center">Description</div>
+ </th>
+
+<th>
+
+<div align="center">Required</div>
+ </th>
+ </tr>
+
+<tr class="b">
+
+<td>
+
+<div align="center">predicate</div>
</td>
- <td>
- <div align="center">Any string value.</div>
+
+<td>
+
+<div align="center">Any string value.</div>
</td>
- <td>
- <div align="center">yes</div>
+
+<td>
+
+<div align="center">yes</div>
</td>
</tr>
</table>
</li>
- <li>
- </div><div class="section"><h3>For Tag<a name="For_Tag"></a></h3>
- <p>The <tt>For</tt> tag is a basic looping tag.</p>
- <table class="bodyTable" width="75%" border="1">
- <tr class="a">
- <th>
- <div align="center">Attribute</div>
- </th>
- <th>
- <div align="center">Description</div>
- </th>
- <th>
- <div align="center">Required</div>
- </th>
- </tr>
- <tr class="b">
- <td>
- <div align="center">iterations</div>
+
+<li>
+ </div>
+<div class="section">
+<h3>For Tag<a name="For_Tag"></a></h3>
+
+<p>The <tt>For</tt> tag is a basic looping tag.</p>
+
+<table class="bodyTable" width="75%" border="1">
+
+<tr class="a">
+
+<th>
+
+<div align="center">Attribute</div>
+ </th>
+
+<th>
+
+<div align="center">Description</div>
+ </th>
+
+<th>
+
+<div align="center">Required</div>
+ </th>
+ </tr>
+
+<tr class="b">
+
+<td>
+
+<div align="center">iterations</div>
</td>
- <td>
- <div align="center">Number of loop iterations to be completed. Any string
+
+<td>
+
+<div align="center">Number of loop iterations to be completed. Any string
integer value.</div>
</td>
- <td>
- <div align="center">yes</div>
+
+<td>
+
+<div align="center">yes</div>
</td>
</tr>
- <tr class="a">
- <td>
- <div align="center">varName</div>
+
+<tr class="a">
+
+<td>
+
+<div align="center">varName</div>
</td>
- <td>
- <div align="center">Variable name associated with the For loop. Any
+
+<td>
+
+<div align="center">Variable name associated with the For loop. Any
string value.</div>
</td>
- <td>
- <div align="center">no</div>
+
+<td>
+
+<div align="center">no</div>
</td>
</tr>
- <tr class="b">
- <td>
- <div align="center">begin</div>
+
+<tr class="b">
+
+<td>
+
+<div align="center">begin</div>
</td>
- <td>
- <div align="center">Loop starting value. Any string integer value.</div>
+
+<td>
+
+<div align="center">Loop starting value. Any string integer value.</div>
</td>
- <td>
- <div align="center">no</div>
+
+<td>
+
+<div align="center">no</div>
</td>
</tr>
</table>
</li>
- <li>
- </div><div class="section"><h3>useBean Tag<a name="useBean_Tag"></a></h3>
- <p>The <tt>useBean</tt> tag associates an instance of a Java object with the given id.</p>
- <table class="bodyTable" width="75%" border="1">
- <tr class="a">
- <th>
- <div align="center">Attribute</div>
+
+<li>
+ </div>
+<div class="section">
+<h3>useBean Tag<a name="useBean_Tag"></a></h3>
+
+<p>The <tt>useBean</tt> tag associates an instance of a Java object with the given id.</p>
+
+<table class="bodyTable" width="75%" border="1">
+
+<tr class="a">
+
+<th>
+
+<div align="center">Attribute</div>
</th>
- <th>
- <div align="center">Description</div>
+
+<th>
+
+<div align="center">Description</div>
</th>
- <th>
- <div align="center">Required</div>
+
+<th>
+
+<div align="center">Required</div>
</th>
</tr>
- <tr class="b">
- <td>
- <div align="center">id</div>
+
+<tr class="b">
+
+<td>
+
+<div align="center">id</div>
</td>
- <td>
- <div align="center">Uniquely identifies the bean to the JSP container and page. Any string value.</div>
+
+<td>
+
+<div align="center">Uniquely identifies the bean to the JSP container and page. Any string value.</div>
</td>
- <td>
- <div align="center">yes</div>
+
+<td>
+
+<div align="center">yes</div>
</td>
</tr>
- <tr class="a">
- <td>
- <div align="center">scope</div>
+
+<tr class="a">
+
+<td>
+
+<div align="center">scope</div>
</td>
- <td>
- <div align="center">page|request|session|application</div>
+
+<td>
+
+<div align="center">page|request|session|application</div>
</td>
- <td>
- <div align="center">no</div>
+
+<td>
+
+<div align="center">no</div>
</td>
</tr>
- <tr class="b">
- <td>
- <div align="center">classname</div>
+
+<tr class="b">
+
+<td>
+
+<div align="center">classname</div>
</td>
- <td>
- <div align="center">name of class that defines the implementation of the object.</div>
+
+<td>
+
+<div align="center">name of class that defines the implementation of the object.</div>
</td>
- <td>
- <div align="center">no</div>
+
+<td>
+
+<div align="center">no</div>
</td>
</tr>
- <tr class="a">
- <td>
- <div align="center">type</div>
+
+<tr class="a">
+
+<td>
+
+<div align="center">type</div>
</td>
- <td>
- <div align="center">type of the scripting variable defined</div>
+
+<td>
+
+<div align="center">type of the scripting variable defined</div>
</td>
- <td>
- <div align="center">no</div>
+
+<td>
+
+<div align="center">no</div>
</td>
</tr>
- <tr class="b">
- <td>
- <div align="center">beanName</div>
+
+<tr class="b">
+
+<td>
+
+<div align="center">beanName</div>
</td>
- <td>
- <div align="center">The name of the bean as expected by the instantiate() method of the java.beans.Beans class</div>
+
+<td>
+
+<div align="center">The name of the bean as expected by the instantiate() method of the java.beans.Beans class</div>
</td>
- <td>
- <div align="center">yes</div>
+
+<td>
+
+<div align="center">yes</div>
</td>
</tr>
- <tr class="a">
- <td>
- <div align="center">processRequest</div>
+
+<tr class="a">
+
+<td>
+
+<div align="center">processRequest</div>
</td>
- <td>
- <div align="center">true|false. JSP 0.92 compatibility.</div>
+
+<td>
+
+<div align="center">true|false. JSP 0.92 compatibility.</div>
</td>
- <td>
- <div align="center">no</div>
+
+<td>
+
+<div align="center">no</div>
</td>
</tr>
</table>
</li>
- <li>
- </div><div class="section"><h3>Validate Tag<a name="Validate_Tag"></a></h3>
- <p>The <tt>Validate</tt> tag generates Javascript to validate the HTML
+
+<li>
+ </div>
+<div class="section">
+<h3>Validate Tag<a name="Validate_Tag"></a></h3>
+
+<p>The <tt>Validate</tt> tag generates Javascript to validate the HTML
form.</p>
- <table class="bodyTable" width="75%" border="1">
- <tr class="a">
- <th>
- <div align="center">Attribute</div>
+
+<table class="bodyTable" width="75%" border="1">
+
+<tr class="a">
+
+<th>
+
+<div align="center">Attribute</div>
</th>
- <th>
- <div align="center">Description</div>
+
+<th>
+
+<div align="center">Description</div>
</th>
- <th>
- <div align="center">Required</div>
+
+<th>
+
+<div align="center">Required</div>
</th>
</tr>
- <tr class="b">
- <td>
- <div align="center">name</div>
+
+<tr class="b">
+
+<td>
+
+<div align="center">name</div>
</td>
- <td>
- <div align="center">Name of the form. Any string value.</div>
+
+<td>
+
+<div align="center">Name of the form. Any string value.</div>
</td>
- <td>
- <div align="center">yes</div>
+
+<td>
+
+<div align="center">yes</div>
</td>
</tr>
- <tr class="a">
- <td>
- <div align="center">method</div>
+
+<tr class="a">
+
+<td>
+
+<div align="center">method</div>
</td>
- <td>
- <div align="center">Name of the Javascript function to be generated. Any string value.</div>
+
+<td>
+
+<div align="center">Name of the Javascript function to be generated. Any string value.</div>
</td>
- <td>
- <div align="center">yes</div>
+
+<td>
+
+<div align="center">yes</div>
</td>
</tr>
- <tr class="b">
- <td>
- <div align="center">reqdFields</div>
+
+<tr class="b">
+
+<td>
+
+<div align="center">reqdFields</div>
</td>
- <td>
- <div align="center">Comma separated mandatory field list. Any string value.</div>
+
+<td>
+
+<div align="center">Comma separated mandatory field list. Any string value.</div>
</td>
- <td>
- <div align="center">yes</div>
+
+<td>
+
+<div align="center">yes</div>
</td>
</tr>
</table>
@@ -1143,14 +1704,14 @@ can change this value to any prefix you
</div>
<div id="footer">
<div class="xright">
- Copyright © 2000-2012
+ Copyright © 2000-2014
<a href="http://www.apache.org/">The Apache Software Foundation</a>.
All Rights Reserved.
-
+
</div>
<div class="clear">
<hr/>
</div>
</div>
</body>
-</html>
\ No newline at end of file
+</html>
Modified: tomcat/site/trunk/docs/taglibs/site/using.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/taglibs/site/using.html?rev=1559462&r1=1559461&r2=1559462&view=diff
==============================================================================
--- tomcat/site/trunk/docs/taglibs/site/using.html (original)
+++ tomcat/site/trunk/docs/taglibs/site/using.html Sun Jan 19 03:42:46 2014
@@ -1,5 +1,5 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 1, 2012 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.4 at 18 January 2014 -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -12,7 +12,7 @@
</style>
<link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
<meta name="author" content="Craig R. McClanahan" />
- <meta name="Date-Revision-yyyymmdd" content="20121001" />
+ <meta name="Date-Revision-yyyymmdd" content="20140118" />
<meta http-equiv="Content-Language" content="en" />
</head>
@@ -30,10 +30,9 @@
</div>
<div id="breadcrumbs">
-
+
<div class="xleft">
- <span id="publishDate">Last Published: 01 October 2012</span>
- | <span id="projectVersion">Version: 1-SNAPSHOT</span>
+ <span id="publishDate">Last Published: 18 January 2014</span>
</div>
<div class="xright"> <a href="http://www.apachecon.com/" class="externalLink" title="ApacheCon">ApacheCon</a>
|
@@ -41,7 +40,7 @@
|
<a href="../../../" title="Tomcat">Tomcat</a>
-
+
</div>
<div class="clear">
<hr/>
@@ -50,7 +49,7 @@
<div id="leftColumn">
<div id="navcolumn">
-
+
<h5>Apache Taglibs</h5>
<ul>
<li class="none">
@@ -63,6 +62,9 @@
<a href="../site/tutorial.html" title="Tutorial">Tutorial</a>
</li>
<li class="none">
+ <a href="../site/building.html" title="Building/Source">Building/Source</a>
+ </li>
+ <li class="none">
<a href="../site/news.html" title="News Archives">News Archives</a>
</li>
</ul>
@@ -86,12 +88,6 @@
<li class="none">
<a href="../../../bugreport.html" title="Bugs">Bugs</a>
</li>
- <li class="none">
- <a href="../integration.html" title="CI">CI</a>
- </li>
- <li class="none">
- <a href="http://wiki.apache.org/jakarta-taglibs/FrontPage" class="externalLink" title="Wiki">Wiki</a>
- </li>
</ul>
<h5>ASF</h5>
<ul>
@@ -109,7 +105,7 @@
<img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
</a>
-
+
</div>
</div>
<div id="bodyColumn">
@@ -118,56 +114,76 @@
-<div class="section"><h2>Download and Installation<a name="Download_and_Installation"></a></h2>
+<div class="section">
+<h2>Download and Installation<a name="Download_and_Installation"></a></h2>
+
<p>Binary downloads of released versions of the Apache Taglibs distributions are available from each components website.
</p>
+
<p>Note that for now, these distributions are legacy versions from the Jakarta Taglibs days. While current development is built
using Maven, the binary builds were created, and the source builds require, an Ant build system. </p>
</div>
-<div class="section"><h2>Distribution Directory Structure<a name="Distribution_Directory_Structure"></a></h2>
+
+<div class="section">
+<h2>Distribution Directory Structure<a name="Distribution_Directory_Structure"></a></h2>
+
<p>The distribution archive will contain the following file and directory
structure:
-</p><ul>
+</p>
+<ul>
+
<li><b>LICENSE</b> - A copy of the Apache Software Foundation
license under which all Jakarta project software is distributed.</li>
+
<li><b>README</b> - A brief README file that contains pointers
to the documentation that is available.</li>
+
<li><b>doc</b> - A directory containing documentation about the
JAKARTA-TAGLIBS project as a whole, including this file. The following
documents are included:
- <ul>
- <li><a href="using.html">Using the JAKARTA-TAGLIBS Binary
+
+<ul>
+
+<li><a href="using.html">Using the JAKARTA-TAGLIBS Binary
Distribution</a> (this document)</li>
- <li><a href="legacybuilding.html">Building the old JAKARTA-TAGLIBS Source
+
+<li><a href="legacybuilding.html">Building the old JAKARTA-TAGLIBS Source
Distributions</a></li>
- <li><a href="guidelines.html">Taglib Developer Guidelines</a></li>
+
+<li><a href="guidelines.html">Taglib Developer Guidelines</a></li>
</ul>
</li>
+
<li>A directory for each custom tag library included in the JAKARTA-TAGLIBS
project, where the directory name matches the short name of that project.
Each directory will contain the following files, where
<tt>{library}</tt> represents that project's short name:
- <ul>
- <li><b>{library}.tld</b> - The <i>tag library descriptor</i> file for
+
+<ul>
+
+<li><b>{library}.tld</b> - The <i>tag library descriptor</i> file for
this custom tag library. This file will normally be copied to the
<tt>/WEB-INF</tt> subdirectory within your web application, and
referenced with a <tt><taglib></tt> element in the web
application deployment descriptor (<tt>/WEB-INF/web.xml</tt>) file.</li>
- <li><b>{library}.jar</b> - A JAR file containing the Java classes and
+
+<li><b>{library}.jar</b> - A JAR file containing the Java classes and
associated resources that comprise this custom tag library. This file
will normally be copied to the <tt>/WEB-INF/lib</tt> subdirectory
within your web application, which makes these classes automatically
visible within your application.</li>
- <li><b>{library}-doc.war</b> - A web application containing developer
+
+<li><b>{library}-doc.war</b> - A web application containing developer
documentation describing how to use the tags in this custom tag library
in your own application. This web application can be deployed and
executed on any servlet container that is compatible with the Servlet
API Specification, version 2.2 or later.</li>
- <li><b>{library}-examples.war</b> - A web application containing one or
+
+<li><b>{library}-examples.war</b> - A web application containing one or
more examples that illustrate the use of this custom tag library.
This web application can be deployed and executed on any servlet
container that is compatible with the Servlet API Specification,
@@ -178,29 +194,40 @@ structure:
</div>
-<div class="section"><h2>Using a Custom Tag Library in Your Application<a name="Using_a_Custom_Tag_Library_in_Your_Application"></a></h2>
+
+<div class="section">
+<h2>Using a Custom Tag Library in Your Application<a name="Using_a_Custom_Tag_Library_in_Your_Application"></a></h2>
+
<p>To use one or more of the custom tag libraries included in JAKARTA-TAGLIBS
in your own web applications, follow these steps:
-</p><ul>
+</p>
+<ul>
+
<li>Copy the <tt>{library}.tld</tt> file to the <tt>/WEB-INF</tt>
subdirectory of your web application.</li>
+
<li>Copy the <tt>{library}.jar</tt> file to the <tt>/WEB-INF/lib</tt>
subdirectory of your web application.</li>
+
<li>Install additional JAR files for libraries required by the custom tag
library you wish to use (see the library documentation for information)
in the <tt>/WEB-INF/lib</tt> subdirectory of your web application.</li>
+
<li>For each tag library you are going to use, add a
<tt><taglib></tt> element to your web application deployment
descriptor (<tt>/WEB-INF/web.xml)</tt>) file. An example entry might
look like this:
- <div><pre>
+
+<div>
+<pre>
<taglib>
<taglib-uri>http://jakarta.apache.org/taglibs/{library}</taglib-uri>
<taglib-location>/WEB-INF/{library}.tld</taglib-location>
</taglib>
</pre></div></li>
+
<li>At the top of each JSP page in your application that needs to use one or
more tags from this custom tag library, add a
<tt><%@ taglib %></tt> directive identifying the URI of the library
@@ -208,24 +235,32 @@ in your own web applications, follow the
<tt><taglib-uri></tt> element in the web application deployment
descriptor), and the tagname prefix you will use within this page to
identify tags from this library. An example entry might look like this:
- <div><pre>
+
+<div>
+<pre>
<%@ taglib uri="http://jakarta.apache.org/taglibs/{library}" prefix="x" %>
</pre></div></li>
+
<li>Whenever you wanted to use one of the tags from this library, you would
simply include it, prefixed as you described in the <tt>taglib</tt>
directive, and including attribute names and values as described in the
documentation for this tag library. For example, if the library you are
using has a tag named <tt>magic</tt>, and you selected the "x"
prefix as described above, you would might include this custom tag:
- <div><pre>
+
+<div>
+<pre>
<x:magic/>
</pre></div>
or, if this tag required attributes and perhaps some body text:
- <div><pre>
+
+<div>
+<pre>
<x:magic id="beanName" name="xyz">
... Some body text and/or nested tags ...
</x:magic>
</pre></div></li>
+
<li>See the documentation provided with each custom tag library for
detailed descriptions of the available tags within that library.</li>
</ul>
@@ -240,14 +275,14 @@ in your own web applications, follow the
</div>
<div id="footer">
<div class="xright">
- Copyright © 2000-2012
+ Copyright © 2000-2014
<a href="http://www.apache.org/">The Apache Software Foundation</a>.
All Rights Reserved.
-
+
</div>
<div class="clear">
<hr/>
</div>
</div>
</body>
-</html>
\ No newline at end of file
+</html>
Modified: tomcat/site/trunk/docs/taglibs/source-repository.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/taglibs/source-repository.html?rev=1559462&r1=1559461&r2=1559462&view=diff
==============================================================================
--- tomcat/site/trunk/docs/taglibs/source-repository.html (original)
+++ tomcat/site/trunk/docs/taglibs/source-repository.html Sun Jan 19 03:42:46 2014
@@ -1,5 +1,5 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 1, 2012 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.4 at 18 January 2014 -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
@import url("./css/site.css");
</style>
<link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
- <meta name="Date-Revision-yyyymmdd" content="20121001" />
+ <meta name="Date-Revision-yyyymmdd" content="20140118" />
<meta http-equiv="Content-Language" content="en" />
</head>
@@ -28,10 +28,9 @@
</div>
<div id="breadcrumbs">
-
+
<div class="xleft">
- <span id="publishDate">Last Published: 01 October 2012</span>
- | <span id="projectVersion">Version: 1-SNAPSHOT</span>
+ <span id="publishDate">Last Published: 18 January 2014</span>
</div>
<div class="xright"> <a href="http://www.apachecon.com/" class="externalLink" title="ApacheCon">ApacheCon</a>
|
@@ -39,7 +38,7 @@
|
<a href="../../" title="Tomcat">Tomcat</a>
-
+
</div>
<div class="clear">
<hr/>
@@ -48,7 +47,7 @@
<div id="leftColumn">
<div id="navcolumn">
-
+
<h5>Apache Taglibs</h5>
<ul>
<li class="none">
@@ -61,6 +60,9 @@
<a href="site/tutorial.html" title="Tutorial">Tutorial</a>
</li>
<li class="none">
+ <a href="site/building.html" title="Building/Source">Building/Source</a>
+ </li>
+ <li class="none">
<a href="site/news.html" title="News Archives">News Archives</a>
</li>
</ul>
@@ -84,12 +86,6 @@
<li class="none">
<a href="../../bugreport.html" title="Bugs">Bugs</a>
</li>
- <li class="none">
- <a href="integration.html" title="CI">CI</a>
- </li>
- <li class="none">
- <a href="http://wiki.apache.org/jakarta-taglibs/FrontPage" class="externalLink" title="Wiki">Wiki</a>
- </li>
</ul>
<h5>ASF</h5>
<ul>
@@ -107,12 +103,44 @@
<img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
</a>
-
+
</div>
</div>
<div id="bodyColumn">
<div id="contentBox">
- <div class="section"><h2>Overview<a name="Overview"></a></h2><a name="Overview"></a><p>This project uses <a class="externalLink" href="http://subversion.apache.org/">Subversion</a> to manage its source code. Instructions on Subversion use can be found at <a class="externalLink" href="http://svnbook.red-bean.com/">http://svnbook.red-bean.com/</a>.</p></div><div class="section"><h2>Web Access<a name="Web_Access"></a></h2><a name="Web_Access"></a><p>The following is a link to the online source repository.</p><div class="source"><pre><a class="externalLink" href="http://svn.apache.org/viewvc/tomcat/taglibs/site">http://svn.apache.org/viewvc/tomcat/taglibs/site</a></pre></div></div><div class="section"><h2>Anonymous access<a name="Anonymous_access"></a></h2><a name="Anonymous_access"></a><p>The source can be checked out anonymously from SVN with this command:</p><div class="source"><pre>$ svn checkout http://svn.apache.org/repos/asf/tomcat/taglibs/site site</pre></div></div><div
class="section"><h2>Developer access<a name="Developer_access"></a></h2><a name="Developer_access"></a><p>Everyone can access the Subversion repository via HTTP, but Committers must checkout the Subversion repository via HTTPS.</p><div class="source"><pre>$ svn checkout https://svn.apache.org/repos/asf/tomcat/taglibs/site site</pre></div><p>To commit changes to the repository, execute the following command to commit your changes (svn will prompt you for your password)</p><div class="source"><pre>$ svn commit --username your-username -m "A message"</pre></div></div><div class="section"><h2>Access from behind a firewall<a name="Access_from_behind_a_firewall"></a></h2><a name="Access_from_behind_a_firewall"></a><p>For those users who are stuck behind a corporate firewall which is blocking HTTP access to the Subversion repository, you can try to access it via the developer connection:</p><div class="source"><pre>$ svn checkout https://svn.apache.org/repos/asf/tomcat/taglibs/si
te site</pre></div></div><div class="section"><h2>Access through a proxy<a name="Access_through_a_proxy"></a></h2><a name="Access_through_a_proxy"></a><p>The Subversion client can go through a proxy, if you configure it to do so. First, edit your "servers" configuration file to indicate which proxy to use. The file's location depends on your operating system. On Linux or Unix it is located in the directory "~/.subversion". On Windows it is in "%APPDATA%\Subversion". (Try "echo %APPDATA%", note this is a hidden directory.)</p><p>There are comments in the file explaining what to do. If you don't have that file, get the latest Subversion client and run any command; this will cause the configuration directory and template files to be created.</p><p>Example: Edit the 'servers' file and add something like:</p><div class="source"><pre>[global]
+ <div class="section">
+<h2>Overview<a name="Overview"></a></h2><a name="Overview"></a>
+<p>This project uses <a class="externalLink" href="http://subversion.apache.org/">Subversion</a> to manage its source code. Instructions on Subversion use can be found at <a class="externalLink" href="http://svnbook.red-bean.com/">http://svnbook.red-bean.com/</a>.</p></div>
+<div class="section">
+<h2>Web Access<a name="Web_Access"></a></h2><a name="Web_Access"></a>
+<p>The following is a link to the online source repository.</p>
+<div class="source">
+<pre><a class="externalLink" href="http://svn.apache.org/viewvc/tomcat/taglibs/site">http://svn.apache.org/viewvc/tomcat/taglibs/site</a></pre></div></div>
+<div class="section">
+<h2>Anonymous access<a name="Anonymous_access"></a></h2><a name="Anonymous_access"></a>
+<p>The source can be checked out anonymously from SVN with this command:</p>
+<div class="source">
+<pre>$ svn checkout http://svn.apache.org/repos/asf/tomcat/taglibs/site site</pre></div></div>
+<div class="section">
+<h2>Developer access<a name="Developer_access"></a></h2><a name="Developer_access"></a>
+<p>Everyone can access the Subversion repository via HTTP, but Committers must checkout the Subversion repository via HTTPS.</p>
+<div class="source">
+<pre>$ svn checkout https://svn.apache.org/repos/asf/tomcat/taglibs/site site</pre></div>
+<p>To commit changes to the repository, execute the following command to commit your changes (svn will prompt you for your password)</p>
+<div class="source">
+<pre>$ svn commit --username your-username -m "A message"</pre></div></div>
+<div class="section">
+<h2>Access from behind a firewall<a name="Access_from_behind_a_firewall"></a></h2><a name="Access_from_behind_a_firewall"></a>
+<p>For those users who are stuck behind a corporate firewall which is blocking HTTP access to the Subversion repository, you can try to access it via the developer connection:</p>
+<div class="source">
+<pre>$ svn checkout https://svn.apache.org/repos/asf/tomcat/taglibs/site site</pre></div></div>
+<div class="section">
+<h2>Access through a proxy<a name="Access_through_a_proxy"></a></h2><a name="Access_through_a_proxy"></a>
+<p>The Subversion client can go through a proxy, if you configure it to do so. First, edit your "servers" configuration file to indicate which proxy to use. The file's location depends on your operating system. On Linux or Unix it is located in the directory "~/.subversion". On Windows it is in "%APPDATA%\Subversion". (Try "echo %APPDATA%", note this is a hidden directory.)</p>
+<p>There are comments in the file explaining what to do. If you don't have that file, get the latest Subversion client and run any command; this will cause the configuration directory and template files to be created.</p>
+<p>Example: Edit the 'servers' file and add something like:</p>
+<div class="source">
+<pre>[global]
http-proxy-host = your.proxy.name
http-proxy-port = 3128
</pre></div></div>
@@ -123,14 +151,14 @@ http-proxy-port = 3128
</div>
<div id="footer">
<div class="xright">
- Copyright © 2000-2012
+ Copyright © 2000-2014
<a href="http://www.apache.org/">The Apache Software Foundation</a>.
All Rights Reserved.
-
+
</div>
<div class="clear">
<hr/>
</div>
</div>
</body>
-</html>
\ No newline at end of file
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org