hudson.tasks

Class Mailer

java.lang.Object

hudson.tasks.BuildStepCompatibilityLayer

hudson.tasks.Publisher

hudson.tasks.Notifier

hudson.tasks.Mailer

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.Describable<hudson.tasks.Publisher>, hudson.tasks.BuildStep, jenkins.tasks.SimpleBuildStep

public class Mailer
extends hudson.tasks.Notifier
implements jenkins.tasks.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

hudson.tasks.Publisher.DescriptorExtensionListImpl

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

jenkins.tasks.SimpleBuildStep.LastBuildAction, jenkins.tasks.SimpleBuildStep.LastBuildActionFactory

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

hudson.tasks.BuildStep.PublisherList

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.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()
hudson.tasks.BuildStepMonitor	getRequiredMonitorService() This class does explicit check pointing.
boolean	isNotifyEveryUnstableBuild()
void	perform(hudson.model.Run<?,?> build, hudson.FilePath workspace, hudson.Launcher launcher, hudson.model.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, 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, perform, 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 -

notifyEveryUnstableBuild - inverted for historical reasons.

sendToIndividuals -

Method Detail

isNotifyEveryUnstableBuild

public boolean isNotifyEveryUnstableBuild()

perform

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

Specified by:

perform in interface jenkins.tasks.SimpleBuildStep

Throws:

IOException

InterruptedException

getRequiredMonitorService

public hudson.tasks.BuildStepMonitor getRequiredMonitorService()

This class does explicit check pointing.

Specified by:

getRequiredMonitorService in interface hudson.tasks.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).

Throws:

javax.mail.internet.AddressException

UnsupportedEncodingException

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()