org.openstreetmap.josm.tools

Class Logging.ReacquiringConsoleHandler

java.lang.Object

java.util.logging.Handler

java.util.logging.StreamHandler

java.util.logging.ConsoleHandler

org.openstreetmap.josm.tools.Logging.ReacquiringConsoleHandler

Enclosing class:

Logging

public static class Logging.ReacquiringConsoleHandler
extends java.util.logging.ConsoleHandler

A ConsoleHandler with a couple of extra features, allowing it to be targeted at an an arbitrary OutputStream which it can be asked to reacquire the reference for on demand through reacquireOutputStream(). It can also prevent a LogRecord's output if a specified prioritizedHandler would have outputted it.

Since:

14052

Field Summary

Fields

Modifier and Type	Field and Description
private java.io.OutputStream	outputStreamMemo
private java.util.function.Supplier<java.io.OutputStream>	outputStreamSupplier
private java.util.logging.Handler	prioritizedHandler
private boolean	superCompleted This variables is set to true as soon as the superconstructor has completed.

Constructor Summary

Constructors

Constructor and Description
ReacquiringConsoleHandler(java.util.function.Supplier<java.io.OutputStream> outputStreamSupplier, java.util.logging.Handler prioritizedHandler) Construct a new Logging.ReacquiringConsoleHandler.

Method Summary

Modifier and Type	Method and Description
void	publish(java.util.logging.LogRecord record)
void	reacquireOutputStream() Set output stream to one acquired from calling outputStreamSupplier
void	setOutputStream(java.io.OutputStream outputStream)

Methods inherited from class java.util.logging.ConsoleHandler

close

Methods inherited from class java.util.logging.StreamHandler

flush, isLoggable, setEncoding

Methods inherited from class java.util.logging.Handler

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevel

Methods inherited from class java.lang.Object

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

Field Detail

outputStreamSupplier

private final java.util.function.Supplier<java.io.OutputStream> outputStreamSupplier

prioritizedHandler

private final java.util.logging.Handler prioritizedHandler

outputStreamMemo

private java.io.OutputStream outputStreamMemo

superCompleted

private final boolean superCompleted

This variables is set to true as soon as the superconstructor has completed. The superconstructor calls setOutputStream(System.err), any subsequent call of setOutputStream(OutputStream) would then flush and close System.err. To avoid this, we override setOutputStream(OutputStream) to completely ignore all calls from the superconstructor.

Constructor Detail

ReacquiringConsoleHandler

public ReacquiringConsoleHandler(java.util.function.Supplier<java.io.OutputStream> outputStreamSupplier,
                                 java.util.logging.Handler prioritizedHandler)

Construct a new Logging.ReacquiringConsoleHandler.

Parameters:

outputStreamSupplier - A Supplier which will return the desired OutputStream for this handler when called. Particularly useful if you happen to be using a test framework which will switch out references to the stderr/stdout streams with new dummy ones from time to time.

prioritizedHandler - If non-null, will suppress output of any log records which pass this handler's Handler#isLoggable(LogRecord) method.

Method Detail

reacquireOutputStream

public void reacquireOutputStream()

Set output stream to one acquired from calling outputStreamSupplier

setOutputStream

public void setOutputStream(java.io.OutputStream outputStream)

Overrides:

setOutputStream in class java.util.logging.StreamHandler

publish

public void publish(java.util.logging.LogRecord record)

Overrides:

publish in class java.util.logging.ConsoleHandler