MACROMEDIA COLDFUSION MX 61-CFML Reference page 60

Attributes
Attribute
action
directory
timespan
expireURL
username
password
port
protocol
Usage
Use this tag in pages whose content is not updated frequently. Taking this action can greatly
improve the performance of your application.
The output of a cached page is stored in a file on the client browser and/or the ColdFusion server.
Instead of regenerating and redownloading the output of the page, each time it is requested,
ColdFusion uses the cached output. ColdFusion regenerates and downloads the page only when
the cache is flushed, as specified by the
.
action=flush
To enable a simple form of caching, put a
top of a page. Each time the specified time span passes, ColdFusion flushes (deletes) the copy of
the page from the cache and caches a new copy for users to access.
60 Chapter 2: ColdFusion Tags
Req/Opt Default
Optional cache
Optional cf_root/cache Absolute path of cache directory.
Optional Page is
flushed only
when
cfcache
action =
is
"flush"
executed
Optional Flush all
cached pages
Optional
Optional
Optional The current
page port
Optional The current
page protocol
Description
• cache: server-side and client-side caching.
• flush: refresh cached page(s).
• clientcache: browser-side caching only. To cache a
personalized page, use this option.
• servercache: server-side caching only. Not
recommended.
• optimal: same as "cache".
The interval until the page is flushed from the cache.
• A decimal number of days. For example:
- ".25", for one-fourth day (6 hours)
- "1", for one day
- "1.5", for one and one half days
• A return value from the
For example:
"#CreateTimeSpan(0, 6, 0, 0)#"
Used with action =
ColdFusion matches it against the mappings in the
specified cache directory. Can include wildcards. For
example:
"*/view.cfm?id=*"
A username. Provide this if the page requires
authentication at the web server level.
A password. Provide this if the page requires
authentication at the web server level.
Port number of the web server from which the URL is
requested. In the internal call from
ColdFusion resolves each URL variable in the page;
this ensures that links in the page remain functional.
Protocol that is used to create URL from cache.
• http://
• https://
attribute, or by invoking
timespan
tag, specifying the
cfcache
CreateTimeSpan function.
. A URL reference.
"flush"
.
to
cfcache
cfcache
attribute, at the
timespan
,
cfhttp