Obxecto obxecto incorporado

ObjectDbConnection

DBConnection é a clase base de conexión de base de datos e úsase para establecer e manter unha sesión de conexión de base de datos. Implementa as operacións básicas de conexión e serve de base para as clases derivadas. Tamén admite operacións como iniciar unha transacción, confirmar unha transacción e revertir unha transacción.

As subclases de DBConnection inclúen:Odbc,MySQL,SQLite, ao crear unha instancia de cada subclase, podemos acceder facilmente a diferentes tipos de bases de datos.

DBConnection non se pode crear directamente, só a travésdb.openCreado por outros métodos, por exemplo:

1 2
var db = require("db"); var conn = db.open("mysql://root:123456@localhost:3306/test");

relación de herdanza

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 actual da base de datos

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

Revertir unha 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 unha transacción para executar unha función e comite ou retroceda en función da execución da función.

1
Boolean DbConnection.trans(Function func);

Parámetros de chamada:

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

Resultados de devolución:

  • 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 sae mal.

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 e a transacción será revertida
  • Erro na operación da función, a transacción retrocedeuse automaticamente

Introduza unha transacción para executar unha función e comite ou retroceda en función da 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, unha función executada de forma transaccional

Resultados de devolución:

  • 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 sae mal.

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 e a transacción será revertida
  • Erro na operación da función, a transacción retrocedeuse 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

Resultados de devolución:

  • NArray, devolve unha matriz que contén rexistros de resultados. Se a solicitude é UPDATE ou INSERT, o resultado devolto tamén incluirá afectados e insertId. mssql non admite insertId.

Execute un comando sql e devolve o resultado da execución. A cadea pódese formatar 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

Resultados de devolución:

  • NArray, devolve unha matriz que contén rexistros de resultados. Se a solicitude é UPDATE ou INSERT, o resultado devolto tamén incluirá afectados 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 de datos

1
DbConnection.createIndex(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

dropIndex

Eliminar o índice da táboa de datos

1
DbConnection.dropIndex(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

insert

Insire novo rexistro

1
Number DbConnection.insert(Object opts) async;

Parámetros de chamada:

  • opts: Obxecto, lista de parámetros

Resultados de devolución:

  • 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

Resultados de devolución:

  • NArray, devolve rexistros que conteñen resultados

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

Resultados de devolución:

  • 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

Resultados de devolución:

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

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

Resultados de devolución:

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

format

Formatear un comando sql e devolver o resultado formateado

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

Parámetros de chamada:

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

Resultados de devolución:

  • String, devolve o comando sql con 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

Resultados de devolución:

  • String, devolve o comando sql con formato

toString

Devolve a representación en cadea do obxecto. Polo xeral, devólvese "[Obxecto nativo]". O obxecto pódese volver implementar segundo as súas propias características.

1
String DbConnection.toString();

Resultados de devolución:

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

toJSON

Devolve unha representación en formato JSON do obxecto, devolvendo xeralmente unha colección de propiedades lexibles definidas polo obxecto.

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

Parámetros de chamada:

  • key: Cadena, non usada

Resultados de devolución:

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