Module ch.qos.logback.classic

Package ch.qos.logback.classic.net

Class SMTPAppender

java.lang.Object

ch.qos.logback.core.spi.ContextAwareBase

ch.qos.logback.core.AppenderBase<ILoggingEvent>

ch.qos.logback.core.net.SMTPAppenderBase<ILoggingEvent>

ch.qos.logback.classic.net.SMTPAppender

All Implemented Interfaces:

Appender<ILoggingEvent>, ContextAware, FilterAttachable<ILoggingEvent>, LifeCycle

public class SMTPAppender
extends SMTPAppenderBase<ILoggingEvent>

Send an e-mail when a specific logging event occurs, typically on errors or fatal errors. For more information about this appender, please refer to the online manual at http://logback.qos.ch/manual/appenders.html#SMTPAppender

Author:

Ceki Gülcü, Sébastien Pennec

Field Summary

Fields inherited from class ch.qos.logback.core.net.SMTPAppenderBase

asynchronousSendingFuture, cbTracker, discriminator, eventEvaluator, layout, MAIL_SMTP_AUTH_PK, MAIL_SMTP_HOST_PK, MAIL_SMTP_LOCALHOST_PK, MAIL_SMTP_PORT_PK, MAIL_SMTP_SSL_ENABLE_PK, MAIL_SMTP_STARTTLS_ENABLE_PK, MAIL_TRANSPORT_PROTOCOL_PK, session, subjectLayout

Fields inherited from class ch.qos.logback.core.AppenderBase

name, started

Fields inherited from class ch.qos.logback.core.spi.ContextAwareBase

context

Constructor Summary

Constructors

Constructor	Description
SMTPAppender()	The default constructor will instantiate the appender with a EventEvaluator that will trigger on events with level ERROR or higher.
SMTPAppender(EventEvaluator<ILoggingEvent> eventEvaluator)	Use the parameter as the EventEvaluator for this SMTPAppender.

Method Summary

Modifier and Type	Method	Description
protected boolean	eventMarksEndOfLife(ILoggingEvent eventObject)
protected void	fillBuffer(CyclicBuffer<ILoggingEvent> cb, StringBuffer sbuf)
boolean	isIncludeCallerData()
protected PatternLayout	makeNewToPatternLayout(String toPattern)
protected Layout<ILoggingEvent>	makeSubjectLayout(String subjectStr)	return a layout for the subject string as appropriate for the module.
void	setIncludeCallerData(boolean includeCallerData)
void	start()	Start the appender
protected void	subAppend(CyclicBuffer<ILoggingEvent> cb, ILoggingEvent event)	Perform SMTPAppender specific appending actions, mainly adding the event to a cyclic buffer.

Methods inherited from class ch.qos.logback.core.net.SMTPAppenderBase

addTo, append, checkEntryConditions, getCharsetEncoding, getCyclicBufferTracker, getDiscriminator, getFrom, getJndiLocation, getLayout, getLocalhost, getPassword, getSmtpHost, getSMTPHost, getSmtpPort, getSMTPPort, getSubject, getToAsListOfString, getToList, getUsername, isAsynchronousSending, isSessionViaJNDI, isSSL, isSTARTTLS, sendBuffer, setAsynchronousSending, setCharsetEncoding, setCyclicBufferTracker, setDiscriminator, setEvaluator, setFrom, setJndiLocation, setLayout, setLocalhost, setPassword, setSessionViaJNDI, setSmtpHost, setSMTPHost, setSmtpPort, setSMTPPort, setSSL, setSTARTTLS, setSubject, setUsername, stop, updateMimeMsg

Methods inherited from class ch.qos.logback.core.AppenderBase

addFilter, clearAllFilters, doAppend, getCopyOfAttachedFiltersList, getFilterChainDecision, getName, isStarted, setName, toString

Methods inherited from class ch.qos.logback.core.spi.ContextAwareBase

addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn, getContext, getDeclaredOrigin, getStatusManager, setContext

Methods inherited from class java.lang.Object

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

Methods inherited from interface ch.qos.logback.core.spi.ContextAware

addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn, getContext, setContext

Constructor Details

SMTPAppender

public SMTPAppender()

The default constructor will instantiate the appender with a EventEvaluator that will trigger on events with level ERROR or higher.

SMTPAppender

public SMTPAppender(EventEvaluator<ILoggingEvent> eventEvaluator)

Use the parameter as the EventEvaluator for this SMTPAppender.

Method Details

start

public void start()

Description copied from class: SMTPAppenderBase

Start the appender

Specified by:

start in interface LifeCycle

Overrides:

start in class SMTPAppenderBase<ILoggingEvent>

subAppend

protected void subAppend(CyclicBuffer<ILoggingEvent> cb,
 ILoggingEvent event)

Perform SMTPAppender specific appending actions, mainly adding the event to a cyclic buffer.

Specified by:

subAppend in class SMTPAppenderBase<ILoggingEvent>

fillBuffer

protected void fillBuffer(CyclicBuffer<ILoggingEvent> cb,
 StringBuffer sbuf)

Specified by:

fillBuffer in class SMTPAppenderBase<ILoggingEvent>

eventMarksEndOfLife

protected boolean eventMarksEndOfLife(ILoggingEvent eventObject)

Specified by:

eventMarksEndOfLife in class SMTPAppenderBase<ILoggingEvent>

makeSubjectLayout

protected Layout<ILoggingEvent> makeSubjectLayout(String subjectStr)

Description copied from class: SMTPAppenderBase

return a layout for the subject string as appropriate for the module. If the subjectStr parameter is null, then a default value for subjectStr should be used.

Specified by:

makeSubjectLayout in class SMTPAppenderBase<ILoggingEvent>

Parameters:

subjectStr -

Returns:

a layout as appropriate for the module

makeNewToPatternLayout

protected PatternLayout makeNewToPatternLayout(String toPattern)

Specified by:

makeNewToPatternLayout in class SMTPAppenderBase<ILoggingEvent>

isIncludeCallerData

public boolean isIncludeCallerData()

setIncludeCallerData

public void setIncludeCallerData(boolean includeCallerData)