Classe NTiConnection

Description

La classe NTiConnection représente la connexion à l'IBM i et implémente la classe DbConnection du modèle ADO.NET (espace de noms System.Data.Common).

Considérations générales

Pool de connexion

À partir de la version 3.2.3, NTi implémente un pool de connexion basé sur .NET, assurant un suivi rigoureux des connexions ouvertes et évitant la création excessive de jobs QZDASOINIT.

L’ouverture d’une connexion à l’IBM i entraîne plusieurs opérations coûteuses : résolution de l’IP, négociation TCP, authentification, création d’un job sur IBM i. Répéter ces opérations à chaque requête impacte significativement les performances.

Le pooling NTi fonctionne ainsi :

• Lorsqu'une connexion est demandée, NTi cherche d'abord une connexion disponible dans le pool. Si une connexion est disponible, elle est réutilisée immédiatement, sinon une nouvelle connexion est créée et ajoutée au pool.
• Lorsque la connexion n’est plus utilisée, elle est remise dans le pool au lieu d’être fermée.
• Quand l’application s’arrête ou que le pool est détruit, toutes les connexions sont correctement fermées.

Le pooling est activé par défaut à partir de NTi 3.2.3. Il peut être désactivé si un contrôle manuel des connexions est requis.

💡 Bénéfices observés : réduction du temps de réponse de 80ms à 6ms, soit un gain de plus de 10x dans certains cas d’usage (notamment avec Entity Framework Core).

Une instance = une connexion TCP = un travail IBM i

Chaque instance de NTiConnection porte une instance de socket TCP pour se connecter à l'IBM i. Ainsi il y a un lien fort entre l'instance, la connexion et le job IBM i.

Lorsqu'une instance de NTiConnection est détruite explicitement via le Garbage Collector de .NET, la connexion TCP sous-jacente est instantanément fermée et détruite à son tour, entraînant l'arrêt du job IBM i. Ce mécanisme garantit la maîtrise totale des connexions par l'utilisateur.

Chaîne de connexion

Comme la plupart des fournisseurs d'accès à une base de données, NTi utilise une chaîne de connexion pour obtenir les informations de connexion à un IBM i (nom d'utilisateur, mot de passe, etc...). Cette chaîne de connexion peut contenir des informations sensibles. Il existe de nombreuses méthodes pour sécuriser la gestion de la chaîne de connexion et des fichiers de configuration.

Référez-vous aux documentations et recommandations officielles de .NET pour leur mise en œuvre.

Implémentation ADO.NET

Cette classe implémente les méthodes et propriétés usuelles du modèle ADO.NET pour réaliser les opérations d'accès à la base de données, dont notamment:

• Open()
• Close()
• CreateCommand()
• BeginTransaction()
• Commit()
• Rollback()

Ainsi, NTi s'intègre dans n'importe quelle application existante développée avec d'autres fournisseurs tels que les pilotes ODBC ou OleDB.

💡 Retrouvez la documentation de cette implémentation par défaut sur toute documentation ADO.NET, par exemple via la documentation de l'espace de noms System.Data.Common.

Méthodes

La classe NTiConnection implémente en plus des fonctionnalités du modèle ADO.NET des méthodes spécifiques à l'utilisation de l'IBM i pour notamment exécuter des commandes CL et appeler des programmes RPG, CL...

Ces méthodes spécifiques sont:

Propriétés

Les propriétés spécifique de la classe NTiConnection permettent de définir les propriétés de connexion et accéder aux informations relatives à l'état de la connexion à l'IBM i. Par souci de compatibilité avec les chaînes de connexion des autres fournisseurs, certaines propriétés peuvent correspondre à plusieurs mot-clés différents.