Each application cache has a unique client ID for use with
nsICacheService.openSession() method, to access the cache's entries.
Each entry in the cache can be marked with a set of types, specified in the Constants section.
All application caches with the same group ID belong to a cache group. Each group has one "active" cache that will service future loads. Inactive caches are removed from the cache when no longer referenced.
| || || |
| || ||The client ID for this application cache. Clients can open a session with |
| || ||The group ID for this cache group. This is the URI of the cache manifest file. Read only.|
| || ||The disk |
| || ||This item is the application manifest.|
| || ||This item was explicitly listed in the application manifest.|
| || ||This item was navigated to in a top level browsing context, and named this cache's group as its manifest.|
| || ||This item was added to the cache using the dynamic scripting API.|
| || ||This item was listed in the application manifest, but named a different cache group as its manifest.|
| || ||This item was listed as a fallback entry.|
| || ||This item matched an opportunistic cache namespace and was cached for that reason.|
Makes this cache the active application cache for this group. Future loads associated with this group will come from this cache. Other caches from this cache group will be deactivated.
Add a set of namespace entries to the application cache.
void addNamespaces( in nsIArray namespaces );
nsIApplicationCacheNamespaceobjects describing the namespaces to add to the cache.
Discards this application cache. This removes all resources it has cached. If this is the active application cache for the group, the group is removed.
Returns a list of entries in the cache whose type matches one or more of the specified types.
void gatherEntries( in PRUint32 typeBits, out unsigned long count, [array, size_is(count)] out string keys );
- A bit field indicating the types against which to match. See Constants for a list of types.
- On return, indicates how many matching entries were found.
- An array of the keys matching one or more of the types indicated by
Returns the most specific namespace matching a given key.
nsIApplicationCacheNamespace getMatchingNamespace( in ACString key );
- The key for the cache entry whose most specific namespace is to be returned.
nsIApplicationCacheNamespace object describing the most specific namespace matching the given
Gets the types for a given entry in the cache.
unsigned long getTypes( in ACString key );
- The key for the cache entry whose types you wish to retrieve.
A bit field indicating the entry's types. See Constants for a list of types.
Init this application cache instance to just hold the group ID and the client ID to work just as a handle to the real cache. Used on content process to simplify the application cache code.
void initAsHandle( in ACString groupId, in ACString clientId );
- Missing Description
- Missing Description
Adds item types to a given entry.
void markEntry( in ACString key, in unsigned long typeBits );
- The key for the cache entry to which to add types.
- A bit field indicating the types to add to the entry. See Constants for a list of types.
Removes types from a given entry. If the resulting entry has no types left, the entry is removed.
void unmarkEntry( in ACString key, in unsigned long typeBits );
- The key for the cache entry from which to remove types.
- A bit field indicating the types to remove from the entry. See Constants for a list of types.