Obxecto incorporado

Conexión Db de obxectos

O obxecto de conexión á base de datos úsase para establecer e manter unha sesión de conexión á base de datos.

Herdanza

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

Atributos dos membros

type

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

1
readonly String DbConnection.type;

Función de membro

close

Peche a conexión actual á base de datos

1
DbConnection.close() async;

use

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

1
DbConnection.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
DbConnection.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
DbConnection.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
DbConnection.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 DbConnection.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 devolve 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 devolverase
  • 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 DbConnection.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 devolve 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 devolverase
  • 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 DbConnection.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 DbConnection.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
DbConnection.createTable(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

dropTable

Eliminar táboa de datos

1
DbConnection.dropTable(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

createIndex

Crear índice de táboa de datos

1
DbConnection.createIndex(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

dropIndex

Elimina o índice da táboa de datos

1
DbConnection.dropIndex(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

insert

Inserir novo rexistro

1
Number DbConnection.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 DbConnection.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 DbConnection.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 DbConnection.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 os datos segundo as condicións especificadas

1
Integer DbConnection.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 DbConnection.format(String method, Object opts);

Parámetros de chamada:

  • method: Cadea, especifica o método de solicitude
  • 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 DbConnection.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 DbConnection.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 DbConnection.toJSON(String key = "");

Parámetros de chamada:

  • key: Cadea, sen usar

Resultado de volta:

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