Adobe COLDFUSION 9 Manual page 1134

DEVELOPING COLDFUSION 9 APPLICATIONS
Using Web Elements and External Objects
However, two standard JSP tags provide functionality that is useful in ColdFusion pages: the
tags invoke JSP pages and Java servlets. The PageContext object described in About GetPageContext and the
PageContext object section has
information about using these methods, see
Using custom JSP tags in a ColdFusion page
Follow these steps to use a custom JSP tag on a ColdFusion page:
Use a custom tag
Place the tag library, consisting of the taglibname.jar file, and the taglibname.tld file, if one is supplied, in the
1
web_root/WEB-INF/lib directory. The JSP custom tag library must be in this directory for you to use the
tag.
2 Restart ColdFusion.
In the ColdFusion page that uses a JSP tag from the tag library, specify the tag library name in a
3
example:
<cfimport taglib="/WEB-INF/lib/random.jar" prefix="random">
If the TLD file is not included in the JAR file, use the .tld extension in place of the .jar extension.
Note: The tag must be on the page that uses the imported tag. You cannot place the
cfimport
Application.cfm.
Use the custom tag using the form prefix:tagName; for example:
4
<random:number id="myNum" range="000000-999999" />
Note: You cannot use the
cfsavecontent
Example: using the random tag library
The following example uses the random tag library from the Apache Jakarta Taglibs project and calls the
The tag initializes a random number generator that uses a secure algorithm to generate a six-digit random
number
number. You get a new random number each time you reference the variable randPass.random.
<cfimport taglib="/WEB-INF/lib/taglibs-random.jar" prefix="myrand">
<myrand:number id="randPass" range="000000-999999" algorithm="SHA1PRNG" provider="SUN" />
<cfset myPassword = randPass.random>
<cfoutput>
Your password is #myPassword#<br>
</cfoutput>
For more information on the Jakarta random tag library and how to use its tags, see the documentation at the Apache
Jakarta Taglibs project website, http://jakarta.apache.org/taglibs/index.html. The Taglibs project includes many open
source custom tag libraries.
Interoperating with JSP pages and servlets
ColdFusion pages and JSP pages can interoperate in several ways:
• ColdFusion pages can invoke JSP pages and servlets.
• JSP pages can invoke ColdFusion pages.
• ColdFusion pages, JSP pages, and servlets can share data in three scopes.
and methods that provide the same operations. For more
forward include
"Accessing a JSP page or servlet from a ColdFusion
tag to suppress output of a custom JSP tag.
Last updated 8/5/2010
1129
and
forward include
page" on page 1130.
cfimport
tag; for
cfimport
tag in
cfimport
tag.
number