This interface is no longer supported and planned to be removed soon: use nsICacheStorageService instead. At the time of writing there is no documentation for nsICacheStorageService but comments are available in the source.
Note: Starting in Gecko 2.0, cache I/O is handled asynchronously.
||The event target for cache I/O operation notifications. Read only.|
This method creates a cache session.
A cache session represents a client's access into the cache. The cache session is not "owned" by the cache service. Hence, it is possible to create duplicate cache sessions. Entries created by a cache session are invisible to other cache sessions, unless the cache sessions are equivalent.
nsICacheSession createSession( in string clientID, in nsCacheStoragePolicy storagePolicy, in boolean streamBased );
- Specifies the name of the client using the cache.
- Limits the storage policy for all entries accessed via the returned session. As a result, devices excluded by the storage policy will not be searched when opening entries from the returned session.
- Indicates whether or not the data being cached can be represented as a stream. The
storagePolicymust be consistent with the value of this field. For example, a non-stream-based cache entry can only have a storage policy of
Returns a new cache session.
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Obsolete since Gecko 1.9.2 (Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.
This method creates and returns a unique, temporary cache client ID.
This is used by the offline cache. The offline cache lets clients accumulate entries in a temporary client and merge them in as a group using
ACString createTemporaryClientID( in nsCacheStoragePolicy storagePolicy );
- The cache storage policy.
Returns a newly created unique, temporary cache client ID.
- This method is deprecated.
This method evicts all entries in all devices implied by the storage policy.
void evictEntries( in nsCacheStoragePolicy storagePolicy );
- The cache storage policy.
init()Obsolete since Gecko 1.8 (Firefox 1.5 / Thunderbird 1.5 / SeaMonkey 1.0)
Initialize the cache service.
- Missing Description
shutdown()Obsolete since Gecko 1.8 (Firefox 1.5 / Thunderbird 1.5 / SeaMonkey 1.0)
Shutdown() the cache service.
This method visits entries stored in the cache. Used to implement the
void visitEntries( in nsICacheVisitor visitor );
- The entry to be visited.