ObjectDbConnection

DBConnection és la classe base de connexió de base de dades i s'utilitza per establir i mantenir una sessió de connexió de base de dades. Implementa les operacions bàsiques de connexió i serveix de base per a les classes derivades. També admet operacions com ara iniciar una transacció, confirmar una transacció i revertir una transacció.

Les subclasses de DBConnection inclouen:Odbc,MySQL,SQLite, mitjançant la instanciació de cada subclasse, podem accedir fàcilment a diferents tipus de bases de dades.

DBConnection no es pot crear directament, només mitjançantdb.openCreat per altres mètodes, per exemple:

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

relació hereditària

propietats dels membres

type

String, consulta el tipus de base de dades de connexió actual

1
readonly String DbConnection.type;

funció de membre

close

Tanqueu la connexió actual de la base de dades

1
DbConnection.close() async;

---

use

Seleccioneu la base de dades predeterminada per a la connexió de base de dades actual

1
DbConnection.use(String dbName) async;

Paràmetres de trucada:

• dbName: Cadena, especifiqueu el nom de la base de dades

---

begin

Inicieu una transacció a la connexió de base de dades actual

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

Paràmetres de trucada:

• point: String, especifica el nom de la transacció, no especificat per defecte

---

commit

Confirmeu la transacció a la connexió de base de dades actual

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

Paràmetres de trucada:

• point: String, especifica el nom de la transacció, no especificat per defecte

---

rollback

Revertir una transacció a la connexió de base de dades actual

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

Paràmetres de trucada:

• point: String, especifica el nom de la transacció, no especificat per defecte

---

trans

Introduïu una transacció per executar una funció, i cometreu o retrocediu en funció de l'execució de la funció.

1
Boolean DbConnection.trans(Function func);

Paràmetres de trucada:

• func: Funció, una funció executada de manera transaccional

Resultats de retorn:

• Boolean, retorna si la transacció s'ha confirmat, retorna true per a la confirmació normal, retorna false per rollback i genera un error si la transacció surt malament.

Hi ha tres resultats de l'execució de la funció:

• La funció torna amb normalitat, incloent el final de l'operació i el retorn actiu, moment en què la transacció es confirmarà automàticament.
• La funció retorna false i la transacció es revertirà
• Error d'operació de la funció, la transacció es revertirà automàticament

---

Introduïu una transacció per executar una funció, i cometreu o retrocediu en funció de l'execució de la funció.

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

Paràmetres de trucada:

• point: Cadena, especifica el nom de la transacció
• func: Funció, una funció executada de manera transaccional

Resultats de retorn:

• Boolean, retorna si la transacció s'ha confirmat, retorna true per a la confirmació normal, retorna false per rollback i genera un error si la transacció surt malament.

Hi ha tres resultats de l'execució de la funció:

• La funció torna amb normalitat, incloent el final de l'operació i el retorn actiu, moment en què la transacció es confirmarà automàticament.
• La funció retorna false i la transacció es revertirà
• Error d'operació de la funció, la transacció es revertirà automàticament

---

execute

Executeu una ordre sql i retorneu el resultat de l'execució

1
NArray DbConnection.execute(String sql) async;

Paràmetres de trucada:

• sql: Corda, corda

Resultats de retorn:

• NArray, retorna una matriu que conté registres de resultats. Si la sol·licitud és UPDATE o INSERT, el resultat retornat també inclourà afectat i insertId. mssql no admet insertId.

---

Executeu una ordre sql i retorneu el resultat de l'execució. La cadena es pot formatar segons els paràmetres.

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

Paràmetres de trucada:

• sql: La cadena, la cadena de format i els paràmetres opcionals s'especifiquen amb ?. Per exemple: 'SELECT FROM TEST WHERE [id]=?'
• args: ..., llista de paràmetres opcional

Resultats de retorn:

• NArray, retorna una matriu que conté registres de resultats. Si la sol·licitud és UPDATE o INSERT, el resultat retornat també inclourà afectat i insertId. mssql no admet insertId.

---

createTable

Crea una taula de dades

1
DbConnection.createTable(Object opts) async;

Paràmetres de trucada:

• opts: Objecte, llista de paràmetres

---

dropTable

Suprimeix la taula de dades

1
DbConnection.dropTable(Object opts) async;

Paràmetres de trucada:

• opts: Objecte, llista de paràmetres

---

createIndex

Crea un índex de taula de dades

1
DbConnection.createIndex(Object opts) async;

Paràmetres de trucada:

• opts: Objecte, llista de paràmetres

---

dropIndex

Suprimeix l'índex de la taula de dades

1
DbConnection.dropIndex(Object opts) async;

Paràmetres de trucada:

• opts: Objecte, llista de paràmetres

---

insert

Insereix un registre nou

1
Number DbConnection.insert(Object opts) async;

Paràmetres de trucada:

• opts: Objecte, llista de paràmetres

Resultats de retorn:

• Number, retorna l'identificador que conté la inserció, o 0 si el motor no l'admet.

---

find

Consulta les dades en funció de les condicions especificades

1
NArray DbConnection.find(Object opts) async;

Paràmetres de trucada:

• opts: Objecte, llista de paràmetres

Resultats de retorn:

• NArray, retorna registres que contenen resultats

---

count

Compteu el nombre de registres de dades en funció de les condicions especificades

1
Integer DbConnection.count(Object opts) async;

Paràmetres de trucada:

• opts: Objecte, llista de paràmetres

Resultats de retorn:

• Integer, retorna el nombre de registres que contenen el resultat

---

update

Actualitzar les dades en funció de les condicions especificades

1
Integer DbConnection.update(Object opts) async;

Paràmetres de trucada:

• opts: Objecte, llista de paràmetres

Resultats de retorn:

• Integer, retorna el nombre de registres que contenen actualitzacions

---

remove

Suprimeix les dades en funció de les condicions especificades

1
Integer DbConnection.remove(Object opts) async;

Paràmetres de trucada:

• opts: Objecte, llista de paràmetres opcional

Resultats de retorn:

• Integer, retorna el nombre de registres que contenen actualitzacions

---

format

Formateu una ordre sql i retorneu el resultat amb format

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

Paràmetres de trucada:

• method: String, especifica el mètode sol·licitat
• opts: Objecte, llista de paràmetres opcional

Resultats de retorn:

• String, retorna l'ordre sql amb format

---

Formateu una ordre sql i retorneu el resultat amb format

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

Paràmetres de trucada:

• sql: La cadena, la cadena de format i els paràmetres opcionals s'especifiquen amb ?. Per exemple: 'SELECT FROM TEST WHERE [id]=?'
• args: ..., llista de paràmetres opcional

Resultats de retorn:

• String, retorna l'ordre sql amb format

---

toString

Retorna la representació de cadena de l'objecte. En general, es retorna "[Objecte natiu]". L'objecte es pot tornar a implementar segons les seves pròpies característiques.

1
String DbConnection.toString();

Resultats de retorn:

• String, retorna la representació de cadena de l'objecte

---

toJSON

Retorna una representació en format JSON de l'objecte, generalment retornant una col·lecció de propietats llegibles definides per l'objecte.

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

Paràmetres de trucada:

• key: Corda, no utilitzada

Resultats de retorn:

• Value, retorna un valor que conté JSON serializable