DOC Fichier de configuration

La release actuelle du Java Logger permet d'écrire l'ensemble des logs dans un fichier texte en local. Une prochaine release intégrera la sauvegarde des messages de logs dans une base de donées.

Fichier texte properties

La configuration est stockée dans un fichier texte javaLogger.properties avec des couples clé/valeur.

Exemple de paramètre

# Activation du fichier de log
FileHandler=true

Configuration par défaut

Le début du fichier de configuration contient des paramètres qui sont utilisés si aucune autre configuration est utilisée. Cette partie ne doit pas être supprimée même si vous utilisez vos paramètres personnalisés.

# Choix des niveaux à afficher (console ET fichier)
LevelINFO=true
LevelDEBUG=true
LevelWARN=rtue
LevelERROR=true
LevelTrace=true

# Fichier de sortie. Activation et emplacement. Si il n'existe pas, les répertoires D/logs seront créés à la racine du projet.
FileHandler=true
LogFilePath=D:/logs/javaLogger.log

# Rotation des fichiers à chaque fois que le fichier atteint la taille mentionnée ci-dessous (en Kilo octets).
LogFileSize=4

# Activation des logs en console
ConsoleHandler=true

# !Non supporté actuellement! Enregistrement des logs dans une base de donnée
DataBaseHandler=false

# Affichage des informations d'un mesage log : date, classe, niveau et caractère(s) séparateur(s)
ShowLEVEL=true
ShowDATE=true
ShowFQCN=true
Separator=|

Configuration personnalisée

Vous pouvez créer plusieurs configurations que vous pourrez instancier par leur nom dans votre code.

1. Choisissez un nom de logger (instance)
2. Vus pouvez choisir de changer un paramètre ou plusieurs au choix. Dans tous les cas si un paramètre n'est pas renseigné, le paramètre correspondant dans la configuration par défaut sera utilisé.

Comme exemple nous allons créer deux loggers, module1 et module2 :

# 1. Instance de configuration
loggers=module1,module2

# 2. Exemple de paramètres personnalisés
module1.Name=fr.projetA.JavaLogger
module1.LogFilePath=/home/projet1/logs/log_esiea.log
module1.LogFileSize=25

module2.Level=ERROR // Seul les messages d'erreurs seront affichés

Suite : Configurer dans votre code Java

https://github.com/demkada/Java-Logger/wiki/DOC-Configuration-dans-Java

---

Détails sur la rotation des fichiers de log

Le Java Logger gère la rotation des fichiers par taille. A chaque utilisation de la librairie, la taille du fichier log est vérifiée et l'ensemble des messages précédents sont déplacés dans un nouveau fichier avec comme suffixe _1.log (exemple Java_1.log). Puis le numéro du prochain fichier généré est incrémenté.

Exemple de fichier de logs

// JavaProject/logs/
23 fév 18:28 javaLogger.log
23 fév 18:17 javaLogger_1.log
23 fév 18:18 javaLogger_2.log
23 fév 18:20 javaLogger_3.log
23 fév 18:23 javaLogger_4.log