io.github.lukehutch.fastclasspathscanner.utils

Class LogNode

java.lang.Object

io.github.lukehutch.fastclasspathscanner.utils.LogNode

public class LogNode
extends Object

A tree-structured threadsafe log that allows you to add log entries in arbitrary order, and have the output retain a sane order. The order may also be made deterministic by specifying a sort key for log entries.

Constructor Summary

Constructors

Constructor and Description
LogNode() Create a toplevel log node.

Method Summary

Modifier and Type	Method and Description
void	addElapsedTime() Call this once the work corresponding with a given log entry has completed if you want to show the time taken after the log entry.
void	flush() Flush out the log to stderr, and clear the log contents.
LogNode	log(Exception e) Add a log entry.
LogNode	log(String msg) Add a log entry.
LogNode	log(String msg, long elapsedTimeNanos) Add a log entry.
LogNode	log(String msg, long elapsedTimeNanos, Throwable e) Add a log entry.
LogNode	log(String sortKey, String msg) Add a log entry with sort key for deterministic ordering.
LogNode	log(String sortKey, String msg, long elapsedTimeNanos) Add a log entry with sort key for deterministic ordering.
LogNode	log(String sortKey, String msg, long elapsedTimeNanos, Throwable e) Add a log entry with sort key for deterministic ordering.
LogNode	log(String sortKey, String msg, Throwable e) Add a log entry with sort key for deterministic ordering.
LogNode	log(String msg, Throwable e) Add a log entry.
String	toString() Build the log output.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

LogNode

public LogNode()

Create a toplevel log node.

Method Detail

toString

public String toString()

Build the log output. Call this on the toplevel log node.

Overrides:

toString in class Object

addElapsedTime

public void addElapsedTime()

Call this once the work corresponding with a given log entry has completed if you want to show the time taken after the log entry.

log

public LogNode log(String sortKey,
                   String msg,
                   long elapsedTimeNanos,
                   Throwable e)

Add a log entry with sort key for deterministic ordering.

Returns:

a child log node, which can be used to add sub-entries.

log

public LogNode log(String sortKey,
                   String msg,
                   long elapsedTimeNanos)

Add a log entry with sort key for deterministic ordering.

Returns:

a child log node, which can be used to add sub-entries.

log

public LogNode log(String sortKey,
                   String msg,
                   Throwable e)

Add a log entry with sort key for deterministic ordering.

Returns:

a child log node, which can be used to add sub-entries.

log

public LogNode log(String sortKey,
                   String msg)

Add a log entry with sort key for deterministic ordering.

Returns:

a child log node, which can be used to add sub-entries.

log

public LogNode log(String msg,
                   long elapsedTimeNanos,
                   Throwable e)

Add a log entry.

Returns:

a child log node, which can be used to add sub-entries.

log

public LogNode log(String msg,
                   long elapsedTimeNanos)

Add a log entry.

Returns:

a child log node, which can be used to add sub-entries.

log

public LogNode log(String msg,
                   Throwable e)

Add a log entry.

Returns:

a child log node, which can be used to add sub-entries.

log

public LogNode log(String msg)

Add a log entry.

Returns:

a child log node, which can be used to add sub-entries.

log

public LogNode log(Exception e)

Add a log entry.

Returns:

a child log node, which can be used to add sub-entries.

flush

public void flush()

Flush out the log to stderr, and clear the log contents. Only call this on the toplevel log node, when threads do not have access to references of internal log nodes so that they cannot add more log entries inside the tree, otherwise log entries may be lost.