hudson.console

Class ConsoleLogFilter

java.lang.Object

hudson.console.ConsoleLogFilter

All Implemented Interfaces:

ExtensionPoint

public abstract class ConsoleLogFilter
extends Object
implements ExtensionPoint

A hook to allow filtering of information that is written to the console log. Unlike ConsoleAnnotator and ConsoleNote, this class provides direct access to the underlying OutputStream so it's possible to suppress data, which isn't possible from the other interfaces. (ArgumentListBuilder.add(String, boolean) is a simpler way to suppress a single password.)

Since:

1.383

Author:

dty

See Also:

BuildWrapper.decorateLogger(hudson.model.AbstractBuild, java.io.OutputStream)

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor and Description
ConsoleLogFilter()

Method Summary

Modifier and Type	Method and Description
static ExtensionList<ConsoleLogFilter>	all() All the registered ConsoleLogFilters.
OutputStream	decorateLogger(AbstractBuild build, OutputStream logger) Deprecated. as of 1.632. Use decorateLogger(Run, OutputStream)
OutputStream	decorateLogger(Computer computer, OutputStream logger) Called to decorate logger for master/slave communication.
OutputStream	decorateLogger(Run build, OutputStream logger) Called on the start of each build, giving extensions a chance to intercept the data that is written to the log.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConsoleLogFilter

public ConsoleLogFilter()

Method Detail

decorateLogger

public OutputStream decorateLogger(AbstractBuild build,
                                   OutputStream logger)
                            throws IOException,
                                   InterruptedException

Deprecated. as of 1.632. Use decorateLogger(Run, OutputStream)

Called on the start of each build, giving extensions a chance to intercept the data that is written to the log.

Throws:

IOException

InterruptedException

decorateLogger

public OutputStream decorateLogger(Run build,
                                   OutputStream logger)
                            throws IOException,
                                   InterruptedException

Called on the start of each build, giving extensions a chance to intercept the data that is written to the log.

Even though this method is not marked 'abstract', this is the method that must be overridden by extensions.

Throws:

IOException

InterruptedException

decorateLogger

public OutputStream decorateLogger(@Nonnull
                                   Computer computer,
                                   OutputStream logger)
                            throws IOException,
                                   InterruptedException

Called to decorate logger for master/slave communication.

Parameters:

computer - Slave computer for which the logger is getting decorated. Useful to do contextual decoration.

Throws:

IOException

InterruptedException

Since:

1.632

all

public static ExtensionList<ConsoleLogFilter> all()

All the registered ConsoleLogFilters.