Home >	Contents >	Index >

Template Tags TOC   |    Alpha TOC   |    Tag Family TOC   |    Purpose TOC   |    Annotated TOC   |    Index

ics:disablecache

Disables caching.

Syntax

<ics:disablecache/>

Description

Forces the current evaluation to not be cached either by the EvalServer or the ContentServer servlets.

Parameters

recursion (optional)

Value must be set to true or false. The recursion attribute is used to enable/disable caching of the child pages of the page in which disable cache is set.

errno

The value of errno is unchanged.

Example

The following example disables caching.

<ics:disablecache/>

The recursion attribute is used to enable/disable caching of the child pages of the page in which disable cache is set.

For the purpose of next examples, let us assume that we have a hierarchy of pages that are called recursively. For e.g. Parent page -> Page a -> Page b -> Page c. When we set the recursion attribute to true in (say) page b, all three pages a, b and c are NOT cached. In general, when we specify recursion = true in the disable cache tag, all child pages of that page are NOT cached, unless otherwise those pages have been previously called from the same page before setting the disable cache tag.

Note: In all of the following examples, we assume the page hierarchy a->b->c->d

Examples to illustrate different scenarios

<cs:ftcs>
<ics:disablecache recursion=’true’/>
ics.readpage name=”c”
</cs:ftcs>

In the above example, since recursion is set to true, none of the pages are cached.

<cs:ftcs>
ics.readpage name=”c”
<ics:disablecache
recursion=’true’ />
</cs:ftcs>

In the above example, since page c was called before disable cache was set, Page c and along with it Page d WILL be cached, but the pages a, b will NOT be cached.

<cs:ftcs>
ics.readpage(c)
<disablecache recursion=’true’ />
ics.readpage(e)
</cs:ftcs>

In the above example, pages c and d will be cached, whereas a, b and e will not be cached.

On the other hand when we WANT to cache child pages, we set recursive to be ‘false’. When we do so, we cache all the child pages that are called after this tag is set. For e.g.

<cs:ftcs>
<ics:disablecache 
recursion=’false’/>
ics.readpage name=”c”
</cs:ftcs>

Here we DO NOT cache the pages a, b, but we cache pages c and d. The basic idea is: use disable cache with recursion = true to STOP caching all child pages

On a different note, when used with satellite server, disable cache works differently as explained below.

<cs:ftcs>
satellite.page(c)
disablecache recurse=true
satellite.page(e)
</cs:ftcs>

With this example, assuming we are calling through Satellite Server, then the call to (e) is a new request, so it will get cached

		Home >	Contents >	Index >
	FatWire JSP Tag Reference Copyright 2005 by FatWire Software All rights reserved.