de.unkrig.commons.text

Class AbstractPrinter

java.lang.Object

de.unkrig.commons.text.AbstractPrinter

All Implemented Interfaces:

Printer

Direct Known Subclasses:

LevelFilteredPrinter, ProxyPrinter, WriterPrinter

public abstract class AbstractPrinter
extends Object
implements Printer

A basic implementation of the Printer interface.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractPrinter.Level The "importance levels" that a Printer supports.

Constructor Summary

Constructors

Constructor and Description
AbstractPrinter()

Method Summary

Modifier and Type	Method and Description
void	debug(String pattern, Object... arguments) Prints a debug message.
AbstractPrinter	discard(AbstractPrinter.Level level) Creates and returns an AbstractPrinter which discards all messages of the given level, and forwards all other messages to this AbstractWriter.
AbstractPrinter	discard(EnumSet<AbstractPrinter.Level> levels) Creates and returns an AbstractPrinter which discards all messages of the given levels, and forwards all other messages to this AbstractWriter.
AbstractPrinter	discardDebug(ConsumerWhichThrows<? super String,? extends RuntimeException> debugConsumer)
AbstractPrinter	discardError(ConsumerWhichThrows<? super String,? extends RuntimeException> errorConsumer)
AbstractPrinter	discardInfo(ConsumerWhichThrows<? super String,? extends RuntimeException> infoConsumer)
AbstractPrinter	discardVerbose(ConsumerWhichThrows<? super String,? extends RuntimeException> verboseConsumer)
AbstractPrinter	discardWarn(ConsumerWhichThrows<? super String,? extends RuntimeException> warnConsumer)
void	error(String pattern, Object... arguments) Prints an error condition.
void	error(String message, Throwable t) Prints an error condition.
void	error(String pattern, Throwable t, Object... arguments) Prints an error condition.
static AbstractPrinter	fromPrinter(Printer printer) Wraps a Printer as an AbstractPrinter.
static AbstractPrinter	getContextPrinter() Returns the context printer for this thread.
void	info(String pattern, Object... arguments) Prints an informative ("normal") message.
AbstractPrinter	redirect(AbstractPrinter.Level level, ConsumerWhichThrows<? super String,? extends RuntimeException> messageConsumer) Creates and returns an AbstractPrinter which sends all non-null messages of the given levelto the given messageConsumer, and forwards all other messages to this AbstractWriter.
AbstractPrinter	redirect(AbstractPrinter.Level level, Writer writer) Creates and returns an AbstractPrinter which writes messages of the given levelto the given writer, and forwards all other messages to this AbstractWriter.
AbstractPrinter	redirect(EnumSet<AbstractPrinter.Level> levels, ConsumerWhichThrows<? super String,? extends RuntimeException> messageConsumer) Creates and returns an AbstractPrinter which sends all non-null messages of the given levelsto the given messageConsumer, and forwards all other messages to this AbstractWriter.
AbstractPrinter	redirect(EnumSet<AbstractPrinter.Level> levels, Writer writer) Creates and returns an AbstractPrinter which writes messages of the given levelsto the given writer, and forwards all other messages to this AbstractWriter.
AbstractPrinter	redirectDebug(ConsumerWhichThrows<? super String,? extends RuntimeException> debugConsumer)
AbstractPrinter	redirectDebug(Writer w)
AbstractPrinter	redirectError(ConsumerWhichThrows<? super String,? extends RuntimeException> errorConsumer)
AbstractPrinter	redirectError(Writer w)
AbstractPrinter	redirectInfo(ConsumerWhichThrows<? super String,? extends RuntimeException> infoConsumer)
AbstractPrinter	redirectInfo(Writer w)
AbstractPrinter	redirectVerbose(ConsumerWhichThrows<? super String,? extends RuntimeException> verboseConsumer)
AbstractPrinter	redirectVerbose(Writer w)
AbstractPrinter	redirectWarn(ConsumerWhichThrows<? super String,? extends RuntimeException> warnConsumer)
AbstractPrinter	redirectWarn(Writer w)
void	run(Runnable runnable) Sets the current thread's context printer to this, runs the runnable, and eventually restores the original context printer.
<EX extends Throwable> void	run(RunnableWhichThrows<EX> runnable) Sets the current thread's context printer to this, runs the runnable, and eventually restores the original context printer.
void	verbose(String pattern, Object... arguments) Prints a verbose message.
void	warn(String pattern, Object... arguments) Prints a warning condition.

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.unkrig.commons.text.Printer

debug, error, info, verbose, warn

Constructor Detail

AbstractPrinter

public AbstractPrinter()

Method Detail

getContextPrinter

public static AbstractPrinter getContextPrinter()

Returns the context printer for this thread. The initial context printer for the "main thread" is the Printers.DEFAULT_PRINTER.

Notice that it is (intentionally) not possible to explicitly set the current thread's context printer; instead you would use run(Runnable).

fromPrinter

public static AbstractPrinter fromPrinter(Printer printer)

Wraps a Printer as an AbstractPrinter.

error

public void error(@Nullable
                  String message,
                  @Nullable
                  Throwable t)

Description copied from interface: Printer

Prints an error condition.

Specified by:

error in interface Printer

error

public void error(String pattern,
                  @Nullable
                  Throwable t,
                  Object... arguments)

Description copied from interface: Printer

Prints an error condition.

Specified by:

error in interface Printer

See Also:

Format.format(Object)

error

public void error(String pattern,
                  Object... arguments)

Description copied from interface: Printer

Prints an error condition.

Specified by:

error in interface Printer

See Also:

Format.format(Object)

warn

public void warn(String pattern,
                 Object... arguments)

Description copied from interface: Printer

Prints a warning condition.

Specified by:

warn in interface Printer

See Also:

Format.format(Object)

info

public void info(String pattern,
                 Object... arguments)

Description copied from interface: Printer

Prints an informative ("normal") message.

Specified by:

info in interface Printer

See Also:

Format.format(Object)

verbose

public void verbose(String pattern,
                    Object... arguments)

Description copied from interface: Printer

Prints a verbose message.

Specified by:

verbose in interface Printer

See Also:

Format.format(Object)

debug

public void debug(String pattern,
                  Object... arguments)

Description copied from interface: Printer

Prints a debug message.

Specified by:

debug in interface Printer

See Also:

Format.format(Object)

run

public final void run(Runnable runnable)

Sets the current thread's context printer to this, runs the runnable, and eventually restores the original context printer.

run

public final <EX extends Throwable> void run(RunnableWhichThrows<EX> runnable)
                                      throws EX extends Throwable

Sets the current thread's context printer to this, runs the runnable, and eventually restores the original context printer.

Throws:

EX extends Throwable

redirectError

public final AbstractPrinter redirectError(@Nullable
                                           Writer w)

See Also:

redirect(Level, Writer)

redirectWarn

public final AbstractPrinter redirectWarn(@Nullable
                                          Writer w)

See Also:

redirect(Level, Writer)

redirectInfo

public final AbstractPrinter redirectInfo(@Nullable
                                          Writer w)

See Also:

redirect(Level, Writer)

redirectVerbose

public final AbstractPrinter redirectVerbose(@Nullable
                                             Writer w)

See Also:

redirect(Level, Writer)

redirectDebug

public final AbstractPrinter redirectDebug(@Nullable
                                           Writer w)

See Also:

redirect(Level, Writer)

redirect

public final AbstractPrinter redirect(@Nullable
                                      AbstractPrinter.Level level,
                                      @Nullable
                                      Writer writer)

Creates and returns an AbstractPrinter which writes messages of the given levelto the given writer, and forwards all other messages to this AbstractWriter.

Iff level == null || writer == null, then this object is returned instead.

redirect

public final AbstractPrinter redirect(@Nullable
                                      EnumSet<AbstractPrinter.Level> levels,
                                      @Nullable
                                      Writer writer)

Creates and returns an AbstractPrinter which writes messages of the given levelsto the given writer, and forwards all other messages to this AbstractWriter.

Iff levels == null || levels.isEmpty() || writer == null, then this object is returned instead.

redirectError

public final AbstractPrinter redirectError(@Nullable
                                           ConsumerWhichThrows<? super String,? extends RuntimeException> errorConsumer)

See Also:

redirect(Level, ConsumerWhichThrows)

redirectWarn

public final AbstractPrinter redirectWarn(@Nullable
                                          ConsumerWhichThrows<? super String,? extends RuntimeException> warnConsumer)

See Also:

redirect(Level, ConsumerWhichThrows)

redirectInfo

public final AbstractPrinter redirectInfo(@Nullable
                                          ConsumerWhichThrows<? super String,? extends RuntimeException> infoConsumer)

See Also:

redirect(Level, ConsumerWhichThrows)

redirectVerbose

public final AbstractPrinter redirectVerbose(@Nullable
                                             ConsumerWhichThrows<? super String,? extends RuntimeException> verboseConsumer)

See Also:

redirect(Level, ConsumerWhichThrows)

redirectDebug

public final AbstractPrinter redirectDebug(@Nullable
                                           ConsumerWhichThrows<? super String,? extends RuntimeException> debugConsumer)

See Also:

redirect(Level, ConsumerWhichThrows)

redirect

public final AbstractPrinter redirect(@Nullable
                                      AbstractPrinter.Level level,
                                      @Nullable
                                      ConsumerWhichThrows<? super String,? extends RuntimeException> messageConsumer)

Creates and returns an AbstractPrinter which sends all non-null messages of the given levelto the given messageConsumer, and forwards all other messages to this AbstractWriter.

Iff level == null || messageConsumer == null, then this object is returned instead.

redirect

public final AbstractPrinter redirect(@Nullable
                                      EnumSet<AbstractPrinter.Level> levels,
                                      @Nullable
                                      ConsumerWhichThrows<? super String,? extends RuntimeException> messageConsumer)

Creates and returns an AbstractPrinter which sends all non-null messages of the given levelsto the given messageConsumer, and forwards all other messages to this AbstractWriter.

Iff levels == null || levels.isEmpty() || messageConsumer == null, then this object is returned instead.

discardError

public final AbstractPrinter discardError(@Nullable
                                          ConsumerWhichThrows<? super String,? extends RuntimeException> errorConsumer)

See Also:

discard(Level)

discardWarn

public final AbstractPrinter discardWarn(@Nullable
                                         ConsumerWhichThrows<? super String,? extends RuntimeException> warnConsumer)

See Also:

discard(Level)

discardInfo

public final AbstractPrinter discardInfo(@Nullable
                                         ConsumerWhichThrows<? super String,? extends RuntimeException> infoConsumer)

See Also:

discard(Level)

discardVerbose

public final AbstractPrinter discardVerbose(@Nullable
                                            ConsumerWhichThrows<? super String,? extends RuntimeException> verboseConsumer)

See Also:

discard(Level)

discardDebug

public final AbstractPrinter discardDebug(@Nullable
                                          ConsumerWhichThrows<? super String,? extends RuntimeException> debugConsumer)

See Also:

discard(Level)

discard

public final AbstractPrinter discard(@Nullable
                                     AbstractPrinter.Level level)

Creates and returns an AbstractPrinter which discards all messages of the given level, and forwards all other messages to this AbstractWriter.

Iff level == null, then this object is returned instead.

discard

public final AbstractPrinter discard(@Nullable
                                     EnumSet<AbstractPrinter.Level> levels)

Creates and returns an AbstractPrinter which discards all messages of the given levels, and forwards all other messages to this AbstractWriter.

Iff levels == null || levels.isEmpty(), then this object is returned instead.