...
Du point de vue de l'exploitant, une application est composée d'une hiérarchie unique de fichiers, issue de la décompression d'une archive WAR.
L'organisation de fichiers décrite dans cette partie est celle de la vue développeur.
...
| Sommaire |
|---|
| Remarque |
|---|
Nous allons dans un premier temps décrire les chemins spécifiques à chaque type d'utilisateurs, puis nous décrirons les arborescence communes. Les arborescences communes sont présentées avec des chemins relatifs. Les chemins sont a adapter en fonction du contexte de l'utilisateur : exploitant ou développeur. |
Arborescence développeur
Arborescence exploitant
/docs : la documentation
Toute la documentation du projet est située dans le répertoire /docs, le sous-répertoire /docs/api contient le Javadoc généré.
/src :
...
properties : les fichiers de configuration
Les fichiers de configuration sont en général fournis sous forme de fichiers d'exemple (xxx-example.xml).
...
Le fichier applicationContext.xml importe tous les fichiers de configuration Spring. Il peut également être utilisé pour définir des beans.
...
properties/auth : l'authentification
Le fichier de configuration Spring auth-example.xml définit le bean authenticationService, qui sert à l'application à récupérer l'identifiant de l'utilisateur connecté. Il doit être copié en auth.xml.
...
properties/cache : le cache
Le fichier de configuration Spring cache-example.xml définit le bean cacheManager, qui sert à l'application à s'appuyer sur un gestionnaire de cache. Il doit être copié en cache.xml.
Le fichier de configuration EhCache ehcache-example.xml définit la configuration de la bibliothèque EhCache.
...
properties/dao : l'accès aux données
Le fichier de configuration Spring dao-example.xml définit la manière dont l'application récupère les données de la base de données, par exemple avec Hibernate.
Il doit être copié en dao.xml.
Le fichier de configuration Hibernate hibernate/hibernate.cfg-example.xml définit la manière dont Hibernate se connecte à la base de données. Il doit être copié en hibernate.cfg.xml. Il est référencé par le bean abstractHibernateSessionFactory de dao.xml.
Les fichiers de configuration Hibernate hibernate/mapping/.hbm* décrivent le mappingentre les classes Java et les tables de la base de données. Ils sont également référencés par le bean abstractHibernateSessionFactory de dao.xml. Il n'est en général pas nécessaire pour les administrateurs de modifier ces fichiers, ils ne sont pas fournis sous forme d'exemples.
...
properties/deepLinking : la gestion des liens
Le fichier de configuration Spring deepLinking-example.xml définit le bean deepLinkingRedirector, qui indique comment l'application gère les liens (hypertextes) directs. Il doit être copié en deepLinking.xml.
Le fichier de configuration Spring urlGeneration-example.xml définit le bean urlGenerator, qui génère les liens hypertextes vers l'application (avec prise en compte de l'authentification, des paramètres de liens directs, ...). Il doit être copié en urlGeneration.xml.
...
properties/exceptionHandling : la gestion des exceptions
Le fichier de configuration Spring exceptionHandling-example.xml définit le bean exceptionServiceFactory, qui indique comment l'application gère les exceptions. Il doit être copié en exceptionHandling.xml.
...
properties/i18n : la gestion de l'internationalisation
Le fichier de configuration Spring i18n-example.xml définit le bean i18nService, qui indique comment l'application récupère les chaînes de caractères utilisés dans l'application. Il doit être copié en i18n.xml. Les fichiers bundles/_.properties contiennent les chaînes de caractères proprement dites.
...
properties/init : l'initialisation et la mise à jour
Le fichier de configuration Spring init-example.xml définit le bean versionningService, qui indique la manière dont est initialisée la base de données. On y trouvera par exemple l'uid du premier administrateur de l'application qui sera créé automatiquement en même temps que la base de données. Il doit être copié en init.xml.
...
properties/ldap : l'accès à l'annuaire LDAP
Le fichier de configuration Spring ldap-example.xml définit le bean ldapService, qui indique comment sont faits les accès à l'annuaire LDAP. Il doit être copié en ldap.xml.
...
properties/log4j.properties : les traces de l'application
Le fichier log4j-example.properties configure log4j (la bibliothèque utilisée pour les traces).
...
properties/misc : des choses qu'on a pas su mettre autre part 
Le fichier de configuration Spring application.xml définit le bean applicationService, qui indique à l'application son numéro de version, copyright, ... Ce fichier n'est pas fourni sous forme d'exemple, il ne doit normalement pas être modifié par les exploitants.
Le fichier de configuration Spring abstractBeans.xml définit des beansabstraits utilisés par héritage (notamment dans * /src/main/resources/properties/web/controllers.xml*). Ce fichier n'est pas fourni sous forme d'exemple, il ne doit normalement pas être modifié par les exploitants.
...
properties/smtp : l'envoi de courriers électroniques
Le fichier de configuration Spring smtp-example.xml définit le bean smtpService, qui indique à l'application comment envoyer les courriers électroniques. Il doit être copié en smtp.xml.
...
properties/tags : le rendu des tags esup-commons
Le fichier de configuration Spring tags-example.xml définit le bean tagsConfigurator, qui configure dynamiquement les balises de la taglib esup-commons. Il doit être copié en tags.xml.
...
properties/web : l'interface utilisateur
Le fichier de configuration Spring controlers.xml définit les contrôleurs de l'application, qui réagissent aux actions de l'utilisateur.
...
/webapp : l'application web et les bibliothèques
...
media : les fichiers statiques
On trouvera dans ce répertoire tous les fichiers délivrés de manière statique par l'application web aux clients :
...