hudson.tasks

Class Mailer

java.lang.Object

hudson.tasks.BuildStepCompatibilityLayer

hudson.tasks.Publisher

hudson.tasks.Notifier

hudson.tasks.Mailer

All Implemented Interfaces:

ExtensionPoint, Describable<Publisher>, BuildStep, SimpleBuildStep

public class Mailer
extends Notifier
implements SimpleBuildStep

Publisher that sends the build result in e-mail.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Mailer.DescriptorImpl
static class	Mailer.UserProperty Per user property that is e-mail address.

Nested classes/interfaces inherited from class hudson.tasks.Publisher

Publisher.DescriptorExtensionListImpl

Nested classes/interfaces inherited from interface jenkins.tasks.SimpleBuildStep

SimpleBuildStep.LastBuildAction, SimpleBuildStep.LastBuildActionFactory

Nested classes/interfaces inherited from interface hudson.tasks.BuildStep

BuildStep.PublisherList

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	debug Deprecated. This hack may be removed in future versions
static Mailer.DescriptorImpl	DESCRIPTOR Deprecated. as of 1.286 Use descriptor() to obtain the current instance.
boolean	dontNotifyEveryUnstableBuild If true, only the first unstable build will be reported.
protected static Logger	LOGGER
String	recipients Whitespace-separated list of e-mail addresses that represent recipients.
boolean	sendToIndividuals If true, individuals will receive e-mails regarding who broke the build.

Fields inherited from interface hudson.tasks.BuildStep

BUILDERS, PUBLISHERS

Constructor Summary

Constructors

Constructor and Description
Mailer() Deprecated.
Mailer(String recipients, boolean notifyEveryUnstableBuild, boolean sendToIndividuals)

Method Summary

Modifier and Type	Method and Description
static Mailer.DescriptorImpl	descriptor()
BuildStepMonitor	getRequiredMonitorService() This class does explicit check pointing.
boolean	isNotifyEveryUnstableBuild()
boolean	perform(AbstractBuild<?,?> build, Launcher launcher, BuildListener listener)
void	perform(Run<?,?> build, FilePath workspace, Launcher launcher, TaskListener listener)
static javax.mail.internet.InternetAddress	stringToAddress(String strAddress, String charset) Converts a string to InternetAddress.
static javax.mail.internet.InternetAddress	StringToAddress(String strAddress, String charset) Deprecated. Use stringToAddress(java.lang.String, java.lang.String).

Methods inherited from class hudson.tasks.Notifier

getDescriptor

Methods inherited from class hudson.tasks.Publisher

all, getProjectAction, needsToRunAfterFinalized, prebuild

Methods inherited from class hudson.tasks.BuildStepCompatibilityLayer

getProjectAction, getProjectActions, perform, prebuild

Methods inherited from class java.lang.Object

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

Methods inherited from interface hudson.tasks.BuildStep

getProjectAction, getProjectActions, prebuild

Field Detail

LOGGER

protected static final Logger LOGGER

recipients

public String recipients

Whitespace-separated list of e-mail addresses that represent recipients.

dontNotifyEveryUnstableBuild

public boolean dontNotifyEveryUnstableBuild

If true, only the first unstable build will be reported.

sendToIndividuals

public boolean sendToIndividuals

If true, individuals will receive e-mails regarding who broke the build.

DESCRIPTOR

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
 @RestrictedSince(value="1.355")
public static Mailer.DescriptorImpl DESCRIPTOR

Deprecated. as of 1.286 Use descriptor() to obtain the current instance.

debug

@Deprecated
public static boolean debug

Deprecated. This hack may be removed in future versions

Debug probe point to be activated by the scripting console.

Constructor Detail

Mailer

@Deprecated
public Mailer()

Deprecated.

Default Constructor. This is left for backward compatibility.

Mailer

@DataBoundConstructor
public Mailer(String recipients,
                                    boolean notifyEveryUnstableBuild,
                                    boolean sendToIndividuals)

Parameters:

recipients - one or more recipients with separators

notifyEveryUnstableBuild - inverted for historical reasons.

sendToIndividuals - if true mails are sent to individual committers

Method Detail

isNotifyEveryUnstableBuild

public boolean isNotifyEveryUnstableBuild()

perform

public boolean perform(AbstractBuild<?,?> build,
                       Launcher launcher,
                       BuildListener listener)
                throws InterruptedException,
                       IOException

Specified by:

perform in interface BuildStep

Overrides:

perform in class BuildStepCompatibilityLayer

Throws:

InterruptedException

IOException

perform

public void perform(Run<?,?> build,
                    FilePath workspace,
                    Launcher launcher,
                    TaskListener listener)
             throws IOException,
                    InterruptedException

Specified by:

perform in interface SimpleBuildStep

Throws:

IOException

InterruptedException

getRequiredMonitorService

public BuildStepMonitor getRequiredMonitorService()

This class does explicit check pointing.

Specified by:

getRequiredMonitorService in interface BuildStep

StringToAddress

@Deprecated
 @Restricted(value=org.kohsuke.accmod.restrictions.DoNotUse.class)
 @RestrictedSince(value="1.16")
public static javax.mail.internet.InternetAddress StringToAddress(String strAddress,
                                                                                                                                                                                 String charset)
                                                                                                                                                                          throws javax.mail.internet.AddressException,
                                                                                                                                                                                 UnsupportedEncodingException

Deprecated. Use stringToAddress(java.lang.String, java.lang.String).

Deprecated! Converts a string to InternetAddress.

Parameters:

strAddress - Address string

charset - Charset (encoding) to be used

Returns:

InternetAddress for the specified string

Throws:

javax.mail.internet.AddressException - Malformed address

UnsupportedEncodingException - Unsupported encoding

stringToAddress

@Nonnull
public static javax.mail.internet.InternetAddress stringToAddress(@Nonnull
                                                                           String strAddress,
                                                                           @Nonnull
                                                                           String charset)
                                                                    throws javax.mail.internet.AddressException,
                                                                           UnsupportedEncodingException

Converts a string to InternetAddress.

Parameters:

strAddress - Address string

charset - Charset (encoding) to be used

Returns:

InternetAddress for the specified string

Throws:

javax.mail.internet.AddressException - Malformed address

UnsupportedEncodingException - Unsupported encoding

Since:

TODO

descriptor

public static Mailer.DescriptorImpl descriptor()