Permet de récupérer les enregistrements
d'une base de données ou d'ajouter, de mettre à jour ou de
supprimer des enregistrements.
A l'aide de RecordIOManager, vous pouvez effectuer les opérations suivantes :
- Ouvrir et fermer un fichier base de données.
- Accéder de manière séquentielle aux enregistrements d'un fichier physique ou logique IBM® i (par numéro d'enregistrement ou par clé). Si vous spécifiez un accès séquentiel au fichier à l'ouverture de celui-ci, les enregistrements sont extraits de manière séquentielle et les méthodes qui nécessitent des paramètres de clé, tels que readAllRecordsEqual(String[]) ou readRecord(String[]), sont ignorées.
Remarque : RecordIOManager vous permet de manipuler les données d'un format d'enregistrement particulier d'un fichier de base de données (logique ou physique), via un accès de niveau d'enregistrement IBM i. Cependant,
vous ne pouvez pas mettre à jour un enregistrement ou le
supprimer dans un fichier logique ; seule
la récupération de données est autorisée.
- Joindre des fichiers base de données pour accéder à des fichiers joints.
Remarque : RecordIOManager utilise des
classes d'accès de niveau enregistrement IBM Toolbox, lesquelles ne prennent pas en charge les fichiers joints
logiques ni les zones clés indéfinies.
- Une instance d'objet RecordIOManager ne peut manipuler les données que d'un seul format
d'enregistrement d'un fichier de base de données. Si vous avez besoin d'accéder à plusieurs formats
d'enregistrements ou fichiers base de données, définissez
plusieurs instances de RecordIOManager ou joignez deux instances de RecordIOManager pour accéder uniquement aux enregistrements ayant des valeurs communes dans les clés externes.
Pour joindre deux fichiers base de données, utilisez la méthode joinDatabase(String[]
foreignKeys, RecordIOManager database). Les deux fichiers de base de données doivent avoir le type d'accès de fichier FILEACCESS_KEYED.
- Indiquer des conditions pour le filtrage des enregistrements sur toute zone.
- Ecrire des enregistrements séquentiels dans un fichier base de données.
- Mettre à jour ou supprimer des enregistrements dans un fichier base de données par numéro d'enregistrement. Vous pouvez utiliser différentes méthodes de lecture pour identifier les numéros d'enregistrement.
- Positionner le curseur d'un fichier à l'emplacement voulu.
RecordIOManager supporte les fonctionnalités de sécurité et de contrôle standard de gestion de base de données. Vous pouvez effectuer ce qui suit :
- Verrouiller un fichier base de données.
- Utiliser le contrôle de validation lors de l'accès à un fichier base de données.
- Valider ou annuler des transactions pour une connexion.
- Démarrer et arrêter un fichier journal physique ou logique.
- Définir des conditions de filtrage sur des enregistrements auxquels on peut accéder.
Si vous souhaitez filtrer des enregistrements dans une base de données, vous pouvez définir votre propre classe de condition. Cette classe de condition doit étendre la condition AbstractCondition et implémenter la méthode isConditionValid(com.ibm.as400.access.Record enregistrement), qui renvoie une valeur booléenne pour déterminer si l'enregistrement est accessible. Si
la valeur renvoyée est true, l'enregistrement est
accessible. Sinon, l'enregistrement sera ignoré.