Package hudson.plugins.emailext

Class ExtendedEmailPublisher

java.lang.Object

hudson.tasks.BuildStepCompatibilityLayer

hudson.tasks.Publisher

hudson.tasks.Notifier

hudson.plugins.emailext.ExtendedEmailPublisher

All Implemented Interfaces:

ExtensionPoint, hudson.matrix.MatrixAggregatable, Describable<Publisher>, BuildStep

public class ExtendedEmailPublisher
extends Notifier
implements hudson.matrix.MatrixAggregatable

Publisher that sends notification e-mail.

Nested Class Summary

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

Publisher.DescriptorExtensionListImpl

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	Description
boolean	attachBuildLog	True to attach the log from the build to the email.
String	attachmentsPattern	The project wide set of attachments.
boolean	compressBuildLog	True to compress the log from the build before attaching to the email
List<EmailTrigger>	configuredTriggers	This is the list of email theTriggers that the project has configured
String	contentType	The contentType of the emails for this project (text/html, text/plain, etc).
static final String	DEFAULT_BODY_TEXT
static final String	DEFAULT_EMERGENCY_REROUTE_TEXT
static final String	DEFAULT_SUBJECT_TEXT
String	defaultContent	The default body of the emails for this project.
String	defaultSubject	The default subject of the emails for this project.
boolean	disabled	If true, disables the publisher from running.
String	from	From value for the e-mail
MatrixTriggerMode	matrixTriggerMode	How to theTrigger the email if the project is a matrix project.
static final String	PROJECT_DEFAULT_BODY_TEXT
static final String	PROJECT_DEFAULT_SUBJECT_TEXT
String	recipientList	A comma-separated list of email recipient that will be used for every theTrigger.
String	replyTo	Reply-To value for the e-mail
boolean	saveOutput	If true, save the generated email content to email-ext-message.[txt|html]
boolean	throttlingEnabled

Fields inherited from interface hudson.tasks.BuildStep

BUILDERS, PUBLISHERS

Constructor Summary

Constructors

Constructor	Description
ExtendedEmailPublisher()
ExtendedEmailPublisher(String project_recipient_list, String project_content_type, String project_default_subject, String project_default_content, String project_attachments, String project_presend_script, int project_attach_buildlog, String project_replyto, String project_from, boolean project_save_output, List<EmailTrigger> project_triggers, MatrixTriggerMode matrixTriggerMode)	Deprecated.
ExtendedEmailPublisher(String recipientList, String contentType, String defaultSubject, String defaultContent, String attachmentsPattern, String presendScript, int attachBuildLog, String replyTo, String from, boolean saveOutput, List<EmailTrigger> configuredTriggers, MatrixTriggerMode matrixTriggerMode, boolean disabled, List<GroovyScriptPath> classpath)

Method Summary

Modifier and Type	Method	Description
hudson.matrix.MatrixAggregator	createAggregator(hudson.matrix.MatrixBuild matrixbuild, Launcher launcher, BuildListener buildlistener)
void	debug(PrintStream p, String format, Object... args)
static ExtendedEmailPublisherDescriptor	descriptor()
int	getAttachBuildLog()
List<GroovyScriptPath>	getClasspath()
List<EmailTrigger>	getConfiguredTriggers()	Get the list of configured email theTriggers for this project.
ExtendedEmailPublisherDescriptor	getDescriptor()
MatrixTriggerMode	getMatrixTriggerMode()
String	getPostsendScript()
String	getPresendScript()
static Run<?,?>	getPreviousRun(Run<?,?> run, TaskListener listener)	Looks for a previous build, so long as that is in fact completed.
Collection<? extends Action>	getProjectActions(AbstractProject<?,?> project)
BuildStepMonitor	getRequiredMonitorService()
List<org.jenkinsci.plugins.tokenmacro.TokenMacro>	getRuntimeMacros(ExtendedEmailPublisherContext context)
boolean	isExecuteOnMatrixNodes()
boolean	needsToRunAfterFinalized()
boolean	perform(AbstractBuild<?,?> build, Launcher launcher, BuildListener listener)
boolean	prebuild(AbstractBuild<?,?> build, BuildListener listener)
Object	readResolve()
void	setClasspath(List<GroovyScriptPath> classpath)
void	setMatrixTriggerMode(MatrixTriggerMode matrixTriggerMode)
void	setPostsendScript(String postsendScript)
void	setPresendScript(String presendScript)

Methods inherited from class hudson.tasks.Publisher

all, getProjectAction, prebuild

Methods inherited from class hudson.tasks.BuildStepCompatibilityLayer

getProjectAction, perform

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_SUBJECT_TEXT

public static final String DEFAULT_SUBJECT_TEXT

See Also:

• Constant Field Values

DEFAULT_BODY_TEXT

public static final String DEFAULT_BODY_TEXT

See Also:

• Constant Field Values

DEFAULT_EMERGENCY_REROUTE_TEXT

public static final String DEFAULT_EMERGENCY_REROUTE_TEXT

See Also:

• Constant Field Values

PROJECT_DEFAULT_SUBJECT_TEXT

public static final String PROJECT_DEFAULT_SUBJECT_TEXT

See Also:

• Constant Field Values

PROJECT_DEFAULT_BODY_TEXT

public static final String PROJECT_DEFAULT_BODY_TEXT

See Also:

• Constant Field Values

recipientList

public String recipientList

A comma-separated list of email recipient that will be used for every theTrigger.

configuredTriggers

public List<EmailTrigger> configuredTriggers

This is the list of email theTriggers that the project has configured

contentType

public String contentType

The contentType of the emails for this project (text/html, text/plain, etc).

defaultSubject

public String defaultSubject

The default subject of the emails for this project. ($PROJECT_DEFAULT_SUBJECT)

defaultContent

public String defaultContent

The default body of the emails for this project. ($PROJECT_DEFAULT_BODY)

attachmentsPattern

public String attachmentsPattern

The project wide set of attachments.

attachBuildLog

public boolean attachBuildLog

True to attach the log from the build to the email.

compressBuildLog

public boolean compressBuildLog

True to compress the log from the build before attaching to the email

replyTo

public String replyTo

Reply-To value for the e-mail

from

public String from

From value for the e-mail

saveOutput

public boolean saveOutput

If true, save the generated email content to email-ext-message.[txt|html]

disabled

public boolean disabled

If true, disables the publisher from running.

throttlingEnabled

public boolean throttlingEnabled

matrixTriggerMode

public MatrixTriggerMode matrixTriggerMode

How to theTrigger the email if the project is a matrix project.

Constructor Details

ExtendedEmailPublisher

public ExtendedEmailPublisher()

ExtendedEmailPublisher

@Deprecated
public ExtendedEmailPublisher(String project_recipient_list,
 String project_content_type,
 String project_default_subject,
 String project_default_content,
 String project_attachments,
 String project_presend_script,
 int project_attach_buildlog,
 String project_replyto,
 String project_from,
 boolean project_save_output,
 List<EmailTrigger> project_triggers,
 MatrixTriggerMode matrixTriggerMode)

Deprecated.

ExtendedEmailPublisher

@DataBoundConstructor
public ExtendedEmailPublisher(String recipientList,
 String contentType,
 String defaultSubject,
 String defaultContent,
 String attachmentsPattern,
 String presendScript,
 int attachBuildLog,
 String replyTo,
 String from,
 boolean saveOutput,
 List<EmailTrigger> configuredTriggers,
 MatrixTriggerMode matrixTriggerMode,
 boolean disabled,
 List<GroovyScriptPath> classpath)

Method Details

getClasspath

public List<GroovyScriptPath> getClasspath()

setClasspath

public void setClasspath(List<GroovyScriptPath> classpath)

setPresendScript

public void setPresendScript(String presendScript)

getAttachBuildLog

public int getAttachBuildLog()

setPostsendScript

@DataBoundSetter
public void setPostsendScript(String postsendScript)

getPresendScript

public String getPresendScript()

getPostsendScript

public String getPostsendScript()

getConfiguredTriggers

public List<EmailTrigger> getConfiguredTriggers()

Get the list of configured email theTriggers for this project.

Returns:

The list of triggers configure for this publisher instance

getMatrixTriggerMode

public MatrixTriggerMode getMatrixTriggerMode()

setMatrixTriggerMode

public void setMatrixTriggerMode(MatrixTriggerMode matrixTriggerMode)

getProjectActions

@NonNull
public Collection<? extends Action> getProjectActions(AbstractProject<?,?> project)

Specified by:

getProjectActions in interface BuildStep

Overrides:

getProjectActions in class BuildStepCompatibilityLayer

debug

public void debug(PrintStream p,
 String format,
 Object... args)

prebuild

public boolean prebuild(AbstractBuild<?,?> build,
 BuildListener listener)

Specified by:

prebuild in interface BuildStep

Overrides:

prebuild in class BuildStepCompatibilityLayer

perform

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

Specified by:

perform in interface BuildStep

Overrides:

perform in class BuildStepCompatibilityLayer

getRuntimeMacros

public List<org.jenkinsci.plugins.tokenmacro.TokenMacro> getRuntimeMacros(ExtendedEmailPublisherContext context)

isExecuteOnMatrixNodes

public boolean isExecuteOnMatrixNodes()

needsToRunAfterFinalized

public boolean needsToRunAfterFinalized()

Overrides:

needsToRunAfterFinalized in class Publisher

getRequiredMonitorService

public BuildStepMonitor getRequiredMonitorService()

Specified by:

getRequiredMonitorService in interface BuildStep

getPreviousRun

@CheckForNull
public static Run<?,?> getPreviousRun(@NonNull
 Run<?,?> run,
 TaskListener listener)

Looks for a previous build, so long as that is in fact completed. Necessary since getRequiredMonitorService() does not wait for the previous build, so in the case of parallel-capable jobs, we need to behave sensibly when a later build actually finishes before an earlier one.

Parameters:

run - a run for which we may be sending mail

listener - a listener to which we may print warnings in case the actual previous build is still in progress

Returns:

the previous build, or null if that build is missing, or is still in progress

getDescriptor

public ExtendedEmailPublisherDescriptor getDescriptor()

Specified by:

getDescriptor in interface Describable<Publisher>

Overrides:

getDescriptor in class Notifier

descriptor

public static ExtendedEmailPublisherDescriptor descriptor()

createAggregator

public hudson.matrix.MatrixAggregator createAggregator(hudson.matrix.MatrixBuild matrixbuild,
 Launcher launcher,
 BuildListener buildlistener)

Specified by:

createAggregator in interface hudson.matrix.MatrixAggregatable

readResolve

public Object readResolve()