ILogWriter on sillysky.net

CDefaultConsoleLogWriter

Tue, 14 Oct 2025 00:00:00 +0000

This LOG writer is the supplied LOG writer for console output.
It prints messages with ERROR level on System.err, while other levels are printed on System.out.

The log writer gets the settings (formatter, filename, level) from the preferences: see here.

CLogDto

Tue, 14 Oct 2025 00:00:00 +0000

The CLogDto class is used to store the data of a LOG entry.

Constructor

There is only one constructor.

public CLogDto(@NotNull final ELevel aLevel,
               @Nullable final Class aClass,
               @Nullable final String aName);

Getter and setter

The LOG level indicates how important this LOG entry is.

@NotNull
public ELevel getLevel();

The logger ID can consist of any class or text. In case of a class, its full name (including package) is used as ID.

@Nullable
public String getName();
@Nullable
public Class getLoggerClass();
@NotNull
public String getLoggerName();

The message is the text that was given during logging. This text is not yet the final formatted text.

CSyncFileLogWriter

Tue, 14 Oct 2025 00:00:00 +0000

This class implements the ILogWriter interface. It writes the formatted log messages to a file.

The writer formats the LOG message slightly differently than usual. There are two columns in the output. The LOG text is printed in the first column. It is wrapped when the column width is reached. In the second column, the other information is printed, such as time, the executing Java file, etc.. The second column is very far to the right in a normal editor, so you may have to scroll the output window to the right to see the contents. In return, it does not take up any space in the normal field of view, and more space remains for the important first column.

ELevel

Tue, 14 Oct 2025 00:00:00 +0000

As in many other logging systems, there are LOG levels. The following LOG levels are specified:

TRACE
DEBUG
INFO
WARN
ERROR
OFF

As always, setting a log level allows all LOG messages to be output at the same and lower LOG levels. Example: If the LOG level is set to INFO, all outputs with the levels INFO, WARN and ERROR are allowed. An exception is the OFF level: here all outputs are suppressed.

ILogger

Tue, 14 Oct 2025 00:00:00 +0000

The logger interface allows the user to write messages to the LOG output. A logger is obtained via the logger factory by specifying a class or a freely selectable name.

@NotNull
public static ILogger getLogger(@NotNull final Class aClass);
@NotNull
public static ILogger getLogger(@NotNull final String aName);

LOG levels

As in many other logging systems, there are LOG levels. The following LOG levels are specified:

TRACE
DEBUG
INFO
WARN
ERROR
OFF

Logging methods

For each level there is a set of methods to output a LOG message. Here is only the presentation of the methods for the debug output, the methods for the other LOG levels are analogous.