Log4J

Log four Java = Log for Java : trace pour Java.

Besoin

Fournir une API de trace Java et Open Source

Conception

Log4J est composé de :

• loggers qui représentent des catégories de traces, caractérisés par :
  • un nom hiérarchique, généralement similaire aux packages et à la classe émettrice de la trace (org.javarome.MaClasse par exemple). Par défaut tous les messages envoyés à un logger fils sont envoyés à son père.
  • un niveau (ALL, INFO, DEBUG, WARN, ERROR, FATAL, OFF ou autre) optionnel car un logger hérite du niveau de son père.
  • des appenders qui représentent des destinations de trace (console, fichier, composants d'IHM, sockets, destinations JMS, journal d'événements de NT, démons Unix Syslog ou autre). Par ce biais on peut également tracer de manière synchrone ou asynchrone. Les appenders référencent :
    • un layout qui définit le format d'écriture d'un appender (syntaxe à la printf du C ou autre). L'affichage de la valeur d'objets complexes (héritant les uns des autres par exemple) peut être réalisé via un ObjectRenderer afin d'éviter de détourner toString().

Implémentation

Log4J	Version	1
	Release	2
	Maintenance		6	7	8
Configuration		log4.properties		log4.xml

Exemples

Des exemples d'utilisation de Log4J sont :

Loggerapplogger = <b>Logger.getLogger</b> (<span class="codeString">"org.javarome.prosper"</span>); <br> logger<b>.setLevel </b>(<b>Level.INFO</b>); <span class="codeComment">// Pourrait être défini dans le fichier de configuration</span><br> <b>Logger </b>presentationLogger = <b>Logger.getLogger </b>(<span class="codeString">"org.javarome.proper.presentation"</span>);<br> logger<b>.warn</b> (<span class="codeString">"Avertissement application"</span>); <span class="codeComment">// Ok, car WARN >= INFO</span><br> logger<b>.debug</b> (<span class="codeString">"Debug application"</span>); <span class="codeComment">// Non affiché, car DEBUG < INFO</span><br> presentationLogger.<b>info</b> (<span class="codeString">"Info de présentation"</span>); <span class="codeComment">// Affiché car presentationLogger hérite du niveau INFO de son père appLogger</span><br> presentationLogger.<b>debug</b> (<span class="codeString">"Debug de presentation"</span>); <span class="codeComment">// Non affiché car presentationLogger hérite du niveau INFO > DEBUG de son père appLogger</span>

Notes

• Fichier de configuration XML ou Properties
• Hiérarchie de loggers
• Activation/désactivation de loggers
• Envoi des messages de logs vers plusieurs destinations (plusieurs appenders pour un même logger)
• L'API Java standard de trace est la JLA depuis [J2SE 1.4+]
• Des produits tiers complètent Log4J :
  • des appenders :
    • JDBCAppender pour écrire des traces dans une base de SGBDR
    • SNMPTrapAppender pour envoyer les logs à une machine de supervision
  • configLog4j pour éditer visuellement une configuration Log4J
  • LogTag permet d'effectuer des traces via une balise JSP spéciale

Des exemples d'applications utilisant Log4J sont :

• Tomcat

Limitations

• Certains paramètres du PatternLayout peuvent être pénalisants pour la performance :
  • %t affichant le thread courant
  • %c affichant la classe courante

Voir

• Téléchargement
• Page Wiki Log4J