Object-ingebouwd object

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 2
var 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

1
readonly String DbConnection.type;

lid functie

close

Sluit de huidige databaseverbinding

1
DbConnection.close() async;

use

Selecteer de standaarddatabase voor de huidige databaseverbinding

1
DbConnection.use(String dbName) async;

Oproepparameters:

  • dbName: String, geef de databasenaam op

begin

Start een transactie op de huidige databaseverbinding

1
DbConnection.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

1
DbConnection.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

1
DbConnection.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.

1
Boolean 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 2
Boolean 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

1
NArray 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 2
NArray 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

1
DbConnection.createTable(Object opts) async;

Oproepparameters:

  • opts: Object, parameterlijst

dropTable

Gegevenstabel verwijderen

1
DbConnection.dropTable(Object opts) async;

Oproepparameters:

  • opts: Object, parameterlijst

createIndex

Gegevenstabelindex maken

1
DbConnection.createIndex(Object opts) async;

Oproepparameters:

  • opts: Object, parameterlijst

dropIndex

Gegevenstabelindex verwijderen

1
DbConnection.dropIndex(Object opts) async;

Oproepparameters:

  • opts: Object, parameterlijst

insert

Nieuw record invoegen

1
Number 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

1
NArray 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

1
Integer 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

1
Integer 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

1
Integer 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 2
String 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 2
String 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.

1
String 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.

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

Oproepparameters:

  • key: Tekenreeks, niet gebruikt

Resultaten retourneren:

  • Value, retourneert een waarde die JSON-serialiseerbaar bevat