User Guide

cfimport 191

JSP tags have fixed attributes; however, if the tag supports runtime attribute expressions, most tag

libraries support the use of the syntax

#expressions#.

To reference a JSP tag in a CFML page, use the syntax

<prefix:tagname>. Set the prefix value in

the

prefix attribute.

To use JSP custom tags in a ColdFusion page, follow these steps:

1 Put a JSP tag library JAR file (for example, myjsptags.jar) into the ColdFusion server directory

wwwroot/WEB-INF/lib. If the tag library has a separate TLD file, put it in the same directory

as the JAR file.

2 At the top of a CFML page, insert code such as the following:

<cfimport

prefix="mytags"

taglib="/WEB-INF/lib/myjsptags.jar">

To reference a JSP tag from a JAR file, use the following syntax:

<mytags:helloTag message="#mymessage#" />

The cfimport tag must be on the page that uses the imported tags. For example, if you use a

cfimport tag on a page that you include with the cfinclude call, you cannot use the imported

tags on the page that has the

cfinclude tag. Similarly, if you have a cfimport tag on your

Application.cfm page, the imported tags are available on the Application.cfm page only, not on

the other pages in the application. ColdFusion does not throw an error in these situations, but the

imported tags do not run.

You cannot use the

cfimport tag to suppress output from a tag library.

For more information, see the Java Server Page 1.1 specification.

Example

<h3>cfimport example</h3>

<p>This example uses the random JSP tag library that is available from the

Jakarta Taglibs project, at http://jakarta.apache.org/taglibs/

<randomnum:number id="randPass" range="000000-999999" algorithm="SHA1PRNG"

provider="SUN" />

Your password is #myPassword#<br>

</cfoutput>