创建和修改数据库

要创建数据库文件，需要首先创建 SQLConnection 实例。调用其 open() 方法在同步执行模式下打开它，或者调用其 openAsync() 方法在异步执行模式下打开它。 open() 和 openAsync() 方法用于打开到数据库的连接。如果传递的 File 实例引用 reference 参数（第一个参数）的不存在的文件位置，则 open() 或 openAsync() 方法将在该文件位置创建一个数据库文件，并打开到新创建的数据库的连接。

无论创建数据库时调用的是 open() 方法还是 openAsync() 方法，数据库文件的名称都可以是采用任何文件扩展名的任何有效文件名。如果调用 reference 参数为 null 的 open() 或 openAsync() 方法，则将创建新的内存中数据库，而不是在磁盘上创建数据库文件。

以下代码清单说明使用异步执行模式创建数据库文件（新数据库）的过程。在本例中，数据库文件保存在 指向应用程序存储目录 中，文件名为“DBSample.db”：

// Include AIRAliases.js to use air.* shortcuts 
     
var conn = new air.SQLConnection(); 
     
conn.addEventListener(air.SQLEvent.OPEN, openHandler); 
conn.addEventListener(air.SQLErrorEvent.ERROR, errorHandler); 
     
// The database file is in the application storage directory 
var folder = air.File.applicationStorageDirectory; 
var dbFile = folder.resolvePath("DBSample.db"); 
     
conn.openAsync(dbFile); 
     
function openHandler(event) 
{ 
    air.trace("the database was created successfully"); 
} 
     
function errorHandler(event) 
{ 
    air.trace("Error message:", event.error.message); 
    air.trace("Details:", event.error.details); 
}

要同步执行操作，请在使用 SQLConnection 实例打开数据库连接时，调用 open() 方法。以下示例说明如何创建和打开同步执行其操作的 SQLConnection 实例：

// Include AIRAliases.js to use air.* shortcuts 
     
var conn = new air.SQLConnection(); 
     
// The database file is in the application storage directory 
var folder = air.File.applicationStorageDirectory; 
var dbFile = folder.resolvePath("DBSample.db"); 
     
try 
{ 
    conn.open(dbFile); 
    air.trace("the database was created successfully"); 
} 
catch (error) 
{ 
    air.trace("Error message:", error.message); 
    air.trace("Details:", error.details); 
}

在数据库中创建表包括使用与执行 SELECT 、 INSERT 等 SQL 语句相同的过程对该数据库 执行 SQL 语句 。要创建表，请使用 CREATE TABLE 语句，该语句包括新表的列和约束的定义。有关执行 SQL 语句的详细信息，请参阅 使用 SQL 语句 。

以下示例演示如何使用异步执行模式在现有数据库文件中创建一个名为“employees”的表。请注意，此代码假定存在一个名为 conn 的 SQLConnection 实例，并且该实例已经实例化并连接到数据库。

// Include AIRAliases.js to use air.* shortcuts 
     
// ... create and open the SQLConnection instance named conn ... 
     
var createStmt = new air.SQLStatement(); 
createStmt.sqlConnection = conn; 
     
var sql =  
    "CREATE TABLE IF NOT EXISTS employees (" +  
    "    empId INTEGER PRIMARY KEY AUTOINCREMENT, " +  
    "    firstName TEXT, " +  
    "    lastName TEXT, " +  
    "    salary NUMERIC CHECK (salary > 0)" +  
    ")"; 
createStmt.text = sql; 
     
createStmt.addEventListener(air.SQLEvent.RESULT, createResult); 
createStmt.addEventListener(air.SQLErrorEvent.ERROR, createError); 
     
createStmt.execute(); 
     
function createResult(event) 
{ 
    air.trace("Table created"); 
} 
     
function createError(event) 
{ 
    air.trace("Error message:", event.error.message); 
    air.trace("Details:", event.error.details); 
}

以下示例演示如何使用同步执行模式在现有数据库文件中创建一个名为“employees”的表。请注意，此代码假定存在一个名为 conn 的 SQLConnection 实例，并且该实例已经实例化并连接到数据库。

// Include AIRAliases.js to use air.* shortcuts 
     
// ... create and open the SQLConnection instance named conn ... 
     
var createStmt = new air.SQLStatement(); 
createStmt.sqlConnection = conn; 
     
var sql =  
    "CREATE TABLE IF NOT EXISTS employees (" +  
    "    empId INTEGER PRIMARY KEY AUTOINCREMENT, " +  
    "    firstName TEXT, " +  
    "    lastName TEXT, " +  
    "    salary NUMERIC CHECK (salary > 0)" +  
    ")"; 
createStmt.text = sql; 
     
try 
{ 
    createStmt.execute(); 
    air.trace("Table created"); 
} 
catch (error) 
{ 
    air.trace("Error message:", error.message); 
    air.trace("Details:", error.details); 
}