Package com.verisign.epp.codec.emailFwd

Class EPPEmailFwdTransferCmd

java.lang.Object
com.verisign.epp.codec.gen.EPPCommand
com.verisign.epp.codec.gen.EPPTransferCmd
com.verisign.epp.codec.emailFwd.EPPEmailFwdTransferCmd
All Implemented Interfaces:
EPPCodecComponent, EPPMessage, Serializable, Cloneable
public class EPPEmailFwdTransferCmd extends EPPTransferCmd
Represents an EPP EmailFwd <transfer> command. The EPP <transfer> command provides a query operation that allows a client to determine real-time status of pending and completed transfer requests. In addition to the standard EPPhttp://www.niscom.nic.in/NISTXT/services/Ser1AA.htm command elements, the <transfer> command MUST contain an op attribute with value query, and a <emailFwd:transfer> element that identifies the emailFwd namespace and the location of the emailFwd schema. The <emailFwd:transfer> element SHALL contain the following child elements:

  • A <emailFwd:name> element that contains the fully qualified emailFwd name of the object for which a transfer request is to be created, approved, rejected, or cancelled. Use getName and setName to get and set the element.
  • An OPTIONAL <emailFwd:period> element that contains the initial registration period of the emailFwd object. Use getPeriod and setPeriod to get and set the element. If return null, period has not been specified yet.
  • An "op" attribute that identifies the transfer operation to be performed. Valid values, definitions, and authorizations for all attribute values are defined in [EPP]. Use getOp and setOp to get and set the element. One of the EPPCommand.OP_ constants need to be specified.
  • A <emailFwd:authInfo> element that contains authorization information associated with the emailFwd object or authorization information associated with the emailFwd object's registrant or associated contacts. This element is REQUIRED only when a transfer is requested, and it SHALL be ignored if used otherwise. Use getAuthInfo and setAuthInfo to get and set the element.


EPPEmailFwdTransferResp is the concrete EPPReponse associated with EPPEmailFwdTransferCmd.
See Also:

  • Constructor Details

    • EPPEmailFwdTransferCmd

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

      • name is set to null
      • period is set to null
      • authInfo is set to to null

      The transaction ID, operation, name, and authInfo must be set before invoking encode.

    • EPPEmailFwdTransferCmd

      public EPPEmailFwdTransferCmd(String aTransId, String aOp, String aName)
      EPPEmailFwdTransferCmd constructor that takes the required attributes as arguments. The period attribute is set to UNSPEC_PERIOD and will not be included when encode is invoked.
      Parameters:
      aTransId - Transaction Id associated with the command.
      aOp - One of the EPPCommand.OP_ constants associated with the transfer command.
      aName - EmailFwd name to create.

    • EPPEmailFwdTransferCmd

      public EPPEmailFwdTransferCmd(String aTransId, String aOp, String aName, EPPAuthInfo aAuthInfo, EPPEmailFwdPeriod aPeriod)
      EPPEmailFwdTransferCmd constructor that takes the required attributes plus the optional attibute aPeriod.
      Parameters:
      aTransId - Transaction Id associated with the command.
      aOp - One of the EPPCommand.OP_ constants associated with the transfer command.
      aName - EmailFwd name to create.
      aAuthInfo - Authorization Information for operating with the emailFwd.
      aPeriod - Registration period to be added to the emailFwd upon transfer.

  • Method Details

    • getNamespace

      public String getNamespace()
      Gets the EPP command Namespace associated with EPPEmailFwdTransferCmd.
      Specified by:
      getNamespace in interface EPPCodecComponent
      Specified by:
      getNamespace in interface EPPMessage
      Specified by:
      getNamespace in class EPPCommand
      Returns:
      EPPEmailFwdMapFactory.NS

    • getKey

      public String getKey()
      Gets the key for the emailFwd object, which is the emailFwd name.
      Overrides:
      getKey in class EPPCommand
      Returns:
      The emailFwd name if set; null otherwise.

    • doEncode

      protected Element doEncode(Document aDocument) throws EPPEncodeException
      Encode a DOM Element tree from the attributes of the EPPEmailFwdTransferCmd instance.
      Specified by:
      doEncode in class EPPTransferCmd
      Parameters:
      aDocument - DOM Document that is being built. Used as an Element factory.
      Returns:
      Root DOM Element representing the EPPEmailFwdTransferCmd instance.
      Throws:
      EPPEncodeException - Unable to encode EPPEmailFwdTransferCmd instance.

    • doDecode

      protected void doDecode(Element aElement) throws EPPDecodeException
      Decode the EPPEmailFwdTransferCmd attributes from the aElement DOM Element tree.
      Specified by:
      doDecode in class EPPTransferCmd
      Parameters:
      aElement - Root DOM Element to decode EPPEmailFwdTransferCmd from.
      Throws:
      EPPDecodeException - Unable to decode aElement

    • getName

      public String getName()
      Gets the emailFwd name to query.
      Returns:
      EmailFwd Name if defined; null otherwise.

    • setName

      public void setName(String aName)
      Sets the emailFwd name to query.
      Parameters:
      aName - EmailFwd Name

    • equals

      public boolean equals(Object aObject)
      Compare an instance of EPPEmailFwdTransferCmd with this instance.
      Overrides:
      equals in class EPPTransferCmd
      Parameters:
      aObject - Object to compare with.
      Returns:
      DOCUMENT ME!

    • clone

      public Object clone() throws CloneNotSupportedException
      Clone EPPEmailFwdTransferCmd.
      Specified by:
      clone in interface EPPCodecComponent
      Overrides:
      clone in class EPPTransferCmd
      Returns:
      clone of EPPEmailFwdTransferCmd
      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 EPPCommand
      Returns:
      Indented XML String if successful; ERROR otherwise.

    • getAuthInfo

      public EPPAuthInfo getAuthInfo()
      Get authorization Information.
      Returns:
      com.verisign.epp.codec.emailFwd.EPPAuthInfo

    • getPeriod

      public EPPEmailFwdPeriod getPeriod()
      Gets the registration period of the transfer command in years.
      Returns:
      Registration Period in years if defined; null otherwise.

    • setAuthInfo

      public void setAuthInfo(EPPAuthInfo newAuthInfo)
      Set authorization information.
      Parameters:
      newAuthInfo - com.verisign.epp.codec.emailFwd.EPPAuthInfo

    • setPeriod

      public void setPeriod(EPPEmailFwdPeriod aPeriod)
      Sets the registration period of the transfer command.
      Parameters:
      aPeriod - Registration Period.