org.apache.jmeter.reporters

Class MailerModel

java.lang.Object

org.apache.jmeter.testelement.AbstractTestElement

org.apache.jmeter.reporters.MailerModel

All Implemented Interfaces:

Serializable, Cloneable, TestElement

public class MailerModel
extends AbstractTestElement
implements Serializable

The model for a MailerVisualizer.

See Also:

Serialized Form

Field Summary

Fields inherited from interface org.apache.jmeter.testelement.TestElement

COMMENTS, ENABLED, GUI_CLASS, NAME, TEST_CLASS

Constructor Summary

Constructors

Constructor and Description
MailerModel() Constructs a MailerModel.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(SampleResult sample) Adds a SampleResult for display in the Visualizer.
void	add(SampleResult sample, boolean sendMails) Adds a SampleResult.
void	addChangeListener(ChangeListener list)
void	clear() Resets the state of this object to its default.
Object	clone()
Vector<String>	getAddressVector() Gets a Vector of String-objects.
long	getFailureCount()
long	getFailureLimit()
String	getFailureSubject()
String	getFromAddress()
String	getSmtpHost()
long	getSuccessCount()
long	getSuccessLimit()
String	getSuccessSubject()
String	getToAddress()
void	notifyChangeListeners()
void	sendMail(String from, Vector<String> vEmails, String subject, String attText, String smtpHost) Sends a mail with the given parameters using SMTP.
void	sendTestMail()
void	setFailureLimit(String limit)
void	setFailureSubject(String str)
void	setFromAddress(String str)
void	setSmtpHost(String str)
void	setSuccessLimit(String limit)
void	setSuccessSubject(String str)
void	setToAddress(String str)
String	toString() Returns a String-representation of this object.

Methods inherited from class org.apache.jmeter.testelement.AbstractTestElement

addProperty, addTestElement, canRemove, clearTemporary, clearTestElementChildren, emptyTemporary, equals, getComment, getName, getProperty, getPropertyAsBoolean, getPropertyAsBoolean, getPropertyAsDouble, getPropertyAsFloat, getPropertyAsInt, getPropertyAsInt, getPropertyAsLong, getPropertyAsLong, getPropertyAsString, getPropertyAsString, getThreadContext, getThreadName, hashCode, isEnabled, isRunningVersion, isTemporary, logProperties, mergeIn, propertyIterator, recoverRunningVersion, removeProperty, setComment, setName, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setRunningVersion, setTemporary, setThreadContext, setThreadName, traverse, traverseCollection, traverseMap, traverseProperty

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MailerModel

public MailerModel()

Constructs a MailerModel.

Method Detail

addChangeListener

public void addChangeListener(ChangeListener list)

clone

public Object clone()

Specified by:

clone in interface TestElement

Overrides:

clone in class AbstractTestElement

notifyChangeListeners

public void notifyChangeListeners()

getAddressVector

public Vector<String> getAddressVector()

Gets a Vector of String-objects. Each String is one mail-address of the addresses-String set by setToAddress(str). The addresses must be seperated by commas. Only String-objects containing a "@" are added to the returned Vector.

Returns:

a Vector of String-objects wherein each String represents a mail-address.

add

public void add(SampleResult sample)

Adds a SampleResult for display in the Visualizer.

Parameters:

sample - the SampleResult encapsulating informations about the last sample.

add

public void add(SampleResult sample,
       boolean sendMails)

Adds a SampleResult. If SampleResult represents a change concerning the failure/success of the sampling a message might be sent to the addressies according to the settings of successCount and failureCount.

Parameters:

sample - the SampleResult encapsulating information about the last sample.

sendMails - whether or not to send e-mails

clear

public void clear()

Resets the state of this object to its default. But: This method does not reset any mail-specific attributes (like sender, mail-subject...) since they are independent of the sampling.

Specified by:

clear in interface TestElement

Overrides:

clear in class AbstractTestElement

toString

public String toString()

Returns a String-representation of this object. Returns always "E-Mail-Notification". Might be enhanced in future versions to return some kind of String-representation of the mail-parameters (like sender, addressies, smtpHost...).

Overrides:

toString in class Object

Returns:

A String-representation of this object.

sendMail

public void sendMail(String from,
            Vector<String> vEmails,
            String subject,
            String attText,
            String smtpHost)
              throws javax.mail.internet.AddressException,
                     javax.mail.MessagingException

Sends a mail with the given parameters using SMTP.

Parameters:

from - the sender of the mail as shown in the mail-client.

vEmails - all receivers of the mail. The receivers are seperated by commas.

subject - the subject of the mail.

attText - the message-body.

smtpHost - the smtp-server used to send the mail.

Throws:

javax.mail.internet.AddressException

javax.mail.MessagingException

sendTestMail

public void sendTestMail()
                  throws javax.mail.internet.AddressException,
                         javax.mail.MessagingException

Throws:

javax.mail.internet.AddressException

javax.mail.MessagingException

setToAddress

public void setToAddress(String str)

setFromAddress

public void setFromAddress(String str)

setSmtpHost

public void setSmtpHost(String str)

setFailureSubject

public void setFailureSubject(String str)

setSuccessSubject

public void setSuccessSubject(String str)

setSuccessLimit

public void setSuccessLimit(String limit)

setFailureLimit

public void setFailureLimit(String limit)

getToAddress

public String getToAddress()

getFromAddress

public String getFromAddress()

getSmtpHost

public String getSmtpHost()

getFailureSubject

public String getFailureSubject()

getSuccessSubject

public String getSuccessSubject()

getSuccessLimit

public long getSuccessLimit()

getSuccessCount

public long getSuccessCount()

getFailureLimit

public long getFailureLimit()

getFailureCount

public long getFailureCount()