Configurer l'application
À propos de la configuration
Il y a des moments où vous devez éviter de coder en dur une valeur dans l'application, car vous devez la modifier sans avoir à reconstruire le binaire de l'application. Par exemple, vous devez pouvoir stocker les informations d'identification de la base de données dans la configuration plutôt que de les coder en dur, afin de pouvoir les modifier facilement.
Le Fano Framework fournit l'interface IAppConfiguration à cet effet.
IAppConfiguration
L'interface IAppConfiguration fournit plusieurs méthodes :
| Méthodes | Description |
|---|---|
| getString() | Accepte le nom et renvoie la valeur de la chaîne de caractères. |
| getInt() | Accepte le nom renvoie une valeur entière. |
| getBool() | Accepte le nom renvoie une valeur booléenne. |
| getFloat() | Accepte le nom renvoie une valeur double. |
| has() | Tester si le nom existe dans la configuration. |
Implémentation IAppConfiguration intégrée
Le Fano Framework fournit les classes TJsonFileConfig, TIniFileConfig, TEnvConfig chargeant les données de configuration à partir de JSON, du fichier INI et des variables d'environnement respectivement.
Le Fano Framework fournit également les classes TCompositeConfig et TNullConfig. La première est une implémentation IAppConfiguration avec la capacité de combiner deux instances IAppConfiguration et la seconde est une classe nulle qui implémente l'interface IAppConfiguration.
Charger la configuration à partir de JSON
Charger la configuration depuis INI
Le dernier paramètre est le nom de la section par défaut à utiliser.
Charger la configuration à partir des variables d'environnement
Combinez plusieurs configurations en une seule
TCompositeConfig vous permet d'utiliser plusieurs configurations. Dans la configuration suivante, si la configuration n'est pas trouvée dans les variables d'environnement, il essaiera de la trouver dans config.json.
Enregistrer l'instance de configuration dans le conteneur de dépendances
Pour pouvoir utiliser les classes TJsonFileConfig, TIniFileConfig, TEnvConfig, TCompositeConfig et TNullConfig avec le conteneur de dépendances, Fano Framework fournit les classes TJsonFileConfigFactory, TIniFileConfigFactory, TEnvConfigFactory, TCompositeConfigFactory et TNullConfigFactory vous permettant d'enregistrer les classes ci-dessus dans le conteneur.
Enregistrer la configuration JSON
- container.add(
- 'config',
- TJsonFileConfigFactory.create(
- getCurrentDir() + '/config/config.json'
- )
- );
Enregistrer la configuration INI
- container.add(
- 'config',
- TIniFileConfigFactory.create(
- getCurrentDir() + '/config/config.ini'
- )
- );
Enregistrer la variable d'environnement de configuration
- container.add(
- 'config',
- TEnvConfigFactory.create()
- );
Enregistrer les configurations composites
- container.add(
- 'config',
- TCompositeConfigFactory.create(
- TNullConfigFactory.create(),
- TJsonFileConfigFactory.create(getCurrentDir() + '/config/config.json')
- )
- );
Récupérer l'instance de configuration à partir du conteneur de dépendances
Pour obtenir l'instance de configuration :
ou avec une syntaxe de type tableau :
Lire les données de configuration
Supposons que vous ayez un fichier JSON avec le contenu suivant :
- {
- "appName" : "MonApp",
-
- "baseUrl" : "http://monapp.fano",
-
- "session" : {
- "name" : "fano_sess",
- "dir" : "storages/sessions/"
- },
-
- "cookie" : {
- "domain" : "myapp.fano",
- "maxAge" : 3600
- }
- }
Pour obtenir la valeur baseUrl :
Pour obtenir la valeur dir :
Pour obtenir la valeur maxAge :
Les méthodes getString(), getInt(), getBool() et getFloat() acceptent le deuxième paramètre si vous souhaitez utiliser une valeur différente lorsque la clef n'existe pas.
- baseUrl:=config.getString('baseUrl', 'https://exemple.com');
Si la clef baseUrl n'est pas trouvée, elle renvoie la valeur du deuxième paramètre.
Configuration du fichier INI
TIniFileConfig est un enveloppe léger de TIniFile de Free Pascal. TIniFile ne peut pas lire les données d'un fichier INI n'ayant pas de section. Votre fichier INI doit contenir au moins une section servant de section par défaut. Le dernier paramètre du constructeur de TIniFileConfig attend le nom de la section par défaut. Si vous utilisez TIniFileConfigFactory, par défaut, il utilise Fano comme section par défaut si elle n'est pas spécifiée. Vous pouvez spécifier la section par défaut en appelant la méthode setDefaultSection() comme indiqué dans le code suivant :
- container.add(
- 'config',
- TIniFileConfigFactory.create(
- getCurrentDir() + '/config/config.ini'
- ).setDefaultSection('hello')
- );
Pensez à lire la configuration cookie.maxAge dans l'exemple de code ci-dessus. Il lira maxAge à partir de la section cookie.
|
[cookie] maxAge=3600 |
Cependant, comme les sections imbriquées ne sont pas autorisées dans le fichier INI, vous ne pouvez en lire qu'une seule. Par exemple :
- nestedData:=config.getInt('fano.data.nested');
lira les données de :
|
[fano] data.nested=test |
Configuration de l'application avec Fano CLI
Lors de la création d'un nouveau projet, vous pouvez utiliser le paramètre --config pour configurer la configuration de l'application.
Vous pouvez également définir manuellement la configuration de l'application en remplaçant la méthode buildAppConfig() de la classe TBasicAppServiceProvider ou TDaemonAppServiceProvider comme indiqué dans l'exemple de code suivant :
- TAppServiceProvider=Class(TDaemonAppServiceProvider)
- Protected
- function buildAppConfig(
- Const container:IDependencyContainer
- ):IAppConfiguration; Override;
- ...
- End;
-
- ...
-
- Function TAppServiceProvider.buildAppConfig(
- Const Container:IDependencyContainer
- ):IAppConfiguration;
- Begin
- container.add(
- 'config',
- TIniFileConfigFactory.create(
- getCurrentDir() + '/config/config.ini'
- )
- );
- Result:=container['config'] as IAppConfiguration;
- End;