cache-offline.js revision 51d88936741cad83ee95f07eb029cbf8cff8a020
/**
* Extends Cache utility with offline functionality.
* @class CacheOffline
* @extends Cache
* @constructor
*/
function CacheOffline() {
}
/////////////////////////////////////////////////////////////////////////////
//
// CacheOffline static properties
//
/////////////////////////////////////////////////////////////////////////////
Y.mix(CacheOffline, {
/**
* Class name.
*
* @property NAME
* @type String
* @static
* @final
* @value "cacheOffline"
*/
NAME: "cacheOffline",
ATTRS: {
/////////////////////////////////////////////////////////////////////////////
//
// CacheOffline Attributes
//
/////////////////////////////////////////////////////////////////////////////
/**
* @attribute expires
* @description Absolute Date when data expires or
* relative number of milliseconds. Zero disables expiration.
* @type Date | Number
* @default 0
*/
expires: {
validator: function(v) {
}
},
/**
* @attribute max
* @description Disabled.
* @readonly
* @default null
*/
max: {
value: null,
readonly: true,
setter: function() {
return null;
}
},
/**
* @attribute uniqueKeys
* @description Always true for CacheOffline.
* @readonly
* @default true
*/
uniqueKeys: {
value: true,
readonly: true,
setter: function() {
return true;
}
}
}
});
/////////////////////////////////////////////////////////////////////////////
//
// CacheOffline protected methods
//
/////////////////////////////////////////////////////////////////////////////
/**
* Sets max.
*
* @method _setMax
* @protected
*/
//_setMax: function(value) {
//return null;
//},
/**
* Gets size.
*
* @method _getSize
* @protected
*/
_getSize: function() {
return localStorage.length;
},
/**
* Gets all entries.
*
* @method _getEntries
* @protected
*/
_getEntries: function() {
i=0,
l=this._getSize();
if(entries) { // Could be null if instance was destroyed
for(; i<l; ++i) {
}
}
return entries;
},
/**
* Adds entry to cache.
*
* @method _defAddFn
* @param e {Event.Facade} Event Facade with the following properties:
* <dl>
* <dt>entry (Object)</dt> <dd>The cached entry.</dd>
* </dl>
* @protected
*/
_defAddFn: function(e) {
},
/**
* Flushes cache.
*
* @method _defFlushFn
* @param e {Event.Facade} Event Facade object.
* @protected
*/
_defFlushFn: function(e) {
if(store) {
}
// FF2.x and FF3.0.x
else {
}
}
}
}
},
/**
* Adds a new entry to the cache of the format
* {request:request, response:response, expires: expires}.
*
* @method add
* @param request {Object} Request value must be a String or JSON.
* @param response {Object} Response value must be a String or JSON.
*/
/**
* Retrieves cached object for given request, if available.
* Returns null if there is no cache match.
*
* @method retrieve
* @param request {Object} Request object.
* @return {Object} Cached object with the properties request, response,
* and expires, or null.
*/
try {
try {
}
catch(e) {
}
}
catch(e2) {
}
if(entry) {
return entry;
}
}
return null;
}
} : {
/**
* Adds entry to cache with an expires property.
*
* @method _defAddFn
* @param e {Event.Facade} Event Facade with the following properties:
* <dl>
* <dt>entry (Object)</dt> <dd>The cached entry.</dd>
* </dl>
* @protected
*/
_defAddFn: function(e) {
},
/**
* Overrides the default method to check for expired entry.
* Returns true if current request matches the cached request, otherwise
* false. Implementers should override this method to customize the
* cache-matching algorithm.
*
* @method _isMatch
* @param request {Object} Request object.
* @param entry {Object} Cached entry.
* @return {Boolean} True if current request matches given cached request
* and entry has not expired, false otherwise.
* @protected
*/
}
return false;
}
};
Y.CacheOffline = CacheOffline;