ACTIONSCRIPT 3.0

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with local SQL databases in AIR
The following example demonstrates accessing the primary key of an inserted row in asynchronous execution mode:
insertStmt.text = "INSERT INTO ...";
insertStmt.addEventListener(SQLEvent.RESULT, resultHandler);
insertStmt.execute();
function resultHandler(event:SQLEvent):void
{
// get the primary key
var result:SQLResult = insertStmt.getResult();
}
var primaryKey:Number = result.lastInsertRowID;
// do something with the primary key
The following example demonstrates accessing the primary key of an inserted row in synchronous execution mode:
insertStmt.text = "INSERT INTO ...";
try
{
insertStmt.execute();
// get the primary key
var result:SQLResult = insertStmt.getResult();
var primaryKey:Number = result.lastInsertRowID;
// do something with the primary key
}
catch (error:SQLError)
{
// respond to the error
}
Note that the row identifier may or may not be the value of the column that is designated as the primary key column
in the table definition, according to the following rules:
If the table is defined with a primary key column whose affinity (column data type) is INTEGER, the
lastInsertRowID property contains the value that was inserted into that row (or the value generated by the
runtime if it’s an AUTOINCREMENT column).
If the table is defined with multiple primary key columns (a composite key) or with a single primary key column
whose affinity is not INTEGER, behind the scenes the database generates an integer row identifier value for the row.
That generated value is the value of the lastInsertRowID property.
The value is always the row identifier of the most-recently inserted row. If an INSERT statement causes a trigger to
fire which in turn inserts a row, the lastInsertRowID property contains the row identifier of the last row inserted
by the trigger rather than the row created by the INSERT statement.
As a consequence of these rules, if you want to have an explicitly defined primary key column whose value is available
after an INSERT command through the SQLResult.lastInsertRowID property, the column must be defined as an
INTEGER PRIMARY KEY column. Even if your table does not include an explicit INTEGER PRIMARY KEY column, it is
equally acceptable to use the database-generated row identifier as a primary key for your table in the sense of defining
relationships with related tables. The row identifier column value is available in any SQL statement by using one of the
special column names ROWID, _ROWID_, or OID. You can create a foreign key column in a related table and use the row
Last updated 4/22/2013
748