com.fr.third.apache.log4j.net

类 SMTPAppender

java.lang.Object

com.fr.third.apache.log4j.AppenderSkeleton

com.fr.third.apache.log4j.net.SMTPAppender

所有已实现的接口:

Appender, OptionHandler, UnrecognizedElementHandler

public class SMTPAppender
extends AppenderSkeleton
implements UnrecognizedElementHandler

Send an e-mail when a specific logging event occurs, typically on errors or fatal errors.

The number of logging events delivered in this e-mail depend on the value of BufferSize option. The SMTPAppender keeps only the last BufferSize logging events in its cyclic buffer. This keeps memory requirements at a reasonable level while still delivering useful application context. By default, an email message will be sent when an ERROR or higher severity message is appended. The triggering criteria can be modified by setting the evaluatorClass property with the name of a class implementing TriggeringEventEvaluator, setting the evaluator property with an instance of TriggeringEventEvaluator or nesting a triggeringPolicy element where the specified class implements TriggeringEventEvaluator. This class has implemented UnrecognizedElementHandler since 1.2.15. Since 1.2.16, SMTP over SSL is supported by setting SMTPProtocol to "smpts".

从以下版本开始:

1.0

作者:

Ceki Gülcü

字段概要

字段

限定符和类型	字段和说明
protected CyclicBuffer	cb
protected TriggeringEventEvaluator	evaluator
protected javax.mail.Message	msg

从类继承的字段 com.fr.third.apache.log4j.AppenderSkeleton

closed, errorHandler, headFilter, layout, name, tailFilter, threshold

构造器概要

构造器

构造器和说明
SMTPAppender() The default constructor will instantiate the appender with a TriggeringEventEvaluator that will trigger on events with level ERROR or higher.
SMTPAppender(TriggeringEventEvaluator evaluator) Use evaluator passed as parameter as the TriggeringEventEvaluator for this SMTPAppender.

方法概要

方法

限定符和类型	方法和说明
void	activateOptions() Activate the specified options, such as the smtp host, the recipient, from, etc.
protected void	addressMessage(javax.mail.Message msg) Address message.
void	append(LoggingEvent event) Perform SMTPAppender specific appending actions, mainly adding the event to a cyclic buffer and checking if the event triggers an e-mail to be sent.
protected boolean	checkEntryConditions() This method determines if there is a sense in attempting to append.
void	close() Release any resources allocated within the appender such as file handles, network connections, etc.
protected javax.mail.Session	createSession() Create mail session.
protected java.lang.String	formatBody() Layout body of email message.
java.lang.String	getBcc() Get the bcc recipient addresses.
int	getBufferSize() Returns value of the BufferSize option.
java.lang.String	getCc() Get the cc recipient addresses.
TriggeringEventEvaluator	getEvaluator() Get triggering evaluator.
java.lang.String	getEvaluatorClass() Returns value of the EvaluatorClass option.
java.lang.String	getFrom() Returns value of the From option.
boolean	getLocationInfo() Returns value of the LocationInfo option.
java.lang.String	getReplyTo() Get the reply addresses.
boolean	getSendOnClose() Get sendOnClose.
boolean	getSMTPDebug() Get SMTP debug.
java.lang.String	getSMTPHost() Returns value of the SMTPHost option.
java.lang.String	getSMTPPassword() Get SMTP password.
int	getSMTPPort() Get port.
java.lang.String	getSMTPProtocol() Get transport protocol.
java.lang.String	getSMTPUsername() Get SMTP user name.
java.lang.String	getSubject() Returns value of the Subject option.
java.lang.String	getTo() Returns value of the To option.
boolean	parseUnrecognizedElement(org.w3c.dom.Element element, java.util.Properties props) Called to inform a configured object when an unrecognized child element is encountered.
boolean	requiresLayout() The SMTPAppender requires a layout.
protected void	sendBuffer() Send the contents of the cyclic buffer as an e-mail message.
void	setBcc(java.lang.String addresses) Set the bcc recipient addresses.
void	setBufferSize(int bufferSize) The BufferSize option takes a positive integer representing the maximum number of logging events to collect in a cyclic buffer.
void	setCc(java.lang.String addresses) Set the cc recipient addresses.
void	setEvaluator(TriggeringEventEvaluator trigger) Sets triggering evaluator.
void	setEvaluatorClass(java.lang.String value) The EvaluatorClass option takes a string value representing the name of the class implementing the TriggeringEventEvaluator interface.
void	setFrom(java.lang.String from) The From option takes a string value which should be a e-mail address of the sender.
void	setLocationInfo(boolean locationInfo) The LocationInfo option takes a boolean value.
void	setReplyTo(java.lang.String addresses) Set the e-mail addresses to which replies should be directed.
void	setSendOnClose(boolean val) Set sendOnClose.
void	setSMTPDebug(boolean debug) Setting the SmtpDebug option to true will cause the mail session to log its server interaction to stdout.
void	setSMTPHost(java.lang.String smtpHost) The SMTPHost option takes a string value which should be a the host name of the SMTP server that will send the e-mail message.
void	setSMTPPassword(java.lang.String password) The SmtpPassword option takes a string value which should be the password required to authenticate against the mail server.
void	setSMTPPort(int val) Set port.
void	setSMTPProtocol(java.lang.String val) Set transport protocol.
void	setSMTPUsername(java.lang.String username) The SmtpUsername option takes a string value which should be the username required to authenticate against the mail server.
void	setSubject(java.lang.String subject) The Subject option takes a string value which should be a the subject of the e-mail message.
void	setTo(java.lang.String to) The To option takes a string value which should be a comma separated list of e-mail address of the recipients.

从类继承的方法 com.fr.third.apache.log4j.AppenderSkeleton

addFilter, clearFilters, doAppend, finalize, getErrorHandler, getFilter, getFirstFilter, getLayout, getName, getThreshold, isAsSevereAsThreshold, setErrorHandler, setLayout, setName, setThreshold

从类继承的方法 java.lang.Object

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

字段详细资料

cb

protected CyclicBuffer cb

msg

protected javax.mail.Message msg

evaluator

protected TriggeringEventEvaluator evaluator

构造器详细资料

SMTPAppender

public SMTPAppender()

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

SMTPAppender

public SMTPAppender(TriggeringEventEvaluator evaluator)

Use evaluator passed as parameter as the TriggeringEventEvaluator for this SMTPAppender.

方法详细资料

activateOptions

public void activateOptions()

Activate the specified options, such as the smtp host, the recipient, from, etc.

指定者:

activateOptions 在接口中 OptionHandler

覆盖:

activateOptions 在类中 AppenderSkeleton

addressMessage

protected void addressMessage(javax.mail.Message msg)
                       throws javax.mail.MessagingException

Address message.

参数:

msg - message, may not be null.

抛出:

javax.mail.MessagingException - thrown if error addressing message.

从以下版本开始:

1.2.14

createSession

protected javax.mail.Session createSession()

Create mail session.

返回:

mail session, may not be null.

从以下版本开始:

1.2.14

append

public void append(LoggingEvent event)

Perform SMTPAppender specific appending actions, mainly adding the event to a cyclic buffer and checking if the event triggers an e-mail to be sent.

指定者:

append 在类中 AppenderSkeleton

checkEntryConditions

protected boolean checkEntryConditions()

This method determines if there is a sense in attempting to append.

It checks whether there is a set output target and also if there is a set layout. If these checks fail, then the boolean value false is returned.

close

public void close()

从接口复制的说明: Appender

Release any resources allocated within the appender such as file handles, network connections, etc.

It is a programming error to append to a closed appender.

指定者:

close 在接口中 Appender

getTo

public java.lang.String getTo()

Returns value of the To option.

requiresLayout

public boolean requiresLayout()

The SMTPAppender requires a layout.

指定者:

requiresLayout 在接口中 Appender

formatBody

protected java.lang.String formatBody()

Layout body of email message.

从以下版本开始:

1.2.16

sendBuffer

protected void sendBuffer()

Send the contents of the cyclic buffer as an e-mail message.

getEvaluatorClass

public java.lang.String getEvaluatorClass()

Returns value of the EvaluatorClass option.

getFrom

public java.lang.String getFrom()

Returns value of the From option.

getReplyTo

public java.lang.String getReplyTo()

Get the reply addresses.

返回:

reply addresses as comma separated string, may be null.

从以下版本开始:

1.2.16

getSubject

public java.lang.String getSubject()

Returns value of the Subject option.

setFrom

public void setFrom(java.lang.String from)

The From option takes a string value which should be a e-mail address of the sender.

setReplyTo

public void setReplyTo(java.lang.String addresses)

Set the e-mail addresses to which replies should be directed.

参数:

addresses - reply addresses as comma separated string, may be null.

从以下版本开始:

1.2.16

setSubject

public void setSubject(java.lang.String subject)

The Subject option takes a string value which should be a the subject of the e-mail message.

setBufferSize

public void setBufferSize(int bufferSize)

The BufferSize option takes a positive integer representing the maximum number of logging events to collect in a cyclic buffer. When the BufferSize is reached, oldest events are deleted as new events are added to the buffer. By default the size of the cyclic buffer is 512 events.

setSMTPHost

public void setSMTPHost(java.lang.String smtpHost)

The SMTPHost option takes a string value which should be a the host name of the SMTP server that will send the e-mail message.

getSMTPHost

public java.lang.String getSMTPHost()

Returns value of the SMTPHost option.

setTo

public void setTo(java.lang.String to)

The To option takes a string value which should be a comma separated list of e-mail address of the recipients.

getBufferSize

public int getBufferSize()

Returns value of the BufferSize option.

setEvaluatorClass

public void setEvaluatorClass(java.lang.String value)

The EvaluatorClass option takes a string value representing the name of the class implementing the TriggeringEventEvaluator interface. A corresponding object will be instantiated and assigned as the triggering event evaluator for the SMTPAppender.

setLocationInfo

public void setLocationInfo(boolean locationInfo)

The LocationInfo option takes a boolean value. By default, it is set to false which means there will be no effort to extract the location information related to the event. As a result, the layout that formats the events as they are sent out in an e-mail is likely to place the wrong location information (if present in the format).

Location information extraction is comparatively very slow and should be avoided unless performance is not a concern.

getLocationInfo

public boolean getLocationInfo()

Returns value of the LocationInfo option.

setCc

public void setCc(java.lang.String addresses)

Set the cc recipient addresses.

参数:

addresses - recipient addresses as comma separated string, may be null.

从以下版本开始:

1.2.14

getCc

public java.lang.String getCc()

Get the cc recipient addresses.

返回:

recipient addresses as comma separated string, may be null.

从以下版本开始:

1.2.14

setBcc

public void setBcc(java.lang.String addresses)

Set the bcc recipient addresses.

参数:

addresses - recipient addresses as comma separated string, may be null.

从以下版本开始:

1.2.14

getBcc

public java.lang.String getBcc()

Get the bcc recipient addresses.

返回:

recipient addresses as comma separated string, may be null.

从以下版本开始:

1.2.14

setSMTPPassword

public void setSMTPPassword(java.lang.String password)

The SmtpPassword option takes a string value which should be the password required to authenticate against the mail server.

参数:

password - password, may be null.

从以下版本开始:

1.2.14

setSMTPUsername

public void setSMTPUsername(java.lang.String username)

The SmtpUsername option takes a string value which should be the username required to authenticate against the mail server.

参数:

username - user name, may be null.

从以下版本开始:

1.2.14

setSMTPDebug

public void setSMTPDebug(boolean debug)

Setting the SmtpDebug option to true will cause the mail session to log its server interaction to stdout. This can be useful when debuging the appender but should not be used during production because username and password information is included in the output.

参数:

debug - debug flag.

从以下版本开始:

1.2.14

getSMTPPassword

public java.lang.String getSMTPPassword()

Get SMTP password.

返回:

SMTP password, may be null.

从以下版本开始:

1.2.14

getSMTPUsername

public java.lang.String getSMTPUsername()

Get SMTP user name.

返回:

SMTP user name, may be null.

从以下版本开始:

1.2.14

getSMTPDebug

public boolean getSMTPDebug()

Get SMTP debug.

返回:

SMTP debug flag.

从以下版本开始:

1.2.14

setEvaluator

public final void setEvaluator(TriggeringEventEvaluator trigger)

Sets triggering evaluator.

参数:

trigger - triggering event evaluator.

从以下版本开始:

1.2.15

getEvaluator

public final TriggeringEventEvaluator getEvaluator()

Get triggering evaluator.

返回:

triggering event evaluator.

从以下版本开始:

1.2.15

parseUnrecognizedElement

public boolean parseUnrecognizedElement(org.w3c.dom.Element element,
                               java.util.Properties props)
                                 throws java.lang.Exception

Called to inform a configured object when an unrecognized child element is encountered.

指定者:

parseUnrecognizedElement 在接口中 UnrecognizedElementHandler

参数:

element - element, may not be null.

props - properties in force, may be null.

返回:

true if configured object recognized the element

抛出:

java.lang.Exception - throw an exception to prevent activation of the configured object.

从以下版本开始:

1.2.15

getSMTPProtocol

public final java.lang.String getSMTPProtocol()

Get transport protocol. Typically null or "smtps".

返回:

transport protocol, may be null.

从以下版本开始:

1.2.16

setSMTPProtocol

public final void setSMTPProtocol(java.lang.String val)

Set transport protocol. Typically null or "smtps".

参数:

val - transport protocol, may be null.

从以下版本开始:

1.2.16

getSMTPPort

public final int getSMTPPort()

Get port.

返回:

port, negative values indicate use of default ports for protocol.

从以下版本开始:

1.2.16

setSMTPPort

public final void setSMTPPort(int val)

Set port.

参数:

val - port, negative values indicate use of default ports for protocol.

从以下版本开始:

1.2.16

getSendOnClose

public final boolean getSendOnClose()

Get sendOnClose.

返回:

if true all buffered logging events will be sent when the appender is closed.

从以下版本开始:

1.2.16

setSendOnClose

public final void setSendOnClose(boolean val)

Set sendOnClose.

参数:

val - if true all buffered logging events will be sent when appender is closed.

从以下版本开始:

1.2.16