Register | Log in

Mozilla.com

  1. MDC
  2. Main Page
  3. nsICacheEntryDescriptor
Table of contents
  1. 1. Method overview
  2. 2. Attributes
  3. 3. Methods
    1. 3.1. setExpirationTime()
          1. 3.1.1.1.1. Parameters
    2. 3.2. setDataSize()
          1. 3.2.1.1.1. Parameters
    3. 3.3. openInputStream()
          1. 3.3.1.1.1. Parameters
          2. 3.3.1.1.2. Return value
    4. 3.4. openOutputStream()
          1. 3.4.1.1.1. Parameters
          2. 3.4.1.1.2. Return value
    5. 3.5. doom()
          1. 3.5.1.1.1. Parameters
    6. 3.6. doomAndFailPendingRequests()
          1. 3.6.1.1.1. Parameters
    7. 3.7. markValid()
          1. 3.7.1.1.1. Parameters
    8. 3.8. close()
          1. 3.8.1.1.1. Parameters
    9. 3.9. getMetaDataElement()
          1. 3.9.1.1.1. Parameters
          2. 3.9.1.1.2. Return Value
    10. 3.10. setMetaDataElement()
          1. 3.10.1.1.1. Parameters
    11. 3.11. visitMetaData()
          1. 3.11.1.1.1. Parameters
    12. 3.12. See also

nsICacheEntryDescriptor

The nsICacheEntryDescriptor interface provides a cache entry descriptor.


nsICacheEntryDescriptor is defined in netwerk/cache/public/nsICacheEntryDescriptor.idl . It is scriptable and unfrozen (hasn't changed since Mozilla 1.9) .

Inherits from: nsICacheEntryInfo

Method overview

void setExpirationTime(in PRUint32 expirationTime);
void setDataSize(in unsigned long size);
nsIInputStream openInputStream(in unsigned long offset);
nsIOutputStream openOutputStream(in unsigned long offset);
void doom();
void doomAndFailPendingRequests(in nsresult status);
void markValid();
void close();
string getMetaDataElement(in string key);
void setMetaDataElement(in string key, in string value);
void visitMetaData(in nsICacheMetaDataVisitor visitor);

Attributes

Attribute Type Description
beginTime PRTime Begin time range for results (INCLUSIVE).
cacheElement nsISupports Get or set the cache data element. This will fail if the cache entry is stream based. The cache entry holds a strong reference to this object. The object will be released when the cache entry is destroyed.
accessGranted nsCacheAccessMode Get the access granted to this descriptor. See nsICache for the definitions of the access modes and a thorough description of their corresponding meanings.
storagePolicy nsCacheStoragePolicy Get or set the storage policy of the cache entry. See nsICache for the definitions of the storage policies.
file nsIFile Get the disk file associated with the cache entry.
securityInfo nsISupports Get or set security info on the cache entry for this descriptor. This fails if the storage policy is not STORE_IN_MEMORY.

Methods

setExpirationTime()

This method sets the time at which the cache entry should be considered invalid (in seconds since the Epoch). 

 void setExpirationTime(
   in PRUint32 expirationTime
 );
Parameters
expirationTime
The time for cache entry expiration (in seconds).

setDataSize()

This method sets the cache entry data size. This will fail if the cache entry is stream based. 

 void setDataSize(
   in unsigned long size
 );
Parameters
size
The cache entry data size.

openInputStream()

This method opens blocking input stream to cache data. This will fail if the cache entry is not stream based. Use the stream transport service to asynchronously read this stream on a background thread. The returned stream may implement nsISeekableStream . 

 nsIInputStream openInputStream(
   in unsigned long offset
 );
Parameters
offset
Read starting from this offset into the cached data. An offset beyond the end of the stream has undefined consequences.
Return value

Returns blocking, unbuffered input stream.

openOutputStream()

This method opens blocking output stream to cache data. This will fail if the cache entry is not stream based. Use the stream transport service to asynchronously write to this stream on a background thread. The returned stream may implement nsISeekableStream .

If opening an output stream to existing cached data, the data will be truncated to the specified offset. 

 nsIOutputStream openOutputStream(
   in unsigned long offset
 );
Parameters
offset
Write starting from this offset into the cached data. An offset beyond the end of the stream has undefined consequences.
Return value

Returns blocking, unbuffered output stream.

doom()

This method dooms the cache entry this descriptor references in order to slate it for removal. Once doomed a cache entry cannot be undoomed. 

 void doom();
Parameters

None.

doomAndFailPendingRequests()

This method with the WRITE access can doom the cache entry and choose to fail pending requests. This means that pending requests will not get a cache descriptor. This is meant as a tool for clients that wish to instruct pending requests to skip the cache. 

 void doomAndFailPendingRequests(
   in nsresult status
 );
Parameters
status
The access status.

markValid()

This method means that a writer must validate this cache object before any readers are given a descriptor to the object. 

 void markValid();
Parameters

None.

close()

This method explicitly closes the descriptor (optional). 

 void close();
Parameters

None.

getMetaDataElement()

This method retrieves the meta data. Meta data is a table of key/value string pairs. The strings do not have to conform to any particular charset, but they must be NULL terminated. 

 string getMetaDataElement(
   in string key
 );
Parameters
key
The key for retrieving the meta data.
Return Value

Returns the string value containing the meta data for the provided key.

setMetaDataElement()

This method sets the meta data. Meta data is a table of key/value string pairs. The strings do not have to conform to any particular charset, but they must be NULL terminated. 

 void setMetaDataElement(
   in string key, 
   in string value
 );
Parameters
key
The key for setting the meta data.
value
The value for setting the meta data.

visitMetaData()

This method means that the visitor will be called with key/value pair for each meta data element. 

 void visitMetaData(
   in nsICacheMetaDataVisitor visitor
 );
Parameters
visitor
The visitor to be called.

Page last modified 20:48, 4 Apr 2008 by Jimbeau?

Tags:

Files (0)