• Introduction
• Présentation générale de Lutece
• Description d'une webapp Lutece
• Description fonctionnelle des composants
• Description de l'architecture logicielle
• Description de la composition des plugins
• Généralités concernant le développement sur Lutece
• Construction et assemblage : les builds
• Règles de codage
• Règles de nommage et vérification
• Règles de documentation
• Gestion des faits techniques
• Gestion des sources sur GitHub
• Socle technique et principaux frameworks
• Le moteur de templates : Freemarker
• Le framework CSS responsive : Bootstrap
• L'injection de dépendances avec Spring
• Le framework MVC de Lutece
• La validation des formulaires
• L'internationalisation (i18n)
• L'écriture de logs
• Les tests unitaires
• Installation et configuration
• Installation de l'environnement de travail
• Test de construction et de déploiement d'un premier plugin
• Configuration Lutece avancée
• Initialisation de la base de données
• Guides de développement de composants
• Développer le squelette du plugin avec PluginWizard
• Créer une application Front Office (XPage)
• Créer ma première application Front Office : Mon plugin HelloWorld
• Créer un Portlet Front Office
• Créer un bloc dynamique de Page (PageInclude)
• Créer un service de fourniture de contenu (ContentService)
• Définir des filtres et servlets de plugin
• Créer une fonctionnalité Back Office (AdminFeature)
• Créer un bloc pour le tableau de bord Back-Office (DashboardComponent)
• Créer un service d'extension de l'éditeur de texte riche (HtmlService ou LinkService)
• Créer un traitement d'arrière-plan (Daemon)
• Créer une tâche de workflow
• Développements avancés
• L'authentification Front Office (MyLutece)
• Créer des Web Services REST
• Gérer et développer des services de caches
• Intégrer le moteur de workflow à un plugin
• Ajouter des extensions à des contenus (commentaires, notes, vues...)
• Conclusion

L'écriture de logs

Les logs standards de Lutece

Lutece dispose de plusieurs fichiers de logs :

• application.log contient les principaux événements de l'application : chargement des services, des plugins, etc

• error.log contient tous les faits anormaux.

Gestion des exceptions

Toute exception doit être consignée dans un fichier log.

Les blocs catch ne doivent jamais être vides ou faire appel à  e.printStackTrace()

Exceptions non critiques

Les exceptions ne nécessitant pas l'arrêt du traitement en cours doivent être loguées de la manière suivante

catch( Exception e )
{
     AppLogService.error( e.getMessage() , e );
}

Exceptions critiques

Les exceptions nécessitant l'arrêt du traitement (exemples : erreur SQL, problème d'accès fichier, ...) doivent lever une exception dérivée de  LuteceException ( PhysicalException ,  ClientException ...). La classe  LuteceException réalise elle-même l'écriture dans les logs. Le traitement du bloc catch sera alors réalisé de la manière suivante :

catch( Exception e )
{
     throw new AppException( e.getMessage() , e );
}

Exceptions applicatives

Les exceptions applicatives, telles que  UserActionException , sont les seules qui ne nécessitent pas d'être loguées car elles correspondent à un cas normal d'exécution de l'application.

Loggers spécifiques

Certaines applications ou certains services peuvent avoir recours à un logger spécifique. Cette pratique n'est pas recommandée dans la majorité des cas car elle requiert de modifier de manière spécifique la configuration des appenders dans le fichier  WEB-INF/conf/config.properties.