CFCACHE

"-->

 <cfcache action = "action"          username = "username"          password = "password"          protocol = "protocol_name"          directory = "directory_name_for_map_file"          cacheDirectory = "directory_name_for_cached_pages"          expireURL = "wildcarded_URL_reference"          port = "port_number"> 

Description

Used to help improve performance, this tag stores a copy of a page on the server and/or client. Creates temporary files that contain the Hypertext Markup Language (HTML) returned from a ColdFusion page. This tag should only be used if the content of the page does not change very often; otherwise the user receives old data.

Attributes

action (Optional)

Default: cache

• cache. Server-side caching.

• flush. Refresh cached page. You can also specify directory and expireURL attributes.

• clientCache. Browser caching.

• optimal. Optimal caching; combination of server-side and browser caching.

username (Optional)

A username if it is required for authentication.

password (Optional)

A password, if it is required for authentication.

protocol (Optional)

Default: http://. Protocol used to create pages from cache.

directory (Optional)

Directory of the current page; this is an absolute directory path and contains cfcache.map to use if action = "flush".

cacheDirectory (Optional)

Directory of the current page; this is an absolute path of the directory in which to cache pages.

expireURL (Optional)

Use this to flush all mappings. Used when action = "flush" and takes a URL reference, including wildcards, that ColdFusion matches against all mappings in cfcache.map file.

port (Optional)

Default: 80

Port number of the web server from which the page is requested. If the port is specified correctly in an internal call to CFHTTP, the URL of each retrieved document is resolved to preserve links.