Working with SQL databases – A SQLite Example for Adobe AIR

Adobe AIR includes the capability of creating and working with local SQL databases. Many stand SQL features are supported in the runtime, open source SQLite system can be used for storing local, persistent data.

The flollowing is a simplistic example that create a sqlite database, add, get, update and remove records from the “user” table.

Notice:
You might have wondered about this line:

.Asychnronous means that your code will have an event listener on the SQLConnection and an event handler for the response.

.Synchronous means that your application will make an “inline” call to SQLite where it performs the operation and then moves on as if it were any other line of actionscript code.This tutorial is using the asynchronous method.

1. <?xml version=”1.0? encoding=”utf–8??>
2. <mx:WindowedApplication xmlns:mx=”http://www.adobe.com/2006/mxml” layout=”absolute”
3.         preinitialize=”openDatabaseConnection()”
4.         fontSize=”12? backgroundColor=”#FFFFFF” width=”600? height=”700?>
5.         <mx:Script>
6.                 <![CDATA[
7.                         import flash.data.SQLConnection;
8.                         import flash.events.SQLErrorEvent;
9.                         import flash.events.SQLEvent;
10.                         import flash.filesystem.File;
11.                         private var conn:SQLConnection;
12.                         private var initComplete:Boolean = false;
13.                         private var sqlStat:SQLStatement;
14.  
15.                         public function openDatabaseConnection():void{
16.  
17.                         // create new sqlConnection  
18.                         sqlConnection = new SQLConnection();
19.                         sqlConnection.addEventListener(SQLEvent.OPEN, onDatabaseOpen);
20.                         sqlConnection.addEventListener(SQLErrorEvent.ERROR, errorHandler);
21.  
22.                         // get currently dir   
23.                         var dbFile:File = File.applicationStorageDirectory.resolvePath(“sampleDB.db“);
24.  
25.                         // open database,If the file doesn’t exist yet, it will be created
26.                         sqlConnection.openAsync(dbFile);
27.                         }
28.  
29.                         // connect and init database/table
30.                         private function onDatabaseOpen(event:SQLEvent):void
31.                         {
32.                                 // init sqlStatement object
33.                             sqlStat = new SQLStatement();
34.                                 sqlStat.sqlConnection = conn;
35.                                 var sql:String =         “CREATE TABLE IF NOT EXISTS user (“ +
36.                                                                     “    id INTEGER PRIMARY KEY AUTOINCREMENT, “ +
37.                                                                     “    name TEXT, “ +
38.                                                                     “    password TEXT“ +
39.                                                                     “)“;
40.                                 sqlStat.text = sql;
41.                                 sqlStat.addEventListener(SQLEvent.RESULT, statResult);
42.                                 sqlStat.addEventListener(SQLErrorEvent.ERROR, createError);
43.                                 sqlStat.execute();                     
44.                         }
45.                         private function statResult(event:SQLEvent):void
46.                         {
47.                                 // refresh data
48.                             var sqlresult:SQLResult = sqlStat.getResult();                             
49.                                 if(sqlresult.data == null){
50.                                         getResult();
51.                                         return;                                     
52.                                 }
53.                                 datafiled.dataProvider = sqlresult.data;
54.                         }
55.                         // get data
56.                         private function getResult():void{
57.                                 var sqlquery:String = “SELECT * FROM user“
58.                                 excuseUpdate(sqlquery);                             
59.                         }
60.                         private function createError(event:SQLErrorEvent):void
61.                         {
62.                             trace(“Error code:“, event.error.code);
63.                             trace(“Details:“, event.error.message);
64.                         }
65.                         private function errorHandler(event:SQLErrorEvent):void
66.                         {
67.                             trace(“Error code:“, event.error.code);
68.                             trace(“Details:“, event.error.message);
69.                         }
70.                         // update
71.                         private function excuseUpdate(sql:String):void{
72.                                 sqlStat.text = sql;
73.                                 sqlStat.execute();
74.                         }                     
75.                         // insert
76.                         private function insertemp():void{
77.                                 var sqlupdate:String = “Insert into user(id,name,password) values(‘“ +
78.                                                 name.text +
79.                                                 “‘,’“ +
80.                                                 password.text  +
81.                                                 “‘)“;
82.                         debug.text+=sqlupdate+“\n“                                             
83.                                 excuseUpdate(sqlupdate)
84.                         }
85.                         // delete
86.                         private function deleteemp():void{
87.                                 var sqldelete:String = “delete from user where id=’“ +
88.                                                 datafiled.selectedItem.id +
89.                                                 “‘“;
90.                                 excuseUpdate(sqldelete);
91.                                 debug.text+=sqldelete+“\n“                             
92.                         }
93.                 ]]>
94.         </mx:Script>
95.         <mx:TextArea x=”21? y=”10? width=”402? height=”179? id=”debug”/>
96.         <mx:DataGrid x=”21? y=”197? id=”datafiled”>
97.                 <mx:columns>
98.                         <mx:DataGridColumn headerText=”ID” dataField=”id”/>
99.                         <mx:DataGridColumn headerText=”name” dataField=”name”/>
100.                         <mx:DataGridColumn headerText=”password” dataField=”password”/>
101.                 </mx:columns>
102.         </mx:DataGrid>
103.         <mx:Form x=”21? y=”471?>
104.                 <mx:FormItem label=”name”>
105.                         <mx:TextInput id=”name”/>
106.                 </mx:FormItem>
107.                 <mx:FormItem label=”password”>
108.                         <mx:TextInput id=”password”/>
109.                 </mx:FormItem>
110.         </mx:Form>
111.         <mx:Button x=”300? y=”503? label=”add” click=”insertemp()”/>
112.         <mx:Button x=”300? y=”533? label=”delete” click=”deleteemp()”/>
113. </mx:WindowedApplication>