ObjectDbVerbinding
DBConnection is de basisklasse van de databaseverbinding en wordt gebruikt om een databaseverbindingssessie tot stand te brengen en te onderhouden. Het implementeert de basisbewerkingen van verbinding en dient als basis voor afgeleide klassen. Het ondersteunt ook bewerkingen zoals het starten van een transactie, het uitvoeren van een transactie en het terugdraaien van een transactie.
Subklassen van DBConnection zijn onder meer:Odbc,MySQL,SQLiteDoor elke subklasse te instantiëren, hebben we eenvoudig toegang tot verschillende soorten databases.
DBConnection kan niet rechtstreeks worden gemaakt, alleen viadb.openGemaakt met andere methoden, bijvoorbeeld:
1
2var db = require("db");
var conn = db.open("mysql://root:123456@localhost:3306/test");
erfenis relatie
eigenschappen van leden
type
String, vraag het huidige verbindingsdatabasetype op
1readonly String DbConnection.type;
lid functie
close
Sluit de huidige databaseverbinding
1DbConnection.close() async;
use
Selecteer de standaarddatabase voor de huidige databaseverbinding
1DbConnection.use(String dbName) async;
Oproepparameters:
- dbName: String, geef de databasenaam op
begin
Start een transactie op de huidige databaseverbinding
1DbConnection.begin(String point = "") async;
Oproepparameters:
- point: String, specificeert de naam van de transactie, niet standaard opgegeven
commit
Voer de transactie uit op de huidige databaseverbinding
1DbConnection.commit(String point = "") async;
Oproepparameters:
- point: String, specificeert de naam van de transactie, niet standaard opgegeven
rollback
Een transactie ongedaan maken op de huidige databaseverbinding
1DbConnection.rollback(String point = "") async;
Oproepparameters:
- point: String, specificeert de naam van de transactie, niet standaard opgegeven
trans
Voer een transactie in om een functie uit te voeren, en voer een commit of rollback uit op basis van de uitvoering van de functie.
1Boolean DbConnection.trans(Function func);
Oproepparameters:
- func: Functie, een functie die op transactionele wijze wordt uitgevoerd
Resultaten retourneren:
- Boolean, retourneert of de transactie is vastgelegd, retourneert true voor normale commit, retourneert false voor rollback en genereert een fout als de transactie fout gaat.
Er zijn drie resultaten van func-uitvoering:
- De functie keert normaal terug, inclusief einde van de werking en actieve terugkeer, waarna de transactie automatisch wordt vastgelegd.
- De functie retourneert false en de transactie wordt teruggedraaid
- Functiefout, transactie wordt automatisch teruggedraaid
Voer een transactie in om een functie uit te voeren, en voer een commit of rollback uit op basis van de uitvoering van de functie.
1
2Boolean DbConnection.trans(String point,
Function func);
Oproepparameters:
- point: String, specificeert de naam van de transactie
- func: Functie, een functie die op transactionele wijze wordt uitgevoerd
Resultaten retourneren:
- Boolean, retourneert of de transactie is vastgelegd, retourneert true voor normale commit, retourneert false voor rollback en genereert een fout als de transactie fout gaat.
Er zijn drie resultaten van func-uitvoering:
- De functie keert normaal terug, inclusief einde van de werking en actieve terugkeer, waarna de transactie automatisch wordt vastgelegd.
- De functie retourneert false en de transactie wordt teruggedraaid
- Functiefout, transactie wordt automatisch teruggedraaid
execute
Voer een SQL-opdracht uit en retourneer het uitvoeringsresultaat
1NArray DbConnection.execute(String sql) async;
Oproepparameters:
- sql: Snaar, snaar
Resultaten retourneren:
- NArray, retourneert een array met resultaatrecords. Als het verzoek UPDATE of INSERT is, bevat het geretourneerde resultaat ook beïnvloed en insertId. mssql ondersteunt insertId niet.
Voer een SQL-opdracht uit en retourneer het uitvoeringsresultaat. De tekenreeks kan worden opgemaakt volgens de parameters.
1
2NArray DbConnection.execute(String sql,
...args) async;
Oproepparameters:
- sql: String, formaatstring, optionele parameters worden gespecificeerd met ?. Bijvoorbeeld: 'SELECTEER UIT TEST WAAR [id]=?'
- args: ..., optionele parameterlijst
Resultaten retourneren:
- NArray, retourneert een array met resultaatrecords. Als het verzoek UPDATE of INSERT is, bevat het geretourneerde resultaat ook beïnvloed en insertId. mssql ondersteunt insertId niet.
createTable
Gegevenstabel maken
1DbConnection.createTable(Object opts) async;
Oproepparameters:
- opts: Object, parameterlijst
dropTable
Gegevenstabel verwijderen
1DbConnection.dropTable(Object opts) async;
Oproepparameters:
- opts: Object, parameterlijst
createIndex
Gegevenstabelindex maken
1DbConnection.createIndex(Object opts) async;
Oproepparameters:
- opts: Object, parameterlijst
dropIndex
Gegevenstabelindex verwijderen
1DbConnection.dropIndex(Object opts) async;
Oproepparameters:
- opts: Object, parameterlijst
insert
Nieuw record invoegen
1Number DbConnection.insert(Object opts) async;
Oproepparameters:
- opts: Object, parameterlijst
Resultaten retourneren:
- Number, retourneert de id die de invoeging bevat, of 0 als de engine dit niet ondersteunt.
find
Gegevens opvragen op basis van gespecificeerde voorwaarden
1NArray DbConnection.find(Object opts) async;
Oproepparameters:
- opts: Object, parameterlijst
Resultaten retourneren:
- NArray, retourneert records met resultaten
count
Tel het aantal gegevensrecords op basis van gespecificeerde voorwaarden
1Integer DbConnection.count(Object opts) async;
Oproepparameters:
- opts: Object, parameterlijst
Resultaten retourneren:
- Integer, retourneert het aantal records dat het resultaat bevat
update
Update gegevens op basis van gespecificeerde voorwaarden
1Integer DbConnection.update(Object opts) async;
Oproepparameters:
- opts: Object, parameterlijst
Resultaten retourneren:
- Integer, retourneert het aantal records met updates
remove
Gegevens verwijderen op basis van gespecificeerde voorwaarden
1Integer DbConnection.remove(Object opts) async;
Oproepparameters:
- opts: Object, optionele parameterlijst
Resultaten retourneren:
- Integer, retourneert het aantal records met updates
format
Formatteer een SQL-opdracht en retourneer het opgemaakte resultaat
1
2String DbConnection.format(String method,
Object opts);
Oproepparameters:
- method: String, specificeert de gevraagde methode
- opts: Object, optionele parameterlijst
Resultaten retourneren:
- String, retourneert de geformatteerde SQL-opdracht
Formatteer een SQL-opdracht en retourneer het opgemaakte resultaat
1
2String DbConnection.format(String sql,
...args);
Oproepparameters:
- sql: String, formaatstring, optionele parameters worden gespecificeerd met ?. Bijvoorbeeld: 'SELECTEER UIT TEST WAAR [id]=?'
- args: ..., optionele parameterlijst
Resultaten retourneren:
- String, retourneert de geformatteerde SQL-opdracht
toString
Retourneert de tekenreeksweergave van het object. Over het algemeen wordt '[Native Object]' geretourneerd. Het object kan opnieuw worden geïmplementeerd op basis van zijn eigen kenmerken.
1String DbConnection.toString();
Resultaten retourneren:
- String, retourneert de tekenreeksrepresentatie van het object
toJSON
Retourneert een weergave in JSON-indeling van het object, waarbij doorgaans een verzameling leesbare eigenschappen wordt geretourneerd die door het object zijn gedefinieerd.
1Value DbConnection.toJSON(String key = "");
Oproepparameters:
- key: Tekenreeks, niet gebruikt
Resultaten retourneren:
- Value, retourneert een waarde die JSON-serialiseerbaar bevat