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é.