Fichiers de configuration

Configuration par défaut ou configuration locale

Durant le développement d'un projet Lutèce, vous serez amené à manipuler deux types de fichiers de configuration :

  • les fichiers de configuration par défaut : ce sont des fichiers d'exemple, qui seront intégrés dans les artefacts Lutèce. Ils ne doivent contenir aucune valeur spécifique à votre environnement.

    L'accès par défaut à ces fichiers est src/conf/default .

  • les fichiers de configuration locale : ces fichiers sont utilisés pour votre application web de test, ils contiennent les valeurs spécifiques à votre environnement de développement. Ces fichiers ne doivent pas être utilisés en dehors de votre environnement, et ne sont donc pas inclus dans les artefacts Lutèce.

    L'accès par défaut à ces fichiers est ${user.home}/lutece/conf/${project.artifactId} .

    Astuce - Si vous n'êtes pas sûr de localiser ce répertoire, le chemin absolu est affiché quand vous lancez Maven :

    [INFO] Local configuration directory is D:\Documents and Settings\YOUR_NAME\lutece\conf\plugin-links

Structure des répertoires

Les deux répertoires doivent avoir une structure similaire à celle de l'application web.

Par exemple, src/conf/default/WEB-INF/conf/db.properties sera copié dans le répertoire de l'application web WEB-INF/conf .

Précisions

Comme indiqué précédemment, les fichiers de configuration ne sont pas utilisés de la même manière entre le mode development et le packaging. Les tableaux suivants décrivent, pour chaques types de projet, quand et comment chaque configuration est utilisée :

  • lutece-core :
    Goal Défault configuration Local configuration
    lutece:inplace Copié vers la webapp de test Copié vers la webapp de test
    package Inclu dans l'artefact Ignoré
  • lutece-plugin :
    Goal Configuration par défault Configuration locale
    lutece:exploded Copié vers la webapp de test Copié vers la webapp de test
    package Inclu dans l'artefact Ignoré
  • lutece-site : Un projet de site est destiné à un site de production spécifique. Par conséquent, les fichiers de configuration ne sont pas génériques et, en tant que tel, sont placés directement dans le répertoire webapp ; Il n'y a pas de répertoire src/conf/default .

    Le méchanisme de configuration locale est conservé pour tester le site sur une machine locale.

    Goal Configuration par défault Configuration locale
    lutece:exploded Non applicable Copié vers la webapp de test
    package Non applicable Ignoré

Note : A chaques fois que les deux configurations sont copiées, la configuration par défaut est copiée en premier puis est recouverte par la configuration locale, par conséquent, les fichiers locaux ont la priorité.