Back to index

lightning-sunbird  0.9+nobinonly
Public Member Functions | Public Attributes
nsIFastLoadReadControl Interface Reference

import "nsIFastLoadFileControl.idl";

Inheritance diagram for nsIFastLoadReadControl:
Inheritance graph
[legend]
Collaboration diagram for nsIFastLoadReadControl:
Collaboration graph
[legend]

List of all members.

Public Member Functions

PRUint32 computeChecksum ()
 Computes the correct checksum of the FastLoad file, independent of the header's checksum value.
void startMuxedDocument (in nsISupports aURI, in string aURISpec)
 Multiplexed document control methods.
nsISupports selectMuxedDocument (in nsISupports aURI)
void endMuxedDocument (in nsISupports aURI)
boolean hasMuxedDocument (in string aURISpec)
 Return true if aURISpec identifies a muxed document in the FastLoad file, false otherwise.

Public Attributes

readonly attribute
nsISimpleEnumerator 
dependencies
 Get the collection of dependency nsIFile instances recorded during the FastLoad file write or read/update process, and checked during the read process to invalidate the FastLoad file if any dependencies are newer.
attribute PRUint32 checksum
 Get and set the recorded checksum value from the FastLoad file header.

Detailed Description

Definition at line 97 of file nsIFastLoadFileControl.idl.


Member Function Documentation

Computes the correct checksum of the FastLoad file, independent of the header's checksum value.

The header checksum field is treated as zero when computing the checksum.

void nsIFastLoadFileControl::endMuxedDocument ( in nsISupports  aURI) [inherited]

Return true if aURISpec identifies a muxed document in the FastLoad file, false otherwise.

nsISupports nsIFastLoadFileControl::selectMuxedDocument ( in nsISupports  aURI) [inherited]
void nsIFastLoadFileControl::startMuxedDocument ( in nsISupports  aURI,
in string  aURISpec 
) [inherited]

Multiplexed document control methods.

A FastLoad file may contain multiple interleaved documents identified by a URI specifier string, and indexed for fast multiplexor select by an opaque URI object key. You StartMuxedDocument when initiating a document load, then Select before every batch of calls to (de)serialize document data, and End when the load completes.

Document multiplexing is necessary to support incremental FastLoad development in a non-blocking i/o architecture such as Mozilla, where some (but not all, at first, or for a while during development) of the results of parsing and compiling various inputs can be multiplexed to or from a FastLoad file.

Note: Select returns the previously selected URI object in case the caller is synchronously selecting and writing data to the FastLoad file, so the caller can reselect the previous URI and return to code the continues to write FastLoad data for the previous URI, unaware of the nested select/write/reselect.


Member Data Documentation

Get and set the recorded checksum value from the FastLoad file header.

Definition at line 63 of file nsIFastLoadFileControl.idl.

Get the collection of dependency nsIFile instances recorded during the FastLoad file write or read/update process, and checked during the read process to invalidate the FastLoad file if any dependencies are newer.

Definition at line 111 of file nsIFastLoadFileControl.idl.


The documentation for this interface was generated from the following file: