Class 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:

    • A "count" attribute that describes the number of messages that exist in the queue.
    • An "id" attribute used to uniquely identify the message at the head of the queue.
    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:

    • A <qDate> element that contains the date and time that the message was enqueued.
    • A <msg> element containing a human-readable message. The language of the response is identified via an OPTIONAL "lang" attribute. If not specified, the default attribute value MUST be "en" (English). This element MAY contain XML content for formatting purposes, but the XML content is not specified by the protocol and will thus not be processed for validity.
    See Also:
    Serialized Form
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.lang.String DEFAULT_LANG
      The default language of the reason "en".
    • Constructor Summary

      Constructors 
      Constructor Description
      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, java.lang.String aMsg)
      Allocates a new EPPMsgQueue with all of the 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.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      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.lang.String getNamespace()
      Returns the XML namespace associated with the EPPCodecComponent.
      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.
      • getNamespace

        public java.lang.String getNamespace()
        Returns the XML namespace associated with the EPPCodecComponent.
        Specified by:
        getNamespace in interface EPPCodecComponent
        Returns:
        XML namespace for the EPPCodecComponent.