Migration des applications AnyDAC vers FireDAC
Remonter à Migration vers FireDAC
Cette rubrique résume les modifications de refactoring effectuées lors de l'intégration de AnyDAC dans RAD Studio FireDAC. Elle décrit comment migrer une base de code AnyDAC existante vers FireDAC.
Sommaire
Modifications apportées à FireDAC par rapport à AnyDAC
Si vous êtes familier de la première incarnation de FireDAC (AnyDAC), des différences significatives sont intervenues :
- L'API a été renommée et contient de nouveaux noms d'unités et de nouveaux préfixes API.
- Les espaces de nommage hiérarchiques sont maintenant implémentés.
- Les anciens noms d'unités avaient la forme :
- uAD<Couche><Rôle>.pas
- Les nouveaux noms d'unités FireDAC ont généralement la forme :
- FireDAC.<Couche>.<Rôle>.pas
- Voici quelques exemples :
- uADCompClient -> FireDAC.Comp.Client
- uADStanOption -> FireDAC.Stan.Option
- uADPhysIB -> FireDAC.Phys.IB
- Les anciens noms d'unités avaient la forme :
- Les espaces de nommage hiérarchiques sont maintenant implémentés.
- Pour les composants FireDAC, le préfixe du nom a été changé de TADXxxx en TFDXxxx.
- Pour les fonctions globales, le préfixe du nom a été changé de ADXxx en FDXxx.
- Pour les classes d'exception, le nom a été changé de EADXxx en EFDXxx.
- Voici quelques exemples :
- TADTable -> TFDTable
- TADPhysSQLiteDriverLink -> TFDPhysSQLiteDriverLink
- ADManager() -> FDManager()
- Les packages d'exécution ont été renommés :
- FireDACCommon190, FireDACCommonDriver190, FireDACADSDriver190, FireDACASADriver190, FireDACDataSnapDriver190, FireDACDb2Driver190, FireDACDBXDriver190, FireDACIBDriver190, FireDACMSAccDriver190, FireDACMSSQLDriver190, FireDACMySQLDriver190, FireDACODBCDriver190, FireDACOracleDriver190, FireDACPgDriver190, FireDACSqliteDriver190, FireDAC190, fmxFireDAC190, vclFireDAC190
- Les fichiers de configuration ont été renommés de ADXxx.ini en FDXxx.ini et déplacés dans C:\Utilisateurs\Public\Documents\Embarcadero\Studio\22.0\FireDAC :
- La clé de registre de configuration de FireDAC a été déplacée dans HKCU\Software\Embarcadero\FireDAC.
- Les valeurs des clés pointent vers les fichiers de configuration de FireDAC :
- DriverFile vers FDDrivers.ini
- ConnectionDefFile vers FDConnectionDefs.ini
- La clé de registre de configuration de FireDAC a été déplacée dans HKCU\Software\Embarcadero\FireDAC.
- Les exemples FireDAC sont disponibles dans <RAD Studio Samples>\Delphi\Database\FireDAC.
- Pour de plus amples informations sur les exemples/démos, voir Descriptions des exemples.
- Le support a été retiré pour les outils utilisés avec les releases de RAD Studio antérieures à XE5.
Aide en ligne de FireDAC
- Rubriques : FireDAC
- Bibliothèques : Liste des unités FireDAC
Migration de AnyDAC vers FireDAC
Pour simplifier et automatiser la migration de vos applications de l'ancienne vers la nouvelle API FireDAC, nous fournissons :
- L'utilitaire <RAD Studio>\Bin\reFind
- Pour plus d'informations, voir reFind.exe, l'utilitaire Rechercher et Remplacer utilisant les expressions Perl RegEx.
- Un exemple de migration, situé dans <RAD Studio Demos>\Delphi\Database\FireDAC\Tool\reFindDemo
L'utilitaire de ligne de commande reFind, qui utilise les expressions régulières compatibles Perl (PCRE) pour renommer des entités dans les fichiers.
Suivez ces étapes pour migrer une application AnyDAC vers FireDAC :
- Effectuez une copie de sauvegarde de votre application.
- Ouvrez la fenêtre en ligne de commande MS Windows.
- Accédez au dossier racine des sources de votre projet.
- Pour les unités et les membres, exécutez les deux commandes suivantes :
<RAD Studio>\Bin\reFind *.pas *.dpk *.dpr *.dproj *.inc /S /Y /I /W /B:0 /X:<RAD Studio Demos>\Delphi\Database\FireDAC\Tool\reFind\AD2FDMigration\FireDAC_Rename_Units.txt
<RAD Studio>\Bin\reFind *.pas *.dfm *.dpk *.dpr *.inc /S /Y /I /B:0 /X:<RAD Studio Demos>\Delphi\Database\FireDAC\Tool\reFind\AD2FDMigration\FireDAC_Rename_API.txt
- Si votre application est construite avec des packages d'exécution, renommez les références aux packages conformément aux noms de packages donnés ci-dessus.
- Si votre application utilise des fichiers de configuration de pilotes et/ou des fichiers de définition de connexion persistante, renommez les fichiers conformément aux noms de fichiers donnés ci-dessus.
- Vérifiez les modifications effectuées par reFind.
- Remarques :
- Cette approche ne garantit pas une migration automatique et réussie à 100%, car elle est basée sur des règles et il n'existe pas de correspondance de noms absolument exacte.
- Nous vous suggérons de commencer à créer une copie de sauvegarde de tous vos projets. Vous pouvez également utiliser reFind pour créer des copies de sauvegarde des fichiers modifiés.