JarCastingslf4j-kotlin-extensions
Utilities to make working with slf4j Loggers from Kotlin more enjoyable.
Lazy loggers
Contains 3 lazyLogger utilities to get Lazy<org.slf4j.Logger> instances:
class TheClass {
// Lazy logger with KClass
private val logger by lazyLogger(TheClass::class)
// Lazy logger with Java class
private val logger by lazyLogger(TheClass::class.java)
// Lazy logger with name
private val logger by lazyLogger("the-logger's-name")
}
org.slf4j.Logger extensions
Contains extensions to use Kotlin's string expansion feature in SLF4J loggers:
class TheClass {
private val logger by lazyLogger(TheClass::class)
private val marker by lazy { MarkerFactory.getMarker("the-marker") }
fun doSomething(param: Int) {
logger.debug {
// This will NOT be called if debug logs are not enabled for the logger ('isDebugEnabled')
"You can now use Kotlin's string expansion for your logs :: $param"
}
logger.trace(marker) {
"Also works with markers :: $param"
}
try {
// Do something risky here
} catch (e: Throwable) {
logger.error(e) {
"You can also use the (String, Throwable) overloads :: $param"
}
}
}
}
All log functions support the same features (markers, throwables) even if not specifically demonstrated in the above example.
Adding to your project
Although not specified as a dependency, you will need an SLF4J implementation and the Kotlin stdlib on your classpath.
Gradle
dependencies {
compile 'com.frimastudio:slf4j-kotlin-extensions:VERSION'
}
Maven
<dependencies>
<dependency>
<groupId>com.frimastudio</groupId>
<artifactId>slf4j-kotlin-extensions</artifactId>
<version>VERSION</version>
</dependency>
</dependencies>
Issues
Issues/requests should be entered in the project's issues page.
This project uses semantic versioning 2.0.0.
