Class SmtpAppender.Builder
- java.lang.Object
-
- org.apache.logging.log4j.core.filter.AbstractFilterable.Builder<B>
-
- org.apache.logging.log4j.core.appender.AbstractAppender.Builder<SmtpAppender.Builder>
-
- org.apache.logging.log4j.core.appender.SmtpAppender.Builder
-
- All Implemented Interfaces:
Builder<SmtpAppender>
- Enclosing class:
- SmtpAppender
public static class SmtpAppender.Builder extends AbstractAppender.Builder<SmtpAppender.Builder> implements Builder<SmtpAppender>
- Since:
- 2.13.2
-
-
Constructor Summary
Constructors Constructor Description Builder()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description SmtpAppender
build()
Builds the object after all configuration has been set.SmtpAppender.Builder
setBcc(String bcc)
Comma-separated list of BCC email addresses.SmtpAppender.Builder
setBufferSize(int bufferSize)
Number of log events to buffer before sending an email.SmtpAppender.Builder
setCc(String cc)
Comma-separated list of CC email addresses.SmtpAppender.Builder
setFilter(Filter filter)
Specifies the filter used for this appender.SmtpAppender.Builder
setFrom(String from)
Email address of the sender.SmtpAppender.Builder
setLayout(Layout<? extends Serializable> layout)
Specifies the layout used for the email message body.SmtpAppender.Builder
setReplyTo(String replyTo)
Comma-separated list of Reply-To email addresses.SmtpAppender.Builder
setSmtpDebug(boolean smtpDebug)
Enables or disables mail session debugging on STDOUT.SmtpAppender.Builder
setSmtpHost(String smtpHost)
Host name of SMTP server to send messages through.SmtpAppender.Builder
setSmtpPassword(String smtpPassword)
Password to authenticate with SMTP server.SmtpAppender.Builder
setSmtpPort(int smtpPort)
Port number of SMTP server to send messages through.SmtpAppender.Builder
setSmtpProtocol(String smtpProtocol)
Transport protocol to use for SMTP such as "smtp" or "smtps".SmtpAppender.Builder
setSmtpUsername(String smtpUsername)
Username to authenticate with SMTP server.SmtpAppender.Builder
setSslConfiguration(SslConfiguration sslConfiguration)
Specifies an SSL configuration for smtps connections.SmtpAppender.Builder
setSubject(String subject)
Subject template for the email messages.SmtpAppender.Builder
setTo(String to)
Comma-separated list of recipient email addresses.-
Methods inherited from class org.apache.logging.log4j.core.appender.AbstractAppender.Builder
getConfiguration, getLayout, getName, getOrCreateLayout, getOrCreateLayout, isIgnoreExceptions, setConfiguration, setIgnoreExceptions, setName, withConfiguration, withIgnoreExceptions, withLayout, withName
-
Methods inherited from class org.apache.logging.log4j.core.filter.AbstractFilterable.Builder
asBuilder, getFilter, getPropertyArray, setPropertyArray, withFilter
-
-
-
-
Method Detail
-
setTo
public SmtpAppender.Builder setTo(String to)
Comma-separated list of recipient email addresses.
-
setCc
public SmtpAppender.Builder setCc(String cc)
Comma-separated list of CC email addresses.
-
setBcc
public SmtpAppender.Builder setBcc(String bcc)
Comma-separated list of BCC email addresses.
-
setFrom
public SmtpAppender.Builder setFrom(String from)
Email address of the sender.
-
setReplyTo
public SmtpAppender.Builder setReplyTo(String replyTo)
Comma-separated list of Reply-To email addresses.
-
setSubject
public SmtpAppender.Builder setSubject(String subject)
Subject template for the email messages.- See Also:
PatternLayout
-
setSmtpProtocol
public SmtpAppender.Builder setSmtpProtocol(String smtpProtocol)
Transport protocol to use for SMTP such as "smtp" or "smtps". Defaults to "smtp".
-
setSmtpHost
public SmtpAppender.Builder setSmtpHost(String smtpHost)
Host name of SMTP server to send messages through.
-
setSmtpPort
public SmtpAppender.Builder setSmtpPort(int smtpPort)
Port number of SMTP server to send messages through.
-
setSmtpUsername
public SmtpAppender.Builder setSmtpUsername(String smtpUsername)
Username to authenticate with SMTP server.
-
setSmtpPassword
public SmtpAppender.Builder setSmtpPassword(String smtpPassword)
Password to authenticate with SMTP server.
-
setSmtpDebug
public SmtpAppender.Builder setSmtpDebug(boolean smtpDebug)
Enables or disables mail session debugging on STDOUT. Disabled by default.
-
setBufferSize
public SmtpAppender.Builder setBufferSize(int bufferSize)
Number of log events to buffer before sending an email. Defaults to 512.
-
setSslConfiguration
public SmtpAppender.Builder setSslConfiguration(SslConfiguration sslConfiguration)
Specifies an SSL configuration for smtps connections.
-
setLayout
public SmtpAppender.Builder setLayout(Layout<? extends Serializable> layout)
Specifies the layout used for the email message body. By default, this uses the default HTML layout.- Overrides:
setLayout
in classAbstractAppender.Builder<SmtpAppender.Builder>
-
setFilter
public SmtpAppender.Builder setFilter(Filter filter)
Specifies the filter used for this appender. By default, uses aThresholdFilter
with a level of ERROR.- Overrides:
setFilter
in classAbstractFilterable.Builder<SmtpAppender.Builder>
-
build
public SmtpAppender build()
Description copied from interface:Builder
Builds the object after all configuration has been set. This will use default values for any unspecified attributes for the object.- Specified by:
build
in interfaceBuilder<SmtpAppender>
- Returns:
- the configured instance.
-
-