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