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