Binary downloads of the JAKARTA-TAGLIBS distribution, as with all other Jakarta projects, are available from the Jakarta web site, at http://jakarta.apache.org/downloads/binindex.html. Download and unpack the distribution archive into a convenient subdirectory.
The distribution archive will contain the following file and directory structure:
{library}
represents that project's short name:
/WEB-INF
subdirectory within your web application, and
referenced with a <taglib>
element in the web
application deployment descriptor (/WEB-INF/web.xml
) file.
/WEB-INF/lib
subdirectory
within your web application, which makes these classes automatically
visible within your application.
To use one or more of the custom tag libraries included in JAKARTA-TAGLIBS in your own web applications, follow these steps:
{library}.tld
file to the /WEB-INF
subdirectory of your web application.
{library}.jar
file to the /WEB-INF/lib
subdirectory of your web application.
/WEB-INF/lib
subdirectory of your web application.
<taglib>
element to your web application deployment
descriptor (/WEB-INF/web.xml)
) file. An example entry might
look like this:
<taglib> <taglib-uri>http://jakarta.apache.org/taglibs/{library}</taglib-uri> <taglib-location>/WEB-INF/{library}.tld</taglib-location> </taglib>
<%@ taglib%gt;
directive identifying the URI of the library
you want to use (which must match the value you specified in the
<taglib-uri>
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:
<%@ taglib uri="http://jakarta.apache.org/taglibs/{library}" prefix="x" %>
taglib
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 magic
, and you selected the "x"
prefix as described above, you would might include this custom tag:
<x:magic/>or, if this tag required attributes and perhaps some body text:
<x:magic id="beanName" name="xyz"> ... Some body text and/or nested tags ... </x:magic>