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
2var db = require("db");
var conn = db.open("mysql://root:123456@localhost:3306/test");
Erbschaftsverhältnis
Mitgliedereigenschaften
type
String, fragen Sie den aktuellen Verbindungsdatenbanktyp ab
1readonly String DbConnection.type;
Mitgliedsfunktion
close
Aktuelle Datenbankverbindung schließen
1DbConnection.close() async;
use
Wählen Sie die Standarddatenbank für die aktuelle Datenbankverbindung aus
1DbConnection.use(String dbName) async;
Aufrufparameter:
- dbName: String, geben Sie den Datenbanknamen an
begin
Starten Sie eine Transaktion für die aktuelle Datenbankverbindung
1DbConnection.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
1DbConnection.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
1DbConnection.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.
1Boolean 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
2Boolean 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
1NArray 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
2NArray 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
1DbConnection.createTable(Object opts) async;
Aufrufparameter:
- opts: Objekt, Parameterliste
dropTable
Datentabelle löschen
1DbConnection.dropTable(Object opts) async;
Aufrufparameter:
- opts: Objekt, Parameterliste
createIndex
Erstellen Sie einen Datentabellenindex
1DbConnection.createIndex(Object opts) async;
Aufrufparameter:
- opts: Objekt, Parameterliste
dropIndex
Datentabellenindex löschen
1DbConnection.dropIndex(Object opts) async;
Aufrufparameter:
- opts: Objekt, Parameterliste
insert
Neuen Datensatz einfügen
1Number 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
1NArray 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
1Integer 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
1Integer 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
1Integer 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
2String 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
2String 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.
1String 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.
1Value DbConnection.toJSON(String key = "");
Aufrufparameter:
- key: Zeichenfolge, nicht verwendet
Rückgabeergebnisse:
- Value, gibt einen Wert zurück, der JSON serialisierbar enthält