com.atlassian.bamboo.admin.configuration

Interface MailConfigurationService

All Known Implementing Classes:

MailConfigurationServiceImpl

public interface MailConfigurationService

Service to manage mail configuration

Since:

5.10

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	MailConfigurationService.MailMode

Method Summary

Modifier and Type	Method and Description
void	deleteMailServer() Delete the current mail server configuration
com.atlassian.mail.server.SMTPMailServer	getMailServer() Retrieve the current mail server configuration
boolean	isMailServerConfigured() Returns true if mail server configuration exists
com.atlassian.mail.server.SMTPMailServer	updateMailServer(String name, String fromAddress, String subjectPrefix, Boolean precedenceBulkHeaderExcluded, MailConfigurationService.MailMode emailSetting, String smtpServer, String smtpPort, String smtpUsername, String smtpPassword, Boolean tlsEnabled, String jndiLocation) Update the current mail server configuration
com.atlassian.mail.server.SMTPMailServer	updateMailServer(String name, String fromAddress, String subjectPrefix, Boolean precedenceBulkHeaderExcluded, String emailSetting, String smtpServer, String smtpPort, String smtpUsername, String smtpPassword, Boolean tlsEnabled, String jndiLocation) Deprecated. since 6.0 use updateMailServer(String, String, String, Boolean, MailMode, String, String, String, String, Boolean, String)
List<String>	validateJndiLocation(String jndiLocation) Validates JNDI location for mail server.

Method Detail

isMailServerConfigured

boolean isMailServerConfigured()
                        throws UnauthorisedException

Returns true if mail server configuration exists

Returns:

boolean true if server configuration exists, false otherwise

Throws:

UnauthorisedException - if user does not have appropriate permissions (System Administrator)

Since:

6.0

getMailServer

@NotNull
com.atlassian.mail.server.SMTPMailServer getMailServer()
                                                         throws UnauthorisedException,
                                                                NotFoundException

Retrieve the current mail server configuration

Returns:

current mail server configuration

Throws:

UnauthorisedException - if user does not have appropriate permissions (System Administrator)

NotFoundException - if no mail server configuration is set

updateMailServer

@NotNull
com.atlassian.mail.server.SMTPMailServer updateMailServer(@Nullable
                                                                   String name,
                                                                   @Nullable
                                                                   String fromAddress,
                                                                   @Nullable
                                                                   String subjectPrefix,
                                                                   @Nullable
                                                                   Boolean precedenceBulkHeaderExcluded,
                                                                   @Nullable
                                                                   MailConfigurationService.MailMode emailSetting,
                                                                   @Nullable
                                                                   String smtpServer,
                                                                   @Nullable
                                                                   String smtpPort,
                                                                   @Nullable
                                                                   String smtpUsername,
                                                                   @Nullable
                                                                   String smtpPassword,
                                                                   @Nullable
                                                                   Boolean tlsEnabled,
                                                                   @Nullable
                                                                   String jndiLocation)
                                                            throws WebValidationException,
                                                                   UnauthorisedException

Update the current mail server configuration

Parameters:

name - name of the email server

fromAddress - an email address Bamboo-generated emails are sent from, must be a valid email address

subjectPrefix - prefix added to the email subject

precedenceBulkHeaderExcluded - whether to exclude "precedence:bulk" email header

emailSetting - MailMode.JNDI or MailMode.SMTP

smtpServer - address of SMTP server, null for JDNI

smtpPort - port of SMTP server, null for JNDI

smtpUsername - user name, null for JNDI

smtpPassword - password, null for JNDI

tlsEnabled - whether TLS is enabled, null for JNDI

jndiLocation - JNDI address specyfing email server, null for SMTP

Returns:

SMTPMailServer - mail server configuration after the update

Throws:

WebValidationException - if the supplied parameters are invalid

UnauthorisedException - if user does not have appropriate permissions (System Administrator)

Since:

6.0

updateMailServer

@Deprecated
 @NotNull
com.atlassian.mail.server.SMTPMailServer updateMailServer(@Nullable
                                                                                String name,
                                                                                @Nullable
                                                                                String fromAddress,
                                                                                @Nullable
                                                                                String subjectPrefix,
                                                                                @Nullable
                                                                                Boolean precedenceBulkHeaderExcluded,
                                                                                @Nullable
                                                                                String emailSetting,
                                                                                @Nullable
                                                                                String smtpServer,
                                                                                @Nullable
                                                                                String smtpPort,
                                                                                @Nullable
                                                                                String smtpUsername,
                                                                                @Nullable
                                                                                String smtpPassword,
                                                                                @Nullable
                                                                                Boolean tlsEnabled,
                                                                                @Nullable
                                                                                String jndiLocation)
                                                                         throws WebValidationException,
                                                                                UnauthorisedException

Deprecated. since 6.0 use updateMailServer(String, String, String, Boolean, MailMode, String, String, String, String, Boolean, String)

Update the current mail server configuration

Parameters:

name - name of the email server

fromAddress - an email address Bamboo-generated emails are sent from, must be a valid email address

subjectPrefix - prefix added to the email subject

precedenceBulkHeaderExcluded - whether to exclude "precedence:bulk" email header

emailSetting - must be either "JNDI" or "SMTP"

smtpServer - address of SMTP server, null for "JDNI"

smtpPort - port of SMTP server, null for "JNDI"

smtpUsername - user name, null for "JNDI"

smtpPassword - password, null for "JNDI"

tlsEnabled - whether TLS is enabled, null for "JNDI"

jndiLocation - JNDI address specyfing email server, null for "SMTP"

Returns:

SMTPMailServer - mail server configuration after the update

Throws:

WebValidationException - if the supplied parameters are invalid

UnauthorisedException - if user does not have appropriate permissions (System Administrator)

deleteMailServer

void deleteMailServer()
               throws NotFoundException,
                      com.atlassian.mail.MailException,
                      UnauthorisedException

Delete the current mail server configuration

Throws:

NotFoundException - if a mail server is not currently set

com.atlassian.mail.MailException - if there is an error attempting to delete the current mail configuration

UnauthorisedException - if user does not have appropriate permissions (System Administrator)

validateJndiLocation

@NotNull
List<String> validateJndiLocation(@NotNull
                                           String jndiLocation)

Validates JNDI location for mail server.

This method will not check whether the server can be found under the given location. Only the validity of the location (e.g. that a supported scheme was used) is checked.

Parameters:

jndiLocation - JNDI address specifying email server

Returns:

list of discovered errors, empty if the given JNDI location is valid