Package com.avoka.fc.core.service.email
Class GroovyEmailService
- java.lang.Object
-
- com.avoka.fc.core.service.BaseService
-
- com.avoka.fc.core.service.CayenneService
-
- com.avoka.fc.core.service.email.AbstractEmailService
-
- com.avoka.fc.core.service.email.GroovyEmailService
-
- All Implemented Interfaces:
IEmailService
,IServiceDefinitionAware
,IUnitTestableService
public class GroovyEmailService extends AbstractEmailService implements IServiceDefinitionAware, IUnitTestableService
Provides a Groovy Email service.- Since:
- 4.3.2
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class com.avoka.fc.core.service.email.AbstractEmailService
AbstractEmailService.EmailFormat, AbstractEmailService.TempForm, AbstractEmailService.TempSubmission, AbstractEmailService.TempSubmissionExtractData, AbstractEmailService.TempUser
-
-
Field Summary
-
Fields inherited from class com.avoka.fc.core.service.email.AbstractEmailService
EMAIL_INFO_EVENT_LOG_PATTEN
-
-
Constructor Summary
Constructors Constructor Description GroovyEmailService()
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description protected ApplicationException
createExceptionAndLog(Date startTime, com.jezhumble.javasysmon.CpuTimes startCpuTimes, Long startFreeMemory, Throwable cause, String context, String userMsg, String solution, Submission submission, Form form, Client client)
Create application exception and optionally log ErrorLog and GroovyServiceLog records if Groovy Logging enabled.protected Object
executeGroovyScript(Map<String,Object> parameters, Client client)
Execute the service Groovy Script using the given parameters and security context client.protected Throwable
getCause(Throwable e)
Return the root cause of the exceptionInteger
getExecutionTimeout()
Return the GroovyScript execution timeout in milliseconds.String
getGroovyScript()
GroovyServiceLog
getGroovyServiceLog()
Return the GroovyServiceLog record created after executing the script.ServiceDefinition
getServiceDefinition()
Return the service definitionprotected String
getServiceName()
Deprecated.this no longer uniquely identifies the service - use getNameAndVersion() where possibleprotected String
getServiceNameAndVersion()
protected Integer
getServiceTimeout()
String
getTestLogOutput()
Return the service Unit Test Script logger output.boolean
isExceptionDebugLoggingEnabled()
Return true if the Exception DEBUG level message recording is enabled.Boolean
isGroovyDebugLogging()
Return true if GroovyLogger DEBUG level message recording is enabled.boolean
isGroovyLoggingEnabled()
Return true if the Groovy Service logging is enabled.boolean
isGroovyTypeChecked()
Return true if the Groovy runtime should perform static type checking.Throwable
runUnitTest()
Run the service's Unit Test Script if defined for the service, returning null if succeeded or an error if it failed.void
sendEmailMessage(String subject, String message, String fromAddress, String replyToAddress, String toAddress, String ccAddress, String bccAddress, Map<String,byte[]> attachmentMap, Submission submission)
Send an email message.void
setExceptionDebugLoggingEnabled(Boolean debugEnabled)
Specify whether the Exception DEBUG level message recording is enabled.void
setExecutionTimeout(Integer timeout)
Return the GroovyScript execution timeout in milliseconds.void
setGroovyDebugLogging(Boolean debugEnabled)
Set whether GroovyLogger DEBUG level message recording is enabled.void
setGroovyLoggingEnabled(Boolean loggingEnabled)
Specify whether the Groovy Service logging is enabled.void
setGroovyScript(String script)
void
setGroovyTypeChecked(boolean typeChecked)
Specify whether the Groovy runtime should perform static type checking.void
setServiceDefinition(ServiceDefinition serviceDefinition)
Set the service definition.-
Methods inherited from class com.avoka.fc.core.service.email.AbstractEmailService
getTemplatedEmailMessageForPortal, getTemplatedEmailMessageForSubmission, getTemplatedEmailMessageForSubmission, queueAccountStatusNotification, queueEmail, queueEmail, queueEmail, queueEmail, queueFormReceiptEmail, queueFormReceiptEmail, queueNewAccountNotification, queueOrSendFormConfirmationReceiptMessage, queuePromotionNotificationMessage, queueSavedFormEmail, queueSavedFormEmail, queueShareFormEmail, queueSubmissionUpdateNotification, queueTemplatedMessageForPortal, renderDeploymentPropertyTemplate, sendDuplicatePaymentAlertEmailToClientAdmin, sendEmailVerification, sendEmailVerification, sendFormConfirmationMessage, sendFormReceiptMessage, sendFraudAlertEmailToClientAdmin, sendLostPasswordMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessageWithSubmissionAttachments, sendSavedFormEmail, sendSavedFormEmail, sendTaskNotification, sendTemplatedMessageForPortal, sendWelcomeUserMessage, sendWelcomeUserMessage
-
Methods inherited from class com.avoka.fc.core.service.CayenneService
commitChanges, deleteObject, deleteObjects, findObject, getDataContext, getDataDomain, getObjectForPK, getObjectStore, newObject, performNamedQuery, performNamedQuery, performNamedQuery, performNonSelectingQuery, performNonSelectingQuery, performNonSelectingQuery, performNonSelectingQuery, performQuery, performQuery, refetchEntity, refetchObject, registerNewObject, rollbackChanges, toMap, toMap
-
Methods inherited from class com.avoka.fc.core.service.BaseService
getLogger
-
-
-
-
Method Detail
-
sendEmailMessage
public void sendEmailMessage(String subject, String message, String fromAddress, String replyToAddress, String toAddress, String ccAddress, String bccAddress, Map<String,byte[]> attachmentMap, Submission submission)
Send an email message.- Specified by:
sendEmailMessage
in interfaceIEmailService
- Parameters:
subject
- email subjectmessage
- email message bodyfromAddress
- the from addressreplyToAddress
- the reply-to addresstoAddress
- email to addressccAddress
- email address to ccbccAddress
- email address to bccattachmentMap
- attachments mapsubmission
- the submission the email relates to (optional)- See Also:
IEmailService.sendEmailMessage(String, String, String, String, String, String, String, Map, Submission)
-
runUnitTest
public Throwable runUnitTest()
Run the service's Unit Test Script if defined for the service, returning null if succeeded or an error if it failed. If there is no 'Unit Test Script' defined, this method will return null.- Specified by:
runUnitTest
in interfaceIUnitTestableService
- Returns:
- an Exception if the test case failed, or null if the test case succeeded or no 'Unit Test Script' defined.
- See Also:
IUnitTestableService.runUnitTest()
-
getTestLogOutput
public String getTestLogOutput()
Return the service Unit Test Script logger output.- Specified by:
getTestLogOutput
in interfaceIUnitTestableService
- Returns:
- the service Unit Test Script logger output
- Since:
- 17.10.0
- See Also:
IUnitTestableService.getTestLogOutput()
-
getGroovyServiceLog
public GroovyServiceLog getGroovyServiceLog()
Return the GroovyServiceLog record created after executing the script.- Returns:
- the GroovyServiceLog record created after executing the script.
-
isGroovyDebugLogging
public Boolean isGroovyDebugLogging()
Return true if GroovyLogger DEBUG level message recording is enabled.- Returns:
- true if GroovyLogger DEBUG level message recording is enabled.
- Since:
- 4.3.4
-
setGroovyDebugLogging
public void setGroovyDebugLogging(Boolean debugEnabled)
Set whether GroovyLogger DEBUG level message recording is enabled.- Parameters:
debugEnabled
- the groovyDebugLoggingEnabled to set- Since:
- 4.3.4
-
isGroovyLoggingEnabled
public boolean isGroovyLoggingEnabled()
Return true if the Groovy Service logging is enabled.- Returns:
- true if the Groovy Service logging is enabled.
-
setGroovyLoggingEnabled
public void setGroovyLoggingEnabled(Boolean loggingEnabled)
Specify whether the Groovy Service logging is enabled.- Parameters:
loggingEnabled
- specify whether the Groovy Service logging is enabled
-
setExceptionDebugLoggingEnabled
public void setExceptionDebugLoggingEnabled(Boolean debugEnabled)
Specify whether the Exception DEBUG level message recording is enabled.- Parameters:
debugEnabled
- specify the Exception DEBUG level message recording is enabled- Since:
- 19.5.3
-
isExceptionDebugLoggingEnabled
public boolean isExceptionDebugLoggingEnabled()
Return true if the Exception DEBUG level message recording is enabled.- Returns:
- true if the Exception DEBUG level message recording is enabled.
- Since:
- 19.5.3
-
getGroovyScript
public String getGroovyScript()
- Returns:
- the Groovy Script content to execute
-
setGroovyScript
public void setGroovyScript(String script)
- Parameters:
script
- the Groovy Script content to execute
-
isGroovyTypeChecked
public boolean isGroovyTypeChecked()
Return true if the Groovy runtime should perform static type checking.- Returns:
- true if the Groovy runtime should perform static type checking
-
setGroovyTypeChecked
public void setGroovyTypeChecked(boolean typeChecked)
Specify whether the Groovy runtime should perform static type checking.- Parameters:
typeChecked
- specify whether the Groovy runtime should perform static type checking
-
getExecutionTimeout
public Integer getExecutionTimeout()
Return the GroovyScript execution timeout in milliseconds.- Returns:
- the GroovyScript execution timeout in milliseconds
-
setExecutionTimeout
public void setExecutionTimeout(Integer timeout)
Return the GroovyScript execution timeout in milliseconds.- Parameters:
timeout
- the GroovyScript execution timeout in milliseconds
-
getServiceDefinition
public ServiceDefinition getServiceDefinition()
Return the service definition- Specified by:
getServiceDefinition
in interfaceIServiceDefinitionAware
- Overrides:
getServiceDefinition
in classAbstractEmailService
- Returns:
- the service definition.
- See Also:
IServiceDefinitionAware.getServiceDefinition()
-
setServiceDefinition
public void setServiceDefinition(ServiceDefinition serviceDefinition)
Set the service definition.- Specified by:
setServiceDefinition
in interfaceIServiceDefinitionAware
- Overrides:
setServiceDefinition
in classAbstractEmailService
- Parameters:
serviceDefinition
- the service definition to set- See Also:
IServiceDefinitionAware.setServiceDefinition(ServiceDefinition)
-
executeGroovyScript
protected Object executeGroovyScript(Map<String,Object> parameters, Client client)
Execute the service Groovy Script using the given parameters and security context client.- Parameters:
parameters
- the script parameters (required)client
- the calling client (optional)- Returns:
- a new GroovyScript runtime for the given client
-
createExceptionAndLog
protected ApplicationException createExceptionAndLog(Date startTime, com.jezhumble.javasysmon.CpuTimes startCpuTimes, Long startFreeMemory, Throwable cause, String context, String userMsg, String solution, Submission submission, Form form, Client client)
Create application exception and optionally log ErrorLog and GroovyServiceLog records if Groovy Logging enabled.- Parameters:
startTime
- the time the service was invoked prior to the errorstartCpuTimes
- the CPU times when the service was invoked (required)startFreeMemory
- the free memory in bytes when the service was invoked (required)cause
- the root cause of the errorcontext
- the error context informationuserMsg
- the user messagesolution
- the solutionsubmission
- the submission objectform
- the formclient
- the client- Returns:
- a new application exception
-
getServiceName
protected String getServiceName()
Deprecated.this no longer uniquely identifies the service - use getNameAndVersion() where possible- Returns:
- the service definition service name
-
getServiceNameAndVersion
protected String getServiceNameAndVersion()
- Returns:
- the service definition name and version number
-
getServiceTimeout
protected Integer getServiceTimeout()
- Returns:
- the service timeout
-
-