[gatein-dev] GateIn logging

[Julien Viet]

I have been improving a bit our logging structure in Tomcat to have a  
single file containing all GateIn debug and above statement in a  
single specific file.

You can find this file in tomcat/gatein/logs/, it is useful when  
developing GateIn as you can read it via a "tail -f".

This is configured in tomcat/conf/logging.properties and is quite easy  
to configure and it is also part of JDK logging, here is what was  
addded:

org.exoplatform.level = FINE
org.exoplatform.handlers = 6gatein.org.apache.juli.FileHandler
org.gatein.level = FINE
org.gatein.handlers = 6gatein.org.apache.juli.FileHandler

Those lines say that all debug level will fo in  the gatein file  
handler which is configured:

6gatein.org.apache.juli.FileHandler.level = FINE
6gatein.org.apache.juli.FileHandler.directory = ${catalina.base}/ 
gatein/logs
6gatein.org.apache.juli.FileHandler.prefix = gatein

I also resolved that task GTNPORTAL-502 (Remove println messages from  
java files) and removed the existing System.out.println in GateIn  
codebase, except for the commented system out.

Here are the important facts to remember:

1/ it is EASY to reconfigure logging for your needs, just modify the  
logging.properties file and create a new file or update the existing  
one to filter what you don't want

2/ If you do need to uncomment an existing commented System.out, use  
GateIn Logger instead and chose the appropriate level (usually DEBUG)  
it is very important to do that carefully.

3/ if you need to add debugging info, do as explained in 2/

4/ if you don't like JDK logging you can easily switch to another  
logging framework by removing the slf4j simple jar and putting the  
appropriate binding for slf4j

happy loggin!