Class EPPGreeting

java.lang.Object
com.verisign.epp.codec.gen.EPPGreeting
All Implemented Interfaces:
EPPCodecComponent, EPPMessage, Serializable, Cloneable

public class EPPGreeting extends Object implements EPPMessage
Represents an EPP Greeting message, which an EPP server uses in response to a successful connection from an EPP client. The EPP Greeting contains the following elements:
  • A <greeting> element that identifies the start of the greeting.
  • A <svID> element that contains the name of the server. Use getServer and setServer to get and set the element.
  • A <svDate> element that contains the server's current date and time in UTC. Use getServerDate and setServerData to get and set the element.
  • A <svcMenu> element that identifies the features supported by the server. Use getServiceMenu and setServiceMenu to get and set the element.
See Also:
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final short
    Maximum length of the server attribute.
    static final short
    Minimum length of the server attribute.
  • Constructor Summary

    Constructors
    Constructor
    Description
    Allocates a new EPPGreeting with default attribute values.
    EPPGreeting(String aServer, Date aServerDate, EPPServiceMenu aServiceMenu)
    Allocates a new EPPGreeting and sets all of the instance attributes with the arguments.
    EPPGreeting(String aServer, Date aServerDate, EPPServiceMenu aServiceMenu, EPPDcp aDcp)
    Allocates a new EPPGreeting and sets the name and service menu instance attributes with the arguments.
  • Method Summary

    Modifier and Type
    Method
    Description
    Clone EPPGreeting.
    void
    decode(Element aElement)
    decode EPPGreeting from a DOM element tree.
    encode(Document aDocument)
    encode EPPGreeting into a DOM element tree.
    boolean
    equals(Object aObject)
    implements a deep EPPGreeting compare.
    Gets the DataCollection policy associated with the server
    Gets the associated EPP namespace.
    Gets the name of the server.
    Gets the server current date and time.
    Gets the service menu associated with the greeting, which defines the features supported by the server.
    boolean
    hasExtensionService(String aNamespaceURI)
    Does the greeting extension services include a specified extension service based on the Namespace URI?
    boolean
    hasService(String aNamespaceURI)
    Does the greeting include a specified service based on the Namespace URI?
    void
    setDcp(EPPDcp aDcp)
    Sets the DataCollectionPolciy associated with the greeting, which defines the access and statement supported by the server.
    void
    setServer(String aServer)
    Sets the name of the server.
    void
    setServerDate(Date aServerDate)
    Sets the server current date and time.
    void
    Sets the service menu associated with the greeting, which defines the features supported by the server.
    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 Details

    • MIN_SERVER_LEN

      public static final short MIN_SERVER_LEN
      Minimum length of the server attribute.
      See Also:
    • MAX_SERVER_LEN

      public static final short MAX_SERVER_LEN
      Maximum length of the server attribute.
      See Also:
  • Constructor Details

    • EPPGreeting

      public EPPGreeting()
      Allocates a new EPPGreeting with default attribute values. The defaults include the following:

      • server is set to null
      • server date is set to now
      • service menu is allocated with the default EPPServiceMenu constructor

      setServer needs to be called before encode when using this constructor.
    • EPPGreeting

      public EPPGreeting(String aServer, Date aServerDate, EPPServiceMenu aServiceMenu, EPPDcp aDcp)
      Allocates a new EPPGreeting and sets the name and service menu instance attributes with the arguments. The server date is defaulted to now.
      Parameters:
      aServer - name of the server
      aServerDate - current server date and time
      aServiceMenu - service menu instance associated with the greeting
      aDcp - Dcp instance associated with the greeting
    • EPPGreeting

      public EPPGreeting(String aServer, Date aServerDate, EPPServiceMenu aServiceMenu)
      Allocates a new EPPGreeting and sets all of the instance attributes with the arguments.
      Parameters:
      aServer - name of the server
      aServerDate - current server date and time
      aServiceMenu - service menu instance associated with the greeting
  • Method Details

    • getNamespace

      public String getNamespace()
      Gets the associated EPP namespace. The general EPP namespace is returned, which is defined as EPPCodec.NS.
      Specified by:
      getNamespace in interface EPPCodecComponent
      Specified by:
      getNamespace in interface EPPMessage
      Returns:
      namespace URI
    • getServer

      public String getServer()
      Gets the name of the server. The server length is >= MIN_SERVER_LEN and <= MAX_SERVER_LEN.
      Returns:
      server String instance if defined; null otherwise.
    • setServer

      public void setServer(String aServer)
      Sets the name of the server. The server must be >= MIN_SERVER_LEN and <= MAX_SERVER_LEN.
      Parameters:
      aServer - unique server name.
    • getServerDate

      public Date getServerDate()
      Gets the server current date and time.
      Returns:
      Current server data and time.
    • setServerDate

      public void setServerDate(Date aServerDate)
      Sets the server current date and time.
      Parameters:
      aServerDate - Current server data and time.
    • getServiceMenu

      public EPPServiceMenu getServiceMenu()
      Gets the service menu associated with the greeting, which defines the features supported by the server.
      Returns:
      service menu instance associated with the greeting.
    • hasService

      public boolean hasService(String aNamespaceURI)
      Does the greeting include a specified service based on the Namespace URI?
      Parameters:
      aNamespaceURI - Service Namespace URI to search for
      Returns:
      true if the greeting includes the service Namespace URI; false otherwise.
    • hasExtensionService

      public boolean hasExtensionService(String aNamespaceURI)
      Does the greeting extension services include a specified extension service based on the Namespace URI?
      Parameters:
      aNamespaceURI - Extension service Namespace URI to search for
      Returns:
      true if the greeting extension services include the extension service Namespace URI; false otherwise.
    • setServiceMenu

      public void setServiceMenu(EPPServiceMenu aServiceMenu)
      Sets the service menu associated with the greeting, which defines the features supported by the server.
      Parameters:
      aServiceMenu - service menu instance to associate with the greeting.
    • setDcp

      public void setDcp(EPPDcp aDcp)
      Sets the DataCollectionPolciy associated with the greeting, which defines the access and statement supported by the server.
      Parameters:
      aDcp - service menu instance to associate with the greeting.
    • getDcp

      public EPPDcp getDcp()
      Gets the DataCollection policy associated with the server
      Returns:
      DataCollectionPolicy instance associated with the greeting.
    • encode

      public Element encode(Document aDocument) throws EPPEncodeException
      encode EPPGreeting into a DOM element tree. The <greeting> element is created and the attribute nodes are appended as children.
      Specified by:
      encode in interface EPPCodecComponent
      Parameters:
      aDocument - DOM Document to create elements from
      Returns:
      <greeting> root element tree.
      Throws:
      EPPEncodeException - Error encoding the DOM element tree.
    • decode

      public void decode(Element aElement) throws EPPDecodeException
      decode EPPGreeting from a DOM element tree. The "greeting" element needs to be the value of the aElement argument.
      Specified by:
      decode in interface EPPCodecComponent
      Parameters:
      aElement - <greeting> root element tree.
      Throws:
      EPPDecodeException - Error decoding the DOM element tree.
    • equals

      public boolean equals(Object aObject)
      implements a deep EPPGreeting compare.
      Overrides:
      equals in class Object
      Parameters:
      aObject - EPPGreeting instance to compare with
      Returns:
      true if equal; false otherwise.
    • clone

      public Object clone() throws CloneNotSupportedException
      Clone EPPGreeting.
      Specified by:
      clone in interface EPPCodecComponent
      Overrides:
      clone in class Object
      Returns:
      clone of EPPGreeting
      Throws:
      CloneNotSupportedException - standard Object.clone exception
    • toString

      public String toString()
      Implementation of Object.toString, which will result in an indented XML String representation of the concrete EPPCodecComponent.
      Overrides:
      toString in class Object
      Returns:
      Indented XML String if successful; ERROR otherwise.