com.verisign.epp.codec.gen
Class EPPMsgQueue

java.lang.Object
  extended by com.verisign.epp.codec.gen.EPPMsgQueue
All Implemented Interfaces:
EPPCodecComponent, java.io.Serializable, java.lang.Cloneable

public class EPPMsgQueue
extends java.lang.Object
implements EPPCodecComponent

EPPMsgQueue describes messages queued for client retrieval. A <msgQ> element MUST NOT be present if there are no messages queued for client retrieval. A <msgQ> element MAY be present in responses to EPP commands other than the <pol> command if messages are queued for retrieval. A <msgQ> element MUST be present in responses to the EPP <poll> command if messages are queued for retrieval. The <msgQ> element contains the following attributes:

The <msgQ> element contains the following OPTIONAL child elements that MUST be returned in response to a <poll> request command and MUST NOT be returned in response to any other command, including a <poll> acknowledgement:

See Also:
Serialized Form

Field Summary
static java.lang.String DEFAULT_LANG
          The default language of the reason "en".
 
Constructor Summary
EPPMsgQueue()
          Default constructor required for serialization.
EPPMsgQueue(java.lang.Long aCount, java.lang.String aId)
          Allocates a new EPPMsgQueue with the required attributes.
EPPMsgQueue(java.lang.Long aCount, java.lang.String aId, java.util.Date aQDate, org.w3c.dom.NodeList aMsgNodeList)
          Allocates a new EPPMsgQueue with all of the attributes.
EPPMsgQueue(java.lang.Long aCount, java.lang.String aId, java.util.Date aQDate, java.lang.String aMsg)
          Allocates a new EPPMsgQueue with all of the attributes.
 
Method Summary
 java.lang.Object clone()
          Clone EPPMsgQueue.
 void decode(org.w3c.dom.Element aElement)
          decode EPPMsgQueue from a DOM element tree.
 org.w3c.dom.Element encode(org.w3c.dom.Document aDocument)
          encode EPPMsgQueue into a DOM element tree.
 boolean equals(java.lang.Object aObject)
          implements a deep EPPMsgQueue compare.
 java.lang.Long getCount()
          Gets the number of messages that exist in the queue.
 java.lang.String getId()
          Gets the id that uniquely identifies the message at the head of the queue.
 java.lang.String getLang()
          Gets the message language.
 java.lang.String getMsg()
          Gets the optional human-readable message.
 org.w3c.dom.NodeList getMsgNodeList()
          Gets the message DOM NodeList representing mixed XML content for the message.
 java.util.Date getQDate()
          Gets the optional date and time that the message was enqueued.
 void setCount(java.lang.Long aCount)
          Sets the number of messages that exist in the queue.
 void setId(java.lang.String aId)
          Gets the id that uniquely identifies the message at the head of the queue.
 void setLang(java.lang.String aLang)
          Sets the message language.
 void setMsg(java.lang.String aMsg)
          Sets the optional human-readable message.
 void setMsgNodeList(org.w3c.dom.NodeList aMsgNodeList)
          Sets the message DOM NodeList representing mixed XML content for the message.
 void setQDate(java.util.Date aDate)
          Sets the optional date and time that the message was enqueued.
 java.lang.String toString()
          Implementation of Object.toString, which will result in an indented XML String representation of the concrete EPPCodecComponent.
 
Methods inherited from class java.lang.Object
finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

DEFAULT_LANG

public static final java.lang.String DEFAULT_LANG
The default language of the reason "en".

See Also:
Constant Field Values
Constructor Detail

EPPMsgQueue

public EPPMsgQueue()
Default constructor required for serialization. The count and id attributes must be set before calling encode.


EPPMsgQueue

public EPPMsgQueue(java.lang.Long aCount,
                   java.lang.String aId)
Allocates a new EPPMsgQueue with the required attributes. The optional attributes are initialized to null.

Parameters:
aCount - The number of messages that exist in the queue
aId - uniquely identify the message at the head of the queue

EPPMsgQueue

public EPPMsgQueue(java.lang.Long aCount,
                   java.lang.String aId,
                   java.util.Date aQDate,
                   java.lang.String aMsg)
Allocates a new EPPMsgQueue with all of the attributes.

Parameters:
aCount - The number of messages that exist in the queue
aId - uniquely identify the message at the head of the queue
aQDate - date and time that the message was enqueued
aMsg - human-readable message. The language defaults to DEFAULT_LANG, but can be set with setLang(String).

EPPMsgQueue

public EPPMsgQueue(java.lang.Long aCount,
                   java.lang.String aId,
                   java.util.Date aQDate,
                   org.w3c.dom.NodeList aMsgNodeList)
Allocates a new EPPMsgQueue with all of the attributes.

Parameters:
aCount - The number of messages that exist in the queue
aId - uniquely identify the message at the head of the queue
aQDate - date and time that the message was enqueued
aMsgNodeList - Mixed XML content for the message.
Method Detail

getCount

public java.lang.Long getCount()
Gets the number of messages that exist in the queue.

Returns:
Number of messages in the queue

setCount

public void setCount(java.lang.Long aCount)
Sets the number of messages that exist in the queue.

Parameters:
aCount - Number of messages in the queue

getId

public java.lang.String getId()
Gets the id that uniquely identifies the message at the head of the queue.

Returns:
id for message

setId

public void setId(java.lang.String aId)
Gets the id that uniquely identifies the message at the head of the queue.

Parameters:
aId - Message id

getQDate

public java.util.Date getQDate()
Gets the optional date and time that the message was enqueued.

Returns:
Date and time that the message was enqueued if defined; null otherwise.

setQDate

public void setQDate(java.util.Date aDate)
Sets the optional date and time that the message was enqueued.

Parameters:
aDate - The date and time that the message was enqueued

getLang

public java.lang.String getLang()
Gets the message language. The Language must be structured as documented in [RFC1766].

Returns:
Language of the message, with the default of DEFAULT_LANG.

setLang

public void setLang(java.lang.String aLang)
Sets the message language. The Language must be structured as documented in [RFC1766].

Parameters:
aLang - Language of the message.

getMsg

public java.lang.String getMsg()
Gets the optional human-readable message. The language defaults to DEFAULT_LANG, but the value can be retrieved with the getLang() method.

Returns:
the human-readable message if defined; null otherwise.

setMsg

public void setMsg(java.lang.String aMsg)
Sets the optional human-readable message. The language defaults to DEFAULT_LANG, but can be set with the setLang(String) method.

Parameters:
aMsg - human-readable message

getMsgNodeList

public org.w3c.dom.NodeList getMsgNodeList()
Gets the message DOM NodeList representing mixed XML content for the message. This is an alternative to using a simple String for the message.

Returns:
Message NodeList if defined;null otherwise

setMsgNodeList

public void setMsgNodeList(org.w3c.dom.NodeList aMsgNodeList)
Sets the message DOM NodeList representing mixed XML content for the message. This is an alternative to using a simple String for the message.

Parameters:
aMsgNodeList - NodeList containing mixed XML content

encode

public org.w3c.dom.Element encode(org.w3c.dom.Document aDocument)
                           throws EPPEncodeException
encode EPPMsgQueue into a DOM element tree.

Specified by:
encode in interface EPPCodecComponent
Parameters:
aDocument - Factory for DOM components
Returns:
<extValue> root element tree.
Throws:
EPPEncodeException - Error encoding the DOM element tree.

decode

public void decode(org.w3c.dom.Element aElement)
            throws EPPDecodeException
decode EPPMsgQueue from a DOM element tree. The aElement argument needs to be the "extValue" element.

Specified by:
decode in interface EPPCodecComponent
Parameters:
aElement - The "extValue" XML element.
Throws:
EPPDecodeException - Error decoding the DOM element tree.

equals

public boolean equals(java.lang.Object aObject)
implements a deep EPPMsgQueue compare.

Overrides:
equals in class java.lang.Object
Parameters:
aObject - EPPMsgQueue instance to compare with
Returns:
true if equal; false otherwise

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException
Clone EPPMsgQueue.

Specified by:
clone in interface EPPCodecComponent
Overrides:
clone in class java.lang.Object
Returns:
Deep copy clone of EPPMsgQueue
Throws:
java.lang.CloneNotSupportedException - standard Object.clone exception

toString

public java.lang.String toString()
Implementation of Object.toString, which will result in an indented XML String representation of the concrete EPPCodecComponent.

Overrides:
toString in class java.lang.Object
Returns:
Indented XML String if successful; ERROR otherwise.


Copyright ? VeriSign Inc. All Rights Reserved.