Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/klemek/simplelogger
A simple but useful Java logger to use everywhere.
https://github.com/klemek/simplelogger
java java-8 java8 logger maven
Last synced: about 2 months ago
JSON representation
A simple but useful Java logger to use everywhere.
- Host: GitHub
- URL: https://github.com/klemek/simplelogger
- Owner: Klemek
- License: apache-2.0
- Created: 2018-08-30T11:15:45.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-10-13T09:12:35.000Z (about 4 years ago)
- Last Synced: 2024-04-21T10:24:21.723Z (9 months ago)
- Topics: java, java-8, java8, logger, maven
- Language: Java
- Size: 54.7 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Simple Logger
[](https://search.maven.org/search?q=g:%22com.github.klemek%22%20AND%20a:%22simplelogger%22)
[](https://travis-ci.org/Klemek/SimpleLogger)
[](https://github.com/boyter/scc/#badges-beta)
[](https://coveralls.io/github/Klemek/SimpleLogger?branch=master)
[](https://lgtm.com/projects/g/Klemek/SimpleLogger/context:java)
[](https://lgtm.com/projects/g/Klemek/SimpleLogger/alerts/)
A simple but useful Java logger to use everywhere.
Current version v1.3.1
## Download
[simplelogger-1.3.1.jar](../../releases/download/simplelogger-1.3.1/simplelogger-1.3.1.jar)
## How to use
Initialization :
```Java
Logger.init("logging.properties", Level.WARNING);
// or
Logger.init("logging.properties");
Logger.setLevel(Level.WARNING);
```
Configuration file as follow (example) :
```
# Parameters for good behavior
handlers=java.util.logging.ConsoleHandler
.level=WARNING
java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter
# Customize date/time shown with this line
java.util.logging.SimpleFormatter.format=[%1$tF %1$tT][%4$s]%5$s %n
# Specify your app name here
app_name=YourApp
# (Optional, specify your app package)
default_package=com.your.app
# (Optional, specify an output file pattern)
output_file=output.log
```
The default package works as follow : When logging stack trace of an error, it will stop when the package doesnt't match your app anymore. It helps having small and relevant stack trace in logs.
Usage :
```Java
//general logging
Logger.log("my message"); //INFO log
Logger.log("my message : {0}", 123); //INFO log with parameters
Logger.log(Level.WARNING, "my message"); //custom level log
Logger.log(Level.SEVERE, "my message : {0}-{1}", 123, 456); //custom level log with parameters
//exception logging
Logger.log(exception1); //SEVERE logging with stack trace
Logger.log(exception2, "exception when doing task"); //SEVERE logging with stack trace and message
Logger.log(Level.WARNING, exception3); //custom level logging without stack trace
Logger.log(Level.INFO, exception4, "exception when doing task"); //custom level logging with message
```
This will show the following :
```
[INFO][MyApp-CallingClass] my message
[INFO][MyApp-CallingClass] my message : 123
[WARNING][MyApp-CallingClass] my message
[SEVERE][MyApp-CallingClass] my message : 123-456
[SEVERE][MyApp-CallingClass] (exception1.toString)
[SEVERE][MyApp-CallingClass] (exception1.stackTrace)
[SEVERE][MyApp-CallingClass] (exception1.stackTrace)
[SEVERE][MyApp-CallingClass] ...
[SEVERE][MyApp-CallingClass] exception when doing task : (exception2.toString)
[SEVERE][MyApp-CallingClass] (exception2.stackTrace)
[SEVERE][MyApp-CallingClass] (exception2.stackTrace)
[SEVERE][MyApp-CallingClass] ...
[WARNING][MyApp-CallingClass] (exception3.toString)
[INFO][MyApp-CallingClass] exception when doing task : (exception4.toString)
```
## Maven
You can use this project as a maven dependency with this :
```XML
com.github.klemek
simple-logger
1.3.1
```