...

L'organisation de fichiers décrite dans cette partie est celle de la vue administrateur, le développeur (sous Eclipse) trouvera les fichiers dans ces projets Eclipse.

/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 :

/src/main/resources/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.

/src/main/resources/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.

/src/main/resources/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.

/src/main/resources/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.

/src/main/resources/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.

/src/main/resources/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.

/src/main/resources/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.

/src/main/resources/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.

/

...

Le fichier commons-render-kit.xml définit les classes de rendu de la taglib de esup-commons.Le fichier fck-faces-config.xml définit l'interface de FckEditor pour JSF.

Le fichier application.xml définit la résolution de variables sous JSF ainsi que les langues disponibles.

Le fichier navigation-rules.xml définit les règles de navigation entre les pages de l'application.

src/main/resources/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.

/src/main/resources/properties/

...

log4j.properties : les traces de l'application

Le fichier log4j-example.properties configure log4j (la bibliothèque utilisée pour les traces) en mode web (lancement par la tâche ant start). Le fichier log4j-batch-example.properties est utilisé en mode batch, depuis une autre tâche ant. Ils doivent être copiés respectivement en lo4j.properties et log4j-batch.properties.

...

/src/main/resources/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.

/

...

Le fichier de configuration Spring portal-example.xml définit le bean portalService, qui indique à l'application comment récupérer les informations du portail (groupes, attributs utilisateur, ...). Il doit être copié en portal.xml.

src/main/resources/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.

/src/main/resources/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.

/src/

...

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.

main/resources/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.

Le fichier de configuration Spring converters.xml définit les convertisseurs de l'application, qui convertissent des objets en chaînes (vice-versa) lors des interactions utilisateur.

****************************************

/webapp : l'application web et les bibliothèques

...

On trouvera dans ce répertoire tous les fichiers délivrés de manière statique par l'application web aux clients clients :

• Les images,
• Les feuilles de style (*.css),
• Les scripts Javascript
• ...

...

Le fichier /webapp/META-INF/MANIFEST.MF est produit automatiquement par la tâche ant _dist.

/webapp/stylesheets stylesheets : les pages JSF

Toutes les pages JSF doivent être situées à cet endroit pour pouvoir être protégées d'un accès direct de manière globale.

/webapp/WEB-INF INF : la configuration de l'application web

...

Les fichiers esup-commons.tld et fck-faces.tld sont les fichiers de définition des taglibs de esup-commons et FckEditor.

/webapp/WEB-INF/lib lib : les bibliothèques de l'application

Même les applications en mode batch seulement doivent utiliser /webapp/WEB-INF/lib pour déposer leurs bibliothèques, même si dans ce cas le nommage n'est pas très approprié.

/website website : la construction du site web

...