ObjectDbConnection

DBConnection est la classe de base de connexion à une base de données et est utilisée pour établir et maintenir une session de connexion à une base de données. Il implémente les opérations de base de connexion et sert de base aux classes dérivées. Il prend également en charge des opérations telles que le démarrage d'une transaction, la validation d'une transaction et l'annulation d'une transaction.

Les sous-classes de DBConnection incluent :Odbc,MySQL,SQLite, en instanciant chaque sous-classe, nous pouvons facilement accéder à différents types de bases de données.

DBConnection ne peut pas être créé directement, uniquement viadb.openCréé par d'autres méthodes, par exemple :

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

relation d'héritage

propriétés des membres

type

Chaîne, interroge le type de base de données de connexion actuel

1
readonly String DbConnection.type;

fonction membre

close

Fermer la connexion actuelle à la base de données

1
DbConnection.close() async;

---

use

Sélectionnez la base de données par défaut pour la connexion à la base de données actuelle

1
DbConnection.use(String dbName) async;

Paramètres d'appel :

• dbName : String, spécifiez le nom de la base de données

---

begin

Démarrer une transaction sur la connexion actuelle à la base de données

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

Paramètres d'appel :

• point: String, précise le nom de la transaction, non spécifié par défaut

---

commit

Valider la transaction sur la connexion actuelle à la base de données

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

Paramètres d'appel :

• point: String, précise le nom de la transaction, non spécifié par défaut

---

rollback

Annuler une transaction sur la connexion actuelle à la base de données

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

Paramètres d'appel :

• point: String, précise le nom de la transaction, non spécifié par défaut

---

trans

Entrez une transaction pour exécuter une fonction et validez ou annulez en fonction de l'exécution de la fonction.

1
Boolean DbConnection.trans(Function func);

Paramètres d'appel :

• func: Fonction, une fonction exécutée de manière transactionnelle

Résultats de retour :

• Boolean, renvoie si la transaction est validée, renvoie true pour une validation normale, renvoie false pour une restauration et renvoie une erreur si la transaction tourne mal.

Il y a trois résultats de l’exécution de func :

• La fonction revient normalement, y compris la fin de l'opération et le retour actif, moment auquel la transaction sera automatiquement validée.
• La fonction renvoie false et la transaction sera annulée
• Erreur de fonctionnement de la fonction, transaction automatiquement annulée

---

Entrez une transaction pour exécuter une fonction et validez ou annulez en fonction de l'exécution de la fonction.

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

Paramètres d'appel :

• point: String, précise le nom de la transaction
• func: Fonction, une fonction exécutée de manière transactionnelle

Résultats de retour :

• Boolean, renvoie si la transaction est validée, renvoie true pour une validation normale, renvoie false pour une restauration et renvoie une erreur si la transaction tourne mal.

Il y a trois résultats de l’exécution de func :

• La fonction revient normalement, y compris la fin de l'opération et le retour actif, moment auquel la transaction sera automatiquement validée.
• La fonction renvoie false et la transaction sera annulée
• Erreur de fonctionnement de la fonction, transaction automatiquement annulée

---

execute

Exécuter une commande SQL et renvoyer le résultat de l'exécution

1
NArray DbConnection.execute(String sql) async;

Paramètres d'appel :

• sql: Chaîne, chaîne

Résultats de retour :

• NArray, renvoie un tableau contenant les enregistrements de résultats. Si la requête est UPDATE ou INSERT, le résultat renvoyé inclura également affecté et insertId. mssql ne prend pas en charge insertId.

---

Exécutez une commande sql et renvoyez le résultat de l'exécution. La chaîne peut être formatée en fonction des paramètres.

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

Paramètres d'appel :

• sql: La chaîne, la chaîne de format et les paramètres facultatifs sont spécifiés avec ?. Par exemple : « SELECT FROM TEST WHERE [id]=? »
• args: ..., liste de paramètres optionnels

Résultats de retour :

• NArray, renvoie un tableau contenant les enregistrements de résultats. Si la requête est UPDATE ou INSERT, le résultat renvoyé inclura également affecté et insertId. mssql ne prend pas en charge insertId.

---

createTable

Créer un tableau de données

1
DbConnection.createTable(Object opts) async;

Paramètres d'appel :

• opts: Objet, liste de paramètres

---

dropTable

Supprimer le tableau de données

1
DbConnection.dropTable(Object opts) async;

Paramètres d'appel :

• opts: Objet, liste de paramètres

---

createIndex

Créer un index de table de données

1
DbConnection.createIndex(Object opts) async;

Paramètres d'appel :

• opts: Objet, liste de paramètres

---

dropIndex

Supprimer l'index de la table de données

1
DbConnection.dropIndex(Object opts) async;

Paramètres d'appel :

• opts: Objet, liste de paramètres

---

insert

Insérer un nouvel enregistrement

1
Number DbConnection.insert(Object opts) async;

Paramètres d'appel :

• opts: Objet, liste de paramètres

Résultats de retour :

• Number, renvoie l'identifiant contenant l'insertion, ou 0 si le moteur ne le prend pas en charge.

---

find

Interroger des données en fonction de conditions spécifiées

1
NArray DbConnection.find(Object opts) async;

Paramètres d'appel :

• opts: Objet, liste de paramètres

Résultats de retour :

• NArray, renvoie les enregistrements contenant les résultats

---

count

Compter le nombre d'enregistrements de données en fonction de conditions spécifiées

1
Integer DbConnection.count(Object opts) async;

Paramètres d'appel :

• opts: Objet, liste de paramètres

Résultats de retour :

• Integer, renvoie le nombre d'enregistrements contenant le résultat

---

update

Mettre à jour les données en fonction de conditions spécifiées

1
Integer DbConnection.update(Object opts) async;

Paramètres d'appel :

• opts: Objet, liste de paramètres

Résultats de retour :

• Integer, renvoie le nombre d'enregistrements contenant des mises à jour

---

remove

Supprimer les données en fonction de conditions spécifiées

1
Integer DbConnection.remove(Object opts) async;

Paramètres d'appel :

• opts: Objet, liste de paramètres facultatifs

Résultats de retour :

• Integer, renvoie le nombre d'enregistrements contenant des mises à jour

---

format

Formatez une commande SQL et renvoyez le résultat formaté

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

Paramètres d'appel :

• method: String, spécifie la méthode demandée
• opts: Objet, liste de paramètres facultatifs

Résultats de retour :

• String, renvoie la commande SQL formatée

---

Formatez une commande SQL et renvoyez le résultat formaté

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

Paramètres d'appel :

• sql: La chaîne, la chaîne de format et les paramètres facultatifs sont spécifiés avec ?. Par exemple : « SELECT FROM TEST WHERE [id]=? »
• args: ..., liste de paramètres optionnels

Résultats de retour :

• String, renvoie la commande SQL formatée

---

toString

Renvoie la représentation sous forme de chaîne de l'objet. Généralement, "[Native Object]" est renvoyé. L'objet peut être réimplémenté en fonction de ses propres caractéristiques.

1
String DbConnection.toString();

Résultats de retour :

• String, renvoie la représentation sous forme de chaîne de l'objet

---

toJSON

Renvoie une représentation au format JSON de l'objet, renvoyant généralement une collection de propriétés lisibles définies par l'objet.

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

Paramètres d'appel :

• key: Chaîne, non utilisée

Résultats de retour :

• Value, renvoie une valeur contenant du JSON sérialisable