hudson.model

Interface TaskListener

All Superinterfaces:

Serializable, org.jenkinsci.remoting.SerializableOnlyOverRemoting

All Known Subinterfaces:

BuildListener

All Known Implementing Classes:

AbstractTaskListener, BuildListenerAdapter, LogTaskListener, StreamBuildListener, StreamTaskListener

public interface TaskListener
extends org.jenkinsci.remoting.SerializableOnlyOverRemoting

Receives events that happen during some lengthy operation that has some chance of failures, such as a build, SCM change polling, agent launch, and so on.

This interface is implemented by Hudson core and passed to extension points so that they can record the progress of the operation without really knowing how those information and handled/stored by Hudson.

The information is one way or the other made available to users, and so the expectation is that when something goes wrong, enough information shall be written to a TaskListener so that the user can diagnose what's going wrong.

StreamTaskListener is the most typical implementation of this interface.

Implementations are generally expected to be remotable via Channel.

Author:

Kohsuke Kawaguchi

Field Summary

Fields

Modifier and Type	Field and Description
static TaskListener	NULL TaskListener that discards the output.

Method Summary

Modifier and Type	Method and Description
default PrintWriter	_error(String prefix, String msg)
default void	annotate(ConsoleNote ann) Annotates the current position in the output log by using the given annotation.
default PrintWriter	error(String msg) An error in the build.
default PrintWriter	error(String format, Object... args) Formatter.format(String, Object[]) version of error(String).
default PrintWriter	fatalError(String msg) A fatal error in the build.
default PrintWriter	fatalError(String format, Object... args) Formatter.format(String, Object[]) version of fatalError(String).
default Charset	getCharset() A charset to use for methods returning PrintWriter.
PrintStream	getLogger() This writer will receive the output of the build
default void	hyperlink(String url, String text) Places a HyperlinkNote on the given text.

Methods inherited from interface org.jenkinsci.remoting.SerializableOnlyOverRemoting

getChannelForSerialization

Field Detail

NULL

static final TaskListener NULL

TaskListener that discards the output.

Method Detail

getLogger

@NonNull
PrintStream getLogger()

This writer will receive the output of the build

getCharset

@Restricted(value=org.kohsuke.accmod.restrictions.ProtectedExternally.class)
 @NonNull
default Charset getCharset()

A charset to use for methods returning PrintWriter. Should match that used to construct getLogger().

Returns:

by default, UTF-8

_error

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
default PrintWriter _error(String prefix,
                                                                                                  String msg)

annotate

default void annotate(ConsoleNote ann)
               throws IOException

Annotates the current position in the output log by using the given annotation. If the implementation doesn't support annotated output log, this method might be no-op.

Throws:

IOException

Since:

1.349

hyperlink

default void hyperlink(String url,
                       String text)
                throws IOException

Places a HyperlinkNote on the given text.

Parameters:

url - If this starts with '/', it's interpreted as a path within the context path.

Throws:

IOException

error

@NonNull
default PrintWriter error(String msg)

An error in the build.

Returns:

A writer to receive details of the error.

error

@NonNull
default PrintWriter error(String format,
                                   Object... args)

Formatter.format(String, Object[]) version of error(String).

fatalError

@NonNull
default PrintWriter fatalError(String msg)

A fatal error in the build.

Returns:

A writer to receive details of the error.

fatalError

@NonNull
default PrintWriter fatalError(String format,
                                        Object... args)

Formatter.format(String, Object[]) version of fatalError(String).