com.extrememessaging.ResponseMaster.MessageFields

Class BuildNumber

java.lang.Object

com.extrememessaging.ResponseMaster.MessageFields.BuildNumber

All Implemented Interfaces:

IConfigurableItem, IMessageField

public class BuildNumber
extends java.lang.Object
implements IMessageField

A message field that just returns the ResponseMaster build number Probably not helpful for real customers; it was added to simplify internal regression test configuration. New in build 823

Constructor Summary

Constructors

Constructor and Description
BuildNumber()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	GetValue() Get the value of the field
void	Initialize(java.lang.String parameter) customMessageFields.xml entry should look like this: <MessageField> <Name>BuildNumber</Name> <DataTypeClassName>java.lang.Integer</DataTypeClassName> <FetchingClassName>com.extrememessaging.ResponseMaster.MessageFields.BuildNumber</FetchingClassName> <NotNull>1</NotNull> <ExcludeFromFieldList>0</ExcludeFromFieldList> </MessageField>
void	PassMessages(CMessage parentMessage, jakarta.mail.Message javaMailMsg) Called once for each message.
void	SetValue(java.lang.Object newValue) Called if the value for this field is set externally.
void	Shutdown() Cleanup any resources you allocated during construction or operation.
void	Verify() This function is called once, just after the first time Initialize is called.

Methods inherited from class java.lang.Object

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

Constructor Detail

BuildNumber

public BuildNumber()

Method Detail

Initialize

public void Initialize(java.lang.String parameter)

customMessageFields.xml entry should look like this: <MessageField> <Name>BuildNumber</Name> <DataTypeClassName>java.lang.Integer</DataTypeClassName> <FetchingClassName>com.extrememessaging.ResponseMaster.MessageFields.BuildNumber</FetchingClassName> <NotNull>1</NotNull> <ExcludeFromFieldList>0</ExcludeFromFieldList> </MessageField>

Specified by:

Initialize in interface IConfigurableItem

Parameters:

parameter - The parameter from the config file, Frequently, the parameter will be a file name.

GetValue

public java.lang.Object GetValue()

Description copied from interface: IMessageField

Get the value of the field

Specified by:

GetValue in interface IMessageField

Returns:

The value of the field. It should have the type set in the DataTypeClassName field of the MessageFields.xml file. It is ok to return null.

Shutdown

public void Shutdown()

Description copied from interface: IConfigurableItem

Cleanup any resources you allocated during construction or operation. After this is called, nothing else will be called, unless Initialize is called again. Note: Shutdown may be called more than once on the same object New in build 595.

Specified by:

Shutdown in interface IConfigurableItem

SetValue

public void SetValue(java.lang.Object newValue)

Description copied from interface: IMessageField

Called if the value for this field is set externally. It you are implementing your own message fields, this call shouldn't need to do anything

Specified by:

SetValue in interface IMessageField

Parameters:

newValue - The new value for this field.

PassMessages

public void PassMessages(CMessage parentMessage,
                         jakarta.mail.Message javaMailMsg)
                  throws jakarta.mail.MessagingException

Description copied from interface: IMessageField

Called once for each message. Called after Initialize, before GetValue and SetValue Passes the information you may need to get your value

Specified by:

PassMessages in interface IMessageField

Parameters:

parentMessage - Do NOT use the parentMessage in this call. You can store a reference to it to use later in GetValue, but do not access the values of any other fields during this function.

javaMailMsg - The raw Java Mail message that the parentMessage is based upon You can freely read from this object, but do not modify it. If it throws a messaging exception that you cannot handle, you should re-throw it to let ResponseMaster re-cycle the connection to the mail server.

Throws:

jakarta.mail.MessagingException - if there is a problem accessing the javaMailMsg

Verify

public void Verify()

Description copied from interface: IMessageField

This function is called once, just after the first time Initialize is called. It is used to determine if any dependencies are missing or the parameter is invalid. It throws an exception if something is wrong.

Specified by:

Verify in interface IMessageField

See Also:

InvalidMessageFieldName, IllegalArgumentException