Yahoo! UI Library

cache  3.3.0pr1

Yahoo! UI Library > cache > Cache
Search:
 
Filters

Class Cache - extends Base

Known Subclasses:
DataSourceCache CacheOffline Plugin.Cache
Base class for the YUI Cache utility.

Constructor

Cache ( )

Properties

_entries - private Object[]

Array of request/response objects indexed chronologically.

NAME - static final String

Class name.

Properties inherited from Plugin.Host:

Properties inherited from Attribute:

Properties inherited from Base:

Methods

_defAddFn

protected void _defAddFn ( e )
Adds entry to cache.
Parameters:
e <Event.Facade> Event Facade with the following properties:
entry (Object)
The cached entry.

_defFlushFn

protected void _defFlushFn ( e )
Flushes cache.
Parameters:
e <Event.Facade> Event Facade object.

_getEntries

protected void _getEntries ( )
Gets all entries.

_getSize

protected void _getSize ( )
Gets size.

_isMatch

protected Boolean _isMatch ( request , entry )
Default overridable method compares current request with given cache entry. Returns true if current request matches the cached request, otherwise false. Implementers should override this method to customize the cache-matching algorithm.
Parameters:
request <Object> Request object.
entry <Object> Cached entry.
Returns: Boolean
True if current request matches given cached request, false otherwise.

_setMax

protected void _setMax ( )
Sets max.

add

void add ( request , response )
Adds a new entry to the cache of the format {request:request, response:response, cached:cached, expires:expires}. If cache is full, evicts the stalest entry before adding the new one.
Parameters:
request <Object> Request value.
response <Object> Response value.

destructor

private void destructor ( )
Internal destroy() handler.

flush

void flush ( )
Flushes cache.

initializer

private void initializer ( config )
Internal init() handler.
Parameters:
config <Object> Config object.

retrieve

Object retrieve ( request )
Retrieves cached object for given request, if available, and refreshes entry in the cache. Returns null if there is no cache match.
Parameters:
request <Object> Request object.
Returns: Object
Cached object with the properties request and response, or null.

Events

add

add ( e )
Fired when an entry is added.
Parameters:
e <Event.Facade> Event Facade with the following properties:
entry (Object)
The cached entry.
Preventable: This event is preventable by method e.preventDefault(). The default function executed by this event is _defAddFn.

entriesChange

entriesChange ( event )
Fires when the value for the configuration attribute 'entries' is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.
Parameters:
event <Event.Facade> An Event Facade object with the following attribute specific properties added:
prevVal
The value of the attribute, prior to it being set
newVal
The value the attribute is to be set to
attrName
The name of the attribute being set
subAttrName
If setting a property within the attribute's value, the name of the sub-attribute property being set

expiresChange

expiresChange ( event )
Fires when the value for the configuration attribute 'expires' is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.
Parameters:
event <Event.Facade> An Event Facade object with the following attribute specific properties added:
prevVal
The value of the attribute, prior to it being set
newVal
The value the attribute is to be set to
attrName
The name of the attribute being set
subAttrName
If setting a property within the attribute's value, the name of the sub-attribute property being set

flush

flush ( e )
Fired when the cache is flushed.
Parameters:
e <Event.Facade> Event Facade object.
Preventable: This event is preventable by method e.preventDefault(). The default function executed by this event is _defFlushFn.

maxChange

maxChange ( event )
Fires when the value for the configuration attribute 'max' is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.
Parameters:
event <Event.Facade> An Event Facade object with the following attribute specific properties added:
prevVal
The value of the attribute, prior to it being set
newVal
The value the attribute is to be set to
attrName
The name of the attribute being set
subAttrName
If setting a property within the attribute's value, the name of the sub-attribute property being set

request

request ( e )
Fired when an entry is requested from the cache.
Parameters:
e <Event.Facade> Event Facade with the following properties:
request (Object)
The request object.

retrieve

retrieve ( e )
Fired when an entry is retrieved from the cache.
Parameters:
e <Event.Facade> Event Facade with the following properties:
entry (Object)
The retrieved entry.

sizeChange

sizeChange ( event )
Fires when the value for the configuration attribute 'size' is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.
Parameters:
event <Event.Facade> An Event Facade object with the following attribute specific properties added:
prevVal
The value of the attribute, prior to it being set
newVal
The value the attribute is to be set to
attrName
The name of the attribute being set
subAttrName
If setting a property within the attribute's value, the name of the sub-attribute property being set

uniqueKeysChange

uniqueKeysChange ( event )
Fires when the value for the configuration attribute 'uniqueKeys' is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.
Parameters:
event <Event.Facade> An Event Facade object with the following attribute specific properties added:
prevVal
The value of the attribute, prior to it being set
newVal
The value the attribute is to be set to
attrName
The name of the attribute being set
subAttrName
If setting a property within the attribute's value, the name of the sub-attribute property being set

Events inherited from Base:

Configuration Attributes

entries - Array

Cached entries.

expires - Date | Number

Absolute Date when data expires or relative number of milliseconds. Zero disables expiration.
Default Value: 0

max - Number

Maximum number of entries the Cache can hold. Set to 0 to turn off caching.
Default Value: 0

size - Number

Number of entries currently cached.

uniqueKeys - Boolean

Validate uniqueness of stored keys. Default is false and is more performant.

Configuration attributes inherited from Base:


Copyright © 2010 Yahoo! Inc. All rights reserved.