mozIStorageStatementWrapper

The mozIStorageStatementWrapper interface is a storage statement wrapper. When you call the mozIStorageConnection interface's createStatement() method, you get a mozIStorageStatement which has just direct bindings to SQLITE. You can then wrap that statement with a wrapper, which implements nsIXPCScriptable and provides scriptable helpers letting you execute the statement as a function, access bind variables by name as properties, etc.

Firefox 3.5 note

Firefox 3.5 adds support for these features directly into the mozIStorageStatement interface, so this interface is essentially deprecated.

Please add a summary to this article.
Last changed in Gecko 1.8 (Firefox 1.5 / Thunderbird 1.5 / SeaMonkey 1.0)

Inherits from: nsISupports

Method overview

void initialize(in mozIStorageStatement aStatement);
void reset();
boolean step();
void execute();

Attributes

Attribute Type Description
statement mozIStorageStatement The statement that is wrapped.
row mozIStorageStatementRow The current row. Throws an exception if no row is currently available. Useful only from script. The value of this is only valid while the statement is still executing, and is still on the appropriate row.
params mozIStorageStatementParams The parameters; these can be set in lieu of using the call notation on this.

Methods

initialize()

This method initializes this wrapper with aStatement.

 void initialize(
   in mozIStorageStatement aStatement
 );
Parameters
aStatement
The statement to be initialized.

reset()

This method resets the wrapped statement.

 void reset();
Parameters

None.

step()

This method steps the wrapped statement.

 boolean step();
Parameters

None.

Return value

Returns true if the stepping the wrapped statement was successful, otherwise returns false.

execute()

This method executes the wrapped statement.

 void execute();
Parameters

None.

See also