Oggetto oggetto incorporato

ObjectDbConnection

DBConnection è la classe base della connessione al database e viene utilizzata per stabilire e mantenere una sessione di connessione al database. Implementa le operazioni di base della connessione e funge da base per le classi derivate. Supporta inoltre operazioni come l'avvio di una transazione, il commit di una transazione e il rollback di una transazione.

Le sottoclassi di DBConnection includono:Odbc,MySQL,SQLite, istanziando ciascuna sottoclasse, possiamo accedere facilmente a diversi tipi di database.

DBConnection non può essere creato direttamente, solo tramitedb.openCreato con altri metodi, ad esempio:

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

rapporto ereditario

proprietà dei membri

type

String, interroga il tipo di database di connessione corrente

1
readonly String DbConnection.type;

funzione membro

close

Chiude la connessione al database corrente

1
DbConnection.close() async;

use

Seleziona il database predefinito per la connessione al database corrente

1
DbConnection.use(String dbName) async;

Parametri di chiamata:

  • dbName: Stringa, specifica il nome del database

begin

Avvia una transazione sulla connessione al database corrente

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

Parametri di chiamata:

  • point: String, specifica il nome della transazione, non specificato per impostazione predefinita

commit

Effettua il commit della transazione sulla connessione al database corrente

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

Parametri di chiamata:

  • point: String, specifica il nome della transazione, non specificato per impostazione predefinita

rollback

Rollback di una transazione sulla connessione al database corrente

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

Parametri di chiamata:

  • point: String, specifica il nome della transazione, non specificato per impostazione predefinita

trans

Immettere una transazione per eseguire una funzione ed eseguire il commit o il rollback in base all'esecuzione della funzione.

1
Boolean DbConnection.trans(Function func);

Parametri di chiamata:

  • func: Funzione, una funzione eseguita in modo transazionale

Risultati restituiti:

  • Boolean, restituisce se la transazione è stata confermata, restituisce true per il commit normale, restituisce false per il rollback e genera un errore se la transazione va male.

Ci sono tre risultati dell'esecuzione della funzione:

  • La funzione restituisce normalmente, inclusa la fine dell'operazione e il reso attivo, momento in cui la transazione verrà automaticamente impegnata.
  • La funzione restituisce false e la transazione verrà annullata
  • Errore di operazione della funzione, transazione annullata automaticamente

Immettere una transazione per eseguire una funzione ed eseguire il commit o il rollback in base all'esecuzione della funzione.

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

Parametri di chiamata:

  • point: String, specifica il nome della transazione
  • func: Funzione, una funzione eseguita in modo transazionale

Risultati restituiti:

  • Boolean, restituisce se la transazione è stata confermata, restituisce true per il commit normale, restituisce false per il rollback e genera un errore se la transazione va male.

Ci sono tre risultati dell'esecuzione della funzione:

  • La funzione restituisce normalmente, inclusa la fine dell'operazione e il reso attivo, momento in cui la transazione verrà automaticamente impegnata.
  • La funzione restituisce false e la transazione verrà annullata
  • Errore di operazione della funzione, transazione annullata automaticamente

execute

Esegui un comando SQL e restituisce il risultato dell'esecuzione

1
NArray DbConnection.execute(String sql) async;

Parametri di chiamata:

  • sql: corda, corda

Risultati restituiti:

  • NArray, restituisce un array contenente i record dei risultati. Se la richiesta è UPDATE o INSERT, il risultato restituito includerà anche l'elemento interessato e l'insertId. mssql non supporta l'insertId.

Esegui un comando sql e restituisce il risultato dell'esecuzione. La stringa può essere formattata in base ai parametri.

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

Parametri di chiamata:

  • sql: Stringa, stringa di formato, parametri opzionali vengono specificati con ?. Ad esempio: "SELECT FROM TEST WHERE [id]=?"
  • args: ..., elenco parametri opzionale

Risultati restituiti:

  • NArray, restituisce un array contenente i record dei risultati. Se la richiesta è UPDATE o INSERT, il risultato restituito includerà anche l'elemento interessato e l'insertId. mssql non supporta l'insertId.

createTable

Crea tabella dati

1
DbConnection.createTable(Object opts) async;

Parametri di chiamata:

  • opts: Oggetto, elenco parametri

dropTable

Elimina tabella dati

1
DbConnection.dropTable(Object opts) async;

Parametri di chiamata:

  • opts: Oggetto, elenco parametri

createIndex

Crea l'indice della tabella dati

1
DbConnection.createIndex(Object opts) async;

Parametri di chiamata:

  • opts: Oggetto, elenco parametri

dropIndex

Elimina l'indice della tabella dati

1
DbConnection.dropIndex(Object opts) async;

Parametri di chiamata:

  • opts: Oggetto, elenco parametri

insert

Inserisci nuovo record

1
Number DbConnection.insert(Object opts) async;

Parametri di chiamata:

  • opts: Oggetto, elenco parametri

Risultati restituiti:

  • Number, restituisce l'id contenente l'inserimento, oppure 0 se il motore non lo supporta.

find

Interrogare i dati in base a condizioni specificate

1
NArray DbConnection.find(Object opts) async;

Parametri di chiamata:

  • opts: Oggetto, elenco parametri

Risultati restituiti:

  • NArray, restituisce i record contenenti i risultati

count

Contare il numero di record di dati in base alle condizioni specificate

1
Integer DbConnection.count(Object opts) async;

Parametri di chiamata:

  • opts: Oggetto, elenco parametri

Risultati restituiti:

  • Integer, restituisce il numero di record contenenti il ​​risultato

update

Aggiorna i dati in base alle condizioni specificate

1
Integer DbConnection.update(Object opts) async;

Parametri di chiamata:

  • opts: Oggetto, elenco parametri

Risultati restituiti:

  • Integer, restituisce il numero di record contenenti aggiornamenti

remove

Elimina i dati in base alle condizioni specificate

1
Integer DbConnection.remove(Object opts) async;

Parametri di chiamata:

  • opts: Oggetto, elenco parametri facoltativi

Risultati restituiti:

  • Integer, restituisce il numero di record contenenti aggiornamenti

format

Formatta un comando SQL e restituisce il risultato formattato

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

Parametri di chiamata:

  • method: String, specifica il metodo richiesto
  • opts: Oggetto, elenco parametri facoltativi

Risultati restituiti:

  • String, restituisce il comando sql formattato

Formatta un comando SQL e restituisce il risultato formattato

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

Parametri di chiamata:

  • sql: Stringa, stringa di formato, parametri opzionali vengono specificati con ?. Ad esempio: "SELECT FROM TEST WHERE [id]=?"
  • args: ..., elenco parametri opzionale

Risultati restituiti:

  • String, restituisce il comando sql formattato

toString

Restituisce la rappresentazione in formato stringa dell'oggetto. Generalmente viene restituito "[Oggetto nativo]". L'oggetto può essere reimplementato in base alle proprie caratteristiche.

1
String DbConnection.toString();

Risultati restituiti:

  • String, restituisce la rappresentazione di stringa dell'oggetto

toJSON

Restituisce una rappresentazione in formato JSON dell'oggetto, generalmente restituendo una raccolta di proprietà leggibili definite dall'oggetto.

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

Parametri di chiamata:

  • key: Stringa, non utilizzata

Risultati restituiti:

  • Value, restituisce un valore contenente JSON serializzabile