Objet objet intégré

Objet DbConnection

L'objet de connexion à la base de données est utilisé pour établir et maintenir une session de connexion à la base de données.

Héritage

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<this>DbConnection|type|close();use();begin();commit();rollback();trans();execute();createTable();dropTable();createIndex();dropIndex();insert();find();count();update();remove();format()] [<class>MySQL] [<class>Odbc] [<class>SQLite] [object] <:- [DbConnection] [DbConnection] <:- [MySQL] [DbConnection] <:- [Odbc] [DbConnection] <:- [SQLite] DbConnection type close() use() begin() commit() rollback() trans() execute() createTable() dropTable() createIndex() dropIndex() insert() find() count() update() remove() format() object toString() toJSON() MySQL Odbc SQLite

Attributs 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 à la base de données actuelle

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 à la base de données actuelle

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

Paramètres d'appel :

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

commit

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

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

Paramètres d'appel :

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

rollback

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

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

Paramètres d'appel :

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

trans

Saisissez une transaction pour exécuter une fonction et soumettez 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ésultat de retour :

  • Boolean, Renvoie si la transaction est validée, true pour une validation normale, false pour une annulation et une erreur est renvoyée s'il y a une erreur dans la transaction

L'exécution de func a trois résultats :

  • La fonction retourne normalement, y compris la fin de l'opération et le retour actif, auquel moment la transaction sera automatiquement validée
  • La fonction renvoie false, à ce moment la transaction sera annulée
  • La fonction ne s'exécute pas correctement, la transaction est automatiquement annulée

Saisissez une transaction pour exécuter une fonction et soumettez 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, spécifiez le nom de la transaction
  • func: Fonction, une fonction exécutée de manière transactionnelle

Résultat de retour :

  • Boolean, Renvoie si la transaction est validée, true pour une validation normale, false pour une annulation et une erreur est renvoyée s'il y a une erreur dans la transaction

L'exécution de func a trois résultats :

  • La fonction retourne normalement, y compris la fin de l'opération et le retour actif, auquel moment la transaction sera automatiquement validée
  • La fonction renvoie false, à ce moment la transaction sera annulée
  • La fonction ne s'exécute pas correctement, la transaction est 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ésultat de retour :

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

Exécuter une commande sql et renvoyer le résultat de l'exécution, peut formater la chaîne en fonction des paramètres

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

Paramètres d'appel :

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

Résultat de retour :

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

createTable

Créer une table 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ésultat de retour :

  • Number, Retourne l'id contenant l'insert, ou 0 si le moteur ne le supporte pas

find

Interroger les données selon des conditions spécifiées

1
NArray DbConnection.find(Object opts) async;

Paramètres d'appel :

  • opts: Objet, liste de paramètres

Résultat de retour :

  • NArray, Renvoie l'enregistrement contenant le résultat

count

Compter le nombre d'enregistrements de données selon les conditions spécifiées

1
Integer DbConnection.count(Object opts) async;

Paramètres d'appel :

  • opts: Objet, liste de paramètres

Résultat de retour :

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

update

Mettre à jour les données selon les conditions spécifiées

1
Integer DbConnection.update(Object opts) async;

Paramètres d'appel :

  • opts: Objet, liste de paramètres

Résultat de retour :

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

remove

Supprimer les données selon les conditions spécifiées

1
Integer DbConnection.remove(Object opts) async;

Paramètres d'appel :

  • opts: Objet, liste de paramètres optionnels

Résultat de retour :

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

format

Formater une commande sql et renvoyer le résultat formaté

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

Paramètres d'appel :

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

Résultat de retour :

  • String, Renvoie la commande sql formatée

Formater une commande sql et renvoyer le résultat formaté

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

Paramètres d'appel :

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

Résultat de retour :

  • String, Renvoie la commande sql formatée

toString

Renvoie la représentation sous forme de chaîne de l'objet, renvoie généralement "[Objet natif]", l'objet peut être ré-implémenté selon ses propres caractéristiques

1
String DbConnection.toString();

Résultat de retour :

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

toJSON

Renvoie la représentation au format JSON de l'objet, renvoie généralement une collection d'attributs lisibles définis par l'objet

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

Paramètres d'appel :

  • key: chaîne, inutilisé

Résultat de retour :

  • Value, Renvoie une valeur contenant JSON sérialisable