Obxecto incorporado

Obxecto SQLite

Obxecto de conexión á base de datos SQLite

uso db.open ou db.openSQLite Crear, crear método:

1
var slite = db.openSQLite("sqlite:/path/to/db");

Herdanza

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<class>DbConnection|type|close();use();begin();commit();rollback();trans();execute();createTable();dropTable();createIndex();dropIndex();insert();find();count();update();remove();format()] [<this>SQLite|fileName;timeout|backup()] [object] <:- [DbConnection] [DbConnection] <:- [SQLite] DbConnection type close() use() begin() commit() rollback() trans() execute() createTable() dropTable() createIndex() dropIndex() insert() find() count() update() remove() format() SQLite fileName timeout backup() object toString() toJSON()

Atributos dos membros

fileName

Cadea, nome actual do ficheiro da base de datos

1
readonly String SQLite.fileName;

timeout

Entero, consulta e configura o tempo de espera da base de datos, en milisegundos

1
Integer SQLite.timeout;

type

Cadea, consulta o tipo de base de datos de conexión actual

1
readonly String SQLite.type;

Función de membro

backup

Fai unha copia de seguridade da base de datos actual nun novo ficheiro

1
SQLite.backup(String fileName) async;

Parámetros de chamada:

  • fileName: Cadea, especifique o nome do ficheiro de base de datos de copia de seguridade

close

Peche a conexión actual á base de datos

1
SQLite.close() async;

use

Seleccione a base de datos predeterminada para a conexión actual á base de datos

1
SQLite.use(String dbName) async;

Parámetros de chamada:

  • dbName: Cadea, especifique o nome da base de datos

begin

Inicie unha transacción na conexión actual á base de datos

1
SQLite.begin(String point = "") async;

Parámetros de chamada:

  • point: Cadea, especifique o nome da transacción, non especificado por defecto

commit

Compromite a transacción coa conexión actual á base de datos

1
SQLite.commit(String point = "") async;

Parámetros de chamada:

  • point: Cadea, especifique o nome da transacción, non especificado por defecto

rollback

Retroceda a transacción na conexión actual á base de datos

1
SQLite.rollback(String point = "") async;

Parámetros de chamada:

  • point: Cadea, especifique o nome da transacción, non especificado por defecto

trans

Introduza unha transacción para executar unha función e envíe ou retroceda segundo a execución da función

1
Boolean SQLite.trans(Function func);

Parámetros de chamada:

  • func: Función, unha función executada de xeito transaccional

Resultado de volta:

  • Boolean, Devolve se a transacción está comprometida, verdadeira para a confirmación normal, falsa para a retroceso e prodúcese un erro se hai un erro na transacción

A execución de func ten tres resultados:

  • A función volve normalmente, incluído o final da operación e o retorno activo, momento no que a transacción comprometerase automaticamente
  • A función devolve falsa, neste momento a transacción será recuperada
  • A función execútase incorrectamente, a transacción revólvese automaticamente

Introduza unha transacción para executar unha función e envíe ou retroceda segundo a execución da función

1 2
Boolean SQLite.trans(String point, Function func);

Parámetros de chamada:

  • point: Cadea, especifique o nome da transacción
  • func: Función, unha función executada de xeito transaccional

Resultado de volta:

  • Boolean, Devolve se a transacción está comprometida, verdadeira para a confirmación normal, falsa para a retroceso e prodúcese un erro se hai un erro na transacción

A execución de func ten tres resultados:

  • A función volve normalmente, incluído o final da operación e o retorno activo, momento no que a transacción comprometerase automaticamente
  • A función devolve falsa, neste momento a transacción será recuperada
  • A función execútase incorrectamente, a transacción revólvese automaticamente

execute

Executa un comando sql e devolve o resultado da execución

1
NArray SQLite.execute(String sql) async;

Parámetros de chamada:

  • sql: Cadea, cadea

Resultado de volta:

  • NArray, Devolve unha matriz que contén os rexistros de resultados. Se a solicitude é ACTUALIZAR ou INSERIR, o resultado devolto tamén conterá afectado e insertId. Mssql non admite insertId.

Executar un comando sql e devolver o resultado da execución pode formatar a cadea segundo os parámetros

1 2
NArray SQLite.execute(String sql, ...args) async;

Parámetros de chamada:

  • sql: Cadea, cadea de formato, os parámetros opcionais especifícanse con?. Por exemplo: 'SELECCIONAR DA PROBA ONDE [id] =?'
  • args: ..., lista de parámetros opcional

Resultado de volta:

  • NArray, Devolve unha matriz que contén os rexistros de resultados. Se a solicitude é ACTUALIZAR ou INSERIR, o resultado devolto tamén conterá afectado e insertId. Mssql non admite insertId.

createTable

Crear táboa de datos

1
SQLite.createTable(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

dropTable

Eliminar táboa de datos

1
SQLite.dropTable(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

createIndex

Crear índice de táboa de datos

1
SQLite.createIndex(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

dropIndex

Elimina o índice da táboa de datos

1
SQLite.dropIndex(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

insert

Inserir novo rexistro

1
Number SQLite.insert(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

Resultado de volta:

  • Number, Devolve o id que contén o inserto ou 0 se o motor non o admite

find

Consultar datos segundo as condicións especificadas

1
NArray SQLite.find(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

Resultado de volta:

  • NArray, Devolve o rexistro que contén o resultado

count

Conta o número de rexistros de datos segundo as condicións especificadas

1
Integer SQLite.count(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

Resultado de volta:

  • Integer, Devolve o número de rexistros que conteñen o resultado

update

Actualice os datos segundo as condicións especificadas

1
Integer SQLite.update(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

Resultado de volta:

  • Integer, Devolve o número de rexistros que conteñen actualizacións

remove

Elimina datos segundo as condicións especificadas

1
Integer SQLite.remove(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros opcional

Resultado de volta:

  • Integer, Devolve o número de rexistros que conteñen actualizacións

format

Formatee un comando sql e devolva o resultado formatado

1 2
String SQLite.format(String method, Object opts);

Parámetros de chamada:

  • method: Cadea, especifica o método solicitado
  • opts: Obxecto, lista de parámetros opcional

Resultado de volta:

  • String, Devolve o comando sql formatado

Formatee un comando sql e devolva o resultado formatado

1 2
String SQLite.format(String sql, ...args);

Parámetros de chamada:

  • sql: Cadea, cadea de formato, os parámetros opcionais especifícanse con?. Por exemplo: 'SELECCIONAR DA PROBA ONDE [id] =?'
  • args: ..., lista de parámetros opcional

Resultado de volta:

  • String, Devolve o comando sql formatado

toString

Devolve a representación de cadea do obxecto, xeralmente devolve "[Obxecto nativo]", o obxecto pode reimplementarse segundo as súas propias características

1
String SQLite.toString();

Resultado de volta:

  • String, Devolve a representación de cadea do obxecto

toJSON

Devolve a representación en formato JSON do obxecto, xeralmente devolve unha colección de atributos lexibles definidos polo obxecto

1
Value SQLite.toJSON(String key = "");

Parámetros de chamada:

  • key: Cadea, sen usar

Resultado de volta:

  • Value, Devolve un valor que contén JSON serializable