JUL to Zlg Bridge

This module provides a bridge from java.util.logging (a.k.a. JUL) to Zlg, while forwarding the call site location to the underlying concrete logger.

Getting Started

Dependencies

Gradle builds are hosted on JCenter. Add the following snippet to your build file, replacing x.y.z with the version shown on the Download badge at the top of this README.

compile "com.obsidiandynamics.zerolog:zerolog-core:x.y.z"
compile "com.obsidiandynamics.zerolog:zerolog-bridge-jul:x.y.z"

Programmatic installation

The following example installs the bridge for the root logger (stashing prior handlers first) and demonstrates logging via JUL, ending up in Zlg. Afterwards the original handlers are restored from the stash.

final Logger logger = Logger.getLogger(JulZlgBridgeSample.class.getName());

// log without the bridge... will go to System.err
logger.log(Level.INFO, "Hello");

final Zlg zlg = Zlg.forDeclaringClass().get();

// stash existing handlers and install a Zlg handler
JulZlgBridge.stashAllHandlers();
JulZlgBridge.install(zlg);

// logging will now end up with Zlg
logger.log(Level.INFO, "Pi is {0} ≈ {1}/{2}", new Object[] {Math.PI, 22, 7});

// uninstall Zlg and restore the previously stashed loggers
JulZlgBridge.uninstall();
JulZlgBridge.unstashAllHandlers();

// logging is now resumed to System.err
logger.log(Level.INFO, "Goodbye");

You can keep the original handlers and use the bridge at the same time by skipping the (un)stashing steps.

Note: JUL will apply its own level-based filtering to the log entries prior to delegating them to the handler(s). By default, the root JUL logger operates at Level.INFO. To programmatically alter the level, invoke setLevel(Level) on the Logger instance.

Installing via a properties file

The following sample properties file configures the ZlgHandler directly and enables all levels on the root logger.

handlers=com.obsidiandynamics.zerolog.ZlgHandler
.level=ALL

Configure by setting the java.util.logging.config.file system property (programmatically, or via a -D... JVM argument).

System.setProperty("java.util.logging.config.file", "src/test/resources/jul.properties");

final Logger logger = Logger.getLogger(ZlgHandlerPropertiesSample.class.getName());

// logging will now end up with Zlg
logger.log(Level.INFO, "Pi is {0} ≈ {1}/{2}", new Object[] {Math.PI, 22, 7});