Objekt integriertes Objekt

ObjectDbConnection

DBConnection ist die Basisklasse der Datenbankverbindung und wird zum Einrichten und Verwalten einer Datenbankverbindungssitzung verwendet. Es implementiert die Grundoperationen der Verbindung und dient als Grundlage für abgeleitete Klassen. Es unterstützt auch Vorgänge wie das Starten einer Transaktion, das Festschreiben einer Transaktion und das Zurücksetzen einer Transaktion.

Zu den Unterklassen von DBConnection gehören:Odbc,MySQL,SQLiteDurch die Instanziierung jeder Unterklasse können wir problemlos auf verschiedene Arten von Datenbanken zugreifen.

DBConnection kann nicht direkt erstellt werden, sondern nur überdb.openMit anderen Methoden erstellt, zum Beispiel:

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

Erbschaftsverhältnis

Mitgliedereigenschaften

type

String, fragen Sie den aktuellen Verbindungsdatenbanktyp ab

1
readonly String DbConnection.type;

Mitgliedsfunktion

close

Aktuelle Datenbankverbindung schließen

1
DbConnection.close() async;

use

Wählen Sie die Standarddatenbank für die aktuelle Datenbankverbindung aus

1
DbConnection.use(String dbName) async;

Aufrufparameter:

  • dbName: String, geben Sie den Datenbanknamen an

begin

Starten Sie eine Transaktion für die aktuelle Datenbankverbindung

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

Aufrufparameter:

  • point: String, gibt den Namen der Transaktion an, standardmäßig nicht angegeben

commit

Übernehmen Sie die Transaktion für die aktuelle Datenbankverbindung

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

Aufrufparameter:

  • point: String, gibt den Namen der Transaktion an, standardmäßig nicht angegeben

rollback

Rollback einer Transaktion auf der aktuellen Datenbankverbindung

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

Aufrufparameter:

  • point: String, gibt den Namen der Transaktion an, standardmäßig nicht angegeben

trans

Geben Sie eine Transaktion ein, um eine Funktion auszuführen, und führen Sie basierend auf der Ausführung der Funktion einen Commit oder ein Rollback durch.

1
Boolean DbConnection.trans(Function func);

Aufrufparameter:

  • func: Funktion, eine Funktion, die auf transaktionale Weise ausgeführt wird

Rückgabeergebnisse:

  • Boolean, gibt zurück, ob die Transaktion festgeschrieben wurde, gibt „true“ für normales Festschreiben zurück, gibt „false“ für Rollback zurück und gibt einen Fehler aus, wenn die Transaktion fehlschlägt.

Es gibt drei Ergebnisse der Funktionsausführung:

  • Die Funktion kehrt normal zurück, einschließlich Betriebsende und aktiver Rückgabe. Zu diesem Zeitpunkt wird die Transaktion automatisch festgeschrieben.
  • Die Funktion gibt false zurück und die Transaktion wird zurückgesetzt
  • Funktionsfehler, Transaktion wird automatisch zurückgesetzt

Geben Sie eine Transaktion ein, um eine Funktion auszuführen, und führen Sie basierend auf der Ausführung der Funktion einen Commit oder ein Rollback durch.

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

Aufrufparameter:

  • point: String, gibt den Namen der Transaktion an
  • func: Funktion, eine Funktion, die auf transaktionale Weise ausgeführt wird

Rückgabeergebnisse:

  • Boolean, gibt zurück, ob die Transaktion festgeschrieben wurde, gibt „true“ für normales Festschreiben zurück, gibt „false“ für Rollback zurück und gibt einen Fehler aus, wenn die Transaktion fehlschlägt.

Es gibt drei Ergebnisse der Funktionsausführung:

  • Die Funktion kehrt normal zurück, einschließlich Betriebsende und aktiver Rückgabe. Zu diesem Zeitpunkt wird die Transaktion automatisch festgeschrieben.
  • Die Funktion gibt false zurück und die Transaktion wird zurückgesetzt
  • Funktionsfehler, Transaktion wird automatisch zurückgesetzt

execute

Führen Sie einen SQL-Befehl aus und geben Sie das Ausführungsergebnis zurück

1
NArray DbConnection.execute(String sql) async;

Aufrufparameter:

  • sql: Zeichenfolge, Zeichenfolge

Rückgabeergebnisse:

  • NArray, gibt ein Array zurück, das Ergebnisdatensätze enthält. Wenn die Anforderung UPDATE oder INSERT ist, enthält das zurückgegebene Ergebnis auch die betroffene und insertId. mssql unterstützt insertId nicht.

Führen Sie einen SQL-Befehl aus und geben Sie das Ausführungsergebnis zurück. Die Zeichenfolge kann entsprechend den Parametern formatiert werden.

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

Aufrufparameter:

  • sql: String, Formatstring, optionale Parameter werden mit ? angegeben. Zum Beispiel: „SELECT FROM TEST WHERE [id]=?“
  • args: ..., optionale Parameterliste

Rückgabeergebnisse:

  • NArray, gibt ein Array zurück, das Ergebnisdatensätze enthält. Wenn die Anforderung UPDATE oder INSERT ist, enthält das zurückgegebene Ergebnis auch die betroffene und insertId. mssql unterstützt insertId nicht.

createTable

Datentabelle erstellen

1
DbConnection.createTable(Object opts) async;

Aufrufparameter:

  • opts: Objekt, Parameterliste

dropTable

Datentabelle löschen

1
DbConnection.dropTable(Object opts) async;

Aufrufparameter:

  • opts: Objekt, Parameterliste

createIndex

Erstellen Sie einen Datentabellenindex

1
DbConnection.createIndex(Object opts) async;

Aufrufparameter:

  • opts: Objekt, Parameterliste

dropIndex

Datentabellenindex löschen

1
DbConnection.dropIndex(Object opts) async;

Aufrufparameter:

  • opts: Objekt, Parameterliste

insert

Neuen Datensatz einfügen

1
Number DbConnection.insert(Object opts) async;

Aufrufparameter:

  • opts: Objekt, Parameterliste

Rückgabeergebnisse:

  • Number, gibt die ID zurück, die die Einfügung enthält, oder 0, wenn die Engine dies nicht unterstützt.

find

Fragen Sie Daten basierend auf angegebenen Bedingungen ab

1
NArray DbConnection.find(Object opts) async;

Aufrufparameter:

  • opts: Objekt, Parameterliste

Rückgabeergebnisse:

  • NArray, gibt Datensätze zurück, die Ergebnisse enthalten

count

Zählen Sie die Anzahl der Datensätze basierend auf angegebenen Bedingungen

1
Integer DbConnection.count(Object opts) async;

Aufrufparameter:

  • opts: Objekt, Parameterliste

Rückgabeergebnisse:

  • Integer, gibt die Anzahl der Datensätze zurück, die das Ergebnis enthalten

update

Aktualisieren Sie Daten basierend auf angegebenen Bedingungen

1
Integer DbConnection.update(Object opts) async;

Aufrufparameter:

  • opts: Objekt, Parameterliste

Rückgabeergebnisse:

  • Integer, gibt die Anzahl der Datensätze zurück, die Aktualisierungen enthalten

remove

Daten basierend auf angegebenen Bedingungen löschen

1
Integer DbConnection.remove(Object opts) async;

Aufrufparameter:

  • opts: Objekt, optionale Parameterliste

Rückgabeergebnisse:

  • Integer, gibt die Anzahl der Datensätze zurück, die Aktualisierungen enthalten

format

Formatieren Sie einen SQL-Befehl und geben Sie das formatierte Ergebnis zurück

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

Aufrufparameter:

  • method: String, gibt die angeforderte Methode an
  • opts: Objekt, optionale Parameterliste

Rückgabeergebnisse:

  • String, gibt den formatierten SQL-Befehl zurück

Formatieren Sie einen SQL-Befehl und geben Sie das formatierte Ergebnis zurück

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

Aufrufparameter:

  • sql: String, Formatstring, optionale Parameter werden mit ? angegeben. Zum Beispiel: „SELECT FROM TEST WHERE [id]=?“
  • args: ..., optionale Parameterliste

Rückgabeergebnisse:

  • String, gibt den formatierten SQL-Befehl zurück

toString

Gibt die Zeichenfolgendarstellung des Objekts zurück. Im Allgemeinen wird „[Native Object]“ zurückgegeben. Das Objekt kann gemäß seinen eigenen Eigenschaften neu implementiert werden.

1
String DbConnection.toString();

Rückgabeergebnisse:

  • String, gibt die Zeichenfolgendarstellung des Objekts zurück

toJSON

Gibt eine Darstellung des Objekts im JSON-Format zurück und gibt im Allgemeinen eine Sammlung lesbarer Eigenschaften zurück, die vom Objekt definiert werden.

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

Aufrufparameter:

  • key: Zeichenfolge, nicht verwendet

Rückgabeergebnisse:

  • Value, gibt einen Wert zurück, der JSON serialisierbar enthält