ConexiónObjetoDb

DBConnection es la clase base de conexión de base de datos y se utiliza para establecer y mantener una sesión de conexión de base de datos. Implementa las operaciones básicas de conexión y sirve como base para clases derivadas. También admite operaciones como iniciar una transacción, confirmar una transacción y revertir una transacción.

Las subclases de DBConnection incluyen:Odbc,MySQL,SQLite, al crear una instancia de cada subclase, podemos acceder fácilmente a diferentes tipos de bases de datos.

DBConnection no se puede crear directamente, sólo a través dedb.openCreado por otros métodos, por ejemplo:

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

relación de herencia

propiedades de miembros

type

Cadena, consulta el tipo de base de datos de conexión actual

1
readonly String DbConnection.type;

función miembro

close

Cerrar la conexión de base de datos actual

1
DbConnection.close() async;

---

use

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

1
DbConnection.use(String dbName) async;

Parámetros de llamada:

• dbName: Cadena, especifique el nombre de la base de datos

---

begin

Iniciar una transacción en la conexión de base de datos actual

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

Parámetros de llamada:

• point: Cadena, especifica el nombre de la transacción, no especificado por defecto

---

commit

Confirmar la transacción en la conexión de base de datos actual

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

Parámetros de llamada:

• point: Cadena, especifica el nombre de la transacción, no especificado por defecto

---

rollback

Revertir una transacción en la conexión de base de datos actual

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

Parámetros de llamada:

• point: Cadena, especifica el nombre de la transacción, no especificado por defecto

---

trans

Ingrese una transacción para ejecutar una función y confirme o revierta según la ejecución de la función.

1
Boolean DbConnection.trans(Function func);

Parámetros de llamada:

• func: Función, una función ejecutada de forma transaccional

Resultados de devolución:

• Boolean, devuelve si la transacción se ha confirmado, devuelve verdadero para una confirmación normal, devuelve falso para una reversión y arroja un error si la transacción sale mal.

Hay tres resultados de la ejecución de la función:

• La función regresa normalmente, incluido el final de la operación y el retorno activo, momento en el cual la transacción se confirmará automáticamente.
• La función devuelve falso y la transacción se revertirá
• Error de operación de función, transacción revertida automáticamente

---

Ingrese una transacción para ejecutar una función y confirme o revierta según la ejecución de la función.

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

Parámetros de llamada:

• point: Cadena, especifica el nombre de la transacción
• func: Función, una función ejecutada de forma transaccional

Resultados de devolución:

• Boolean, devuelve si la transacción se ha confirmado, devuelve verdadero para una confirmación normal, devuelve falso para una reversión y arroja un error si la transacción sale mal.

Hay tres resultados de la ejecución de la función:

• La función regresa normalmente, incluido el final de la operación y el retorno activo, momento en el cual la transacción se confirmará automáticamente.
• La función devuelve falso y la transacción se revertirá
• Error de operación de función, transacción revertida automáticamente

---

execute

Ejecute un comando sql y devuelva el resultado de la ejecución

1
NArray DbConnection.execute(String sql) async;

Parámetros de llamada:

• sql: Cuerda, cuerda

Resultados de devolución:

• NArray, devuelve una matriz que contiene registros de resultados. Si la solicitud es ACTUALIZAR o INSERTAR, el resultado devuelto también incluirá afectado e insertId. mssql no admite insertId.

---

Ejecute un comando sql y devuelva el resultado de la ejecución. La cadena se puede formatear de acuerdo con los parámetros.

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

Parámetros de llamada:

• sql: Cadena, cadena de formato, los parámetros opcionales se especifican con ?. Por ejemplo: 'SELECCIONAR DE LA PRUEBA DONDE [id]=?'
• args: ..., lista de parámetros opcionales

Resultados de devolución:

• NArray, devuelve una matriz que contiene registros de resultados. Si la solicitud es ACTUALIZAR o INSERTAR, el resultado devuelto también incluirá afectado e insertId. mssql no admite insertId.

---

createTable

Crear tabla de datos

1
DbConnection.createTable(Object opts) async;

Parámetros de llamada:

• opts: Objeto, lista de parámetros

---

dropTable

Eliminar tabla de datos

1
DbConnection.dropTable(Object opts) async;

Parámetros de llamada:

• opts: Objeto, lista de parámetros

---

createIndex

Crear índice de tabla de datos

1
DbConnection.createIndex(Object opts) async;

Parámetros de llamada:

• opts: Objeto, lista de parámetros

---

dropIndex

Eliminar índice de tabla de datos

1
DbConnection.dropIndex(Object opts) async;

Parámetros de llamada:

• opts: Objeto, lista de parámetros

---

insert

Insertar nuevo registro

1
Number DbConnection.insert(Object opts) async;

Parámetros de llamada:

• opts: Objeto, lista de parámetros

Resultados de devolución:

• Number, devuelve la identificación que contiene la inserción, o 0 si el motor no lo admite.

---

find

Consultar datos según condiciones específicas.

1
NArray DbConnection.find(Object opts) async;

Parámetros de llamada:

• opts: Objeto, lista de parámetros

Resultados de devolución:

• NArray, devuelve registros que contienen resultados

---

count

Cuente el número de registros de datos según las condiciones especificadas

1
Integer DbConnection.count(Object opts) async;

Parámetros de llamada:

• opts: Objeto, lista de parámetros

Resultados de devolución:

• Integer, devuelve el número de registros que contienen el resultado

---

update

Actualizar datos según condiciones específicas

1
Integer DbConnection.update(Object opts) async;

Parámetros de llamada:

• opts: Objeto, lista de parámetros

Resultados de devolución:

• Integer, devuelve el número de registros que contienen actualizaciones

---

remove

Eliminar datos según condiciones específicas

1
Integer DbConnection.remove(Object opts) async;

Parámetros de llamada:

• opts: Objeto, lista de parámetros opcionales

Resultados de devolución:

• Integer, devuelve el número de registros que contienen actualizaciones

---

format

Formatee un comando SQL y devuelva el resultado formateado

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

Parámetros de llamada:

• method: Cadena, especifica el método solicitado
• opts: Objeto, lista de parámetros opcionales

Resultados de devolución:

• String, devuelve el comando sql formateado

---

Formatee un comando SQL y devuelva el resultado formateado

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

Parámetros de llamada:

• sql: Cadena, cadena de formato, los parámetros opcionales se especifican con ?. Por ejemplo: 'SELECCIONAR DE LA PRUEBA DONDE [id]=?'
• args: ..., lista de parámetros opcionales

Resultados de devolución:

• String, devuelve el comando sql formateado

---

toString

Devuelve la representación de cadena del objeto. Generalmente, se devuelve "[Objeto nativo]". El objeto se puede volver a implementar de acuerdo con sus propias características.

1
String DbConnection.toString();

Resultados de devolución:

• String, devuelve la representación de cadena del objeto

---

toJSON

Devuelve una representación en formato JSON del objeto, que generalmente devuelve una colección de propiedades legibles definidas por el objeto.

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

Parámetros de llamada:

• key: Cadena, no utilizada

Resultados de devolución:

• Value, devuelve un valor que contiene JSON serializable