Obxecto obxecto incorporado

objectDbConnection

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

relación de 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

Propiedades dos membros

type

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

1
readonly String DbConnection.type;

función de membro

close

pecha a conexión de base de datos actual

1
DbConnection.close() async;

use

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

1
DbConnection.use(String dbName) async;

Parámetros de chamada:

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

begin

Iniciar unha transacción na conexión de base de datos actual

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

Parámetros de chamada:

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

commit

Confirme a transacción na conexión de base de datos actual

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

Parámetros de chamada:

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

rollback

Retrocede a transacción na conexión de base de datos actual

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

Parámetros de chamada:

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

trans

Introduza a 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, a función a executar transaccionalmente

Devolver resultado:

  • Boolean, Devolve se a transacción está confirmada, devolve verdadeiro para a confirmación normal, devolve false para a recuperación e arroxa un erro se a transacción falla

Hai tres resultados da execución da función:

  • A función volve normalmente, incluíndo o final da operación e o retorno activo, momento no que a transacción confirmarase automaticamente
  • A función devolve false, momento no que a transacción será revertida
  • A función execútase incorrectamente e a transacción revélase automaticamente

Introduza a 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, especifica o nome da transacción
  • func: Función, a función a executar transaccionalmente

Devolver resultado:

  • Boolean, Devolve se a transacción está confirmada, devolve verdadeiro para a confirmación normal, devolve false para a recuperación e arroxa un erro se a transacción falla

Hai tres resultados da execución da función:

  • A función volve normalmente, incluíndo o final da operación e o retorno activo, momento no que a transacción confirmarase automaticamente
  • A función devolve false, momento no que a transacción será revertida
  • A función execútase incorrectamente e a transacción revélase automaticamente

execute

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

1
NArray DbConnection.execute(String sql) async;

Parámetros de chamada:

  • sql: Corda, corda

Devolver resultado:

  • NArray, devolve unha matriz que contén os rexistros do resultado, se a solicitude é UPDATE ou INSERT, o resultado devolto tamén conterá afectado e insertId, mssql non admite insertId.

Execute un comando sql e devolve o resultado da execución, que pode formatar a cadea segundo os parámetros

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

Parámetros de chamada:

  • sql: A cadea, a cadea de formato e os parámetros opcionais especifícanse con ?. Por exemplo: 'SELECT FROM TEST WHERE [id]=?'
  • args: ..., lista de parámetros opcional

Devolver resultado:

  • NArray, devolve unha matriz que contén os rexistros do resultado, se a solicitude é UPDATE ou INSERT, 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 a 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

1
DbConnection.createIndex(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

dropIndex

eliminar o índice da táboa

1
DbConnection.dropIndex(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

insert

inserir un novo rexistro

1
Number DbConnection.insert(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

Devolver resultado:

  • Number, devolve o id que contén a inserción ou 0 se o motor non o admite

find

Consulta os datos en función das condicións especificadas

1
NArray DbConnection.find(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

Devolver resultado:

  • NArray, devolve un rexistro que contén o resultado

count

Conta o número de rexistros de datos en función das condicións especificadas

1
Integer DbConnection.count(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

Devolver resultado:

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

update

Actualizar os datos en función das condicións especificadas

1
Integer DbConnection.update(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

Devolver resultado:

  • Integer, devolve o número de rexistros que conteñen a actualización

remove

Elimina os datos en función das condicións especificadas

1
Integer DbConnection.remove(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros opcional

Devolver resultado:

  • Integer, devolve o número de rexistros que conteñen a actualización

format

Formatear un comando sql e devolver o resultado formateado

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

Parámetros de chamada:

  • method: Cadea, especificando o método da solicitude
  • opts: Obxecto, lista de parámetros opcional

Devolver resultado:

  • String, devolve o comando sql despois do formato

Formatear un comando sql e devolver o resultado formateado

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

Parámetros de chamada:

  • sql: A cadea, a cadea de formato e os parámetros opcionais especifícanse con ?. Por exemplo: 'SELECT FROM TEST WHERE [id]=?'
  • args: ..., lista de parámetros opcional

Devolver resultado:

  • String, devolve o comando sql despois do formato

toString

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

1
String DbConnection.toString();

Devolver resultado:

  • String, devolve a representación en cadea do obxecto

toJSON

Devolve a representación en formato JSON do obxecto, xeralmente devolve o conxunto de propiedades lexibles definidas polo obxecto

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

Parámetros de chamada:

  • key: Corda, sen usar

Devolver resultado:

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