Sqlite

Moduleejs.db.sqlite
Definition class Sqlite
InheritanceSqlite inherit Object
Specifiedejscript-1.1
StabilityEvolving.

SQLite database support.


Properties

QualifiersPropertyTypeDescription
No properties defined

Sqlite Methods

QualifiersMethod
public addColumn(table: String, column: String, datatype: String, options: Object = null): Void
 Add a column to a table.param options.
public addIndex(table: String, column: String, index: String): Void
 Add an index on a column.
public close(): Void
 Close the database connection.
public commit(): Void
 Commit a database transaction.Not implemented.
public createDatabase(name: String, options: Object = null): Void
 Create a new database.param options.
public createTable(table: String, columns: Array = null): Void
 Create a new table.param columns.
public static dataTypeToSqlType(dataType: String): String
 Map the database independant data type to a database dependant SQL data type.
public destroyDatabase(name: String): Void
 Destroy a database.
public destroyTable(table: String): Void
 Destroy a table.
public endTransaction(): Void
 End a transaction.
public getColumns(table: String): Array
 Get column information.
public getNumRows(table: String): Number
 Return the number of rows in a table.
public getTables(): Array
 Return list of tables in a database.
public query(cmd: String, tag: String = SQL , trace: Boolean = false): Array
 Execute a SQL command on the database.param tag.
public removeColumns(table: String, columns: Array): Void
 Remove columns from a table.
public removeIndex(table: String, index: String): Void
 Remove an index.
public renameTable(oldTable: String, newTable: String): Void
 Rename a table.
public sql(cmd: String): Array
 Execute a SQL command on the database.
Sqlite(connectionString: String)
 Initialize a database connection using the supplied database connection string.
public static sqlTypeToDataType(sqlType: String): String
 Map the SQL type to a database independant data type.
public static sqlTypeToEjsType(sqlType: String): Type
 Map the SQL type to an Ejscript type class.
public startTransaction(): Void
 Start a new database transaction.

Method Detail

public addColumn(table: String, column: String, datatype: String, options: Object = null): Void

Add a column to a table.param options.

Parameters
table: String Name of the table.
column: String Name of the column to add.
datatype: String Database independant type of the column. Valid types are: binary, boolean, date, datetime, decimal, float, integer, number, string, text, time and timestamp.
options: Object Optional parameters. [default: null]

public addIndex(table: String, column: String, index: String): Void

Add an index on a column.

Parameters
table: String Name of the table.
column: String Name of the column to add.
index: String Name of the index.

public close(): Void

Close the database connection.

Description
Database connections should be closed when no longer needed rather than waiting for the garbage collector to automatically close the connection when disposing the database instance.

public commit(): Void

Commit a database transaction.Not implemented.


public createDatabase(name: String, options: Object = null): Void

Create a new database.param options.

Parameters
name: String Name of the database.
options: Object [default: null]
Options
OptionalParameters.

public createTable(table: String, columns: Array = null): Void

Create a new table.param columns.

Parameters
table: String Name of the table.
columns: Array Array of column descriptor tuples consisting of name:datatype. [default: null]
Options
OptionalParameters.

static public dataTypeToSqlType(dataType: String): String

Map the database independant data type to a database dependant SQL data type.

Parameters
dataType: String Data type to map.
Returns
The corresponding SQL database type.

public destroyDatabase(name: String): Void

Destroy a database.

Parameters
name: String Name of the database to remove.

public destroyTable(table: String): Void

Destroy a table.

Parameters
table: String Name of the table to destroy.

public endTransaction(): Void

End a transaction.


public getColumns(table: String): Array

Get column information.

Parameters
table: String Name of the table to examine.
Returns
An array of column data. This is database specific content and will vary depending on the database connector in use.

public getNumRows(table: String): Number

Return the number of rows in a table.

Returns
The count of rows in a table in the currently opened database.

public getTables(): Array

Return list of tables in a database.

Returns
An array containing list of table names present in the currently opened database.

public query(cmd: String, tag: String = SQL , trace: Boolean = false): Array

Execute a SQL command on the database.param tag.

Parameters
cmd: String SQL command string.
tag: String Debug tag to use when logging the command. [default: SQL ]
trace: Boolean Set to true to eanble logging this command. [default: false]
trace: Boolean [default: false]
Returns
An array of row results where each row is represented by an Object hash containing the column names and values.

public removeColumns(table: String, columns: Array): Void

Remove columns from a table.

Parameters
table: String Name of the table to modify.
columns: Array Array of column names to remove.

public removeIndex(table: String, index: String): Void

Remove an index.

Parameters
table: String Name of the table to modify.
index: String Name of the index to remove.

public renameTable(oldTable: String, newTable: String): Void

Rename a table.

Parameters
oldTable: String Old table name.
newTable: String New table name.

public sql(cmd: String): Array

Execute a SQL command on the database.

Description
This is a low level SQL command interface that bypasses logging. Use.
Parameters
cmd: String SQL command to issue. Note: "SELECT" is automatically prepended and ";" is appended for you.
Returns
An array of row results where each row is represented by an Object hash containing the column names and values.

public Sqlite(connectionString: String)

Initialize a database connection using the supplied database connection string.

Parameters
connectionString: String Connection string stipulating how to connect to the database. The only supported format is:
  • filename
Where filename is the path to the database

static public sqlTypeToDataType(sqlType: String): String

Map the SQL type to a database independant data type.

Parameters
sqlType: String SQL Data type to map.
Returns
The corresponding database independant type.

static public sqlTypeToEjsType(sqlType: String): Type

Map the SQL type to an Ejscript type class.

Parameters
sqlType: String SQL Data type to map.
Returns
The corresponding type class.

public startTransaction(): Void

Start a new database transaction.