Class EPPRegistryContact

java.lang.Object
com.verisign.epp.codec.registry.EPPRegistryContact
All Implemented Interfaces:
EPPCodecComponent, Serializable, Cloneable

public class EPPRegistryContact extends Object implements EPPCodecComponent
Represents the optional contact object policy information per RFC 5733. The <registry:contact> element contains the following child elements:
  • <registry:contactIdRegEx> - The OPTIONAL regular expression used to validate the <contact:id> element defined in RFC 5733.
  • <registry:sharePolicy> - The OPTIONAL policy for the sharing of contacts in the server. The possible shared policy values include:
    • "perZone" - The contacts are shared across all objects of the zone. There is a single pool of contacts defined for the zone.
    • "perSystem" - The contacts are shared across all zones of the system. There is a single pool of contacts across all of the zones supported by the system.
  • <registry:intSupport> - A boolean value that defines whether the server supports the internationalized form of postal-address information using the type="int" attribute of RFC 5733.
  • <registry:locSupport> - A boolean value that defines whether the server supports the localized form of postal-address information using the type="loc" attribute of RFC 5733.
  • <registry:postalInfo> - The postal-address information policy information.
  • <registry:maxCheckContact> - The maximum number of contact identifiers (<contact:id> elements) that can be included in a contact check command defined in RFC 5733.
  • <registry:authInfoRegex> - The OPTIONAL regular expression used to validate the contact object authorization information value.
  • <registry:clientDisclosureSupported> - The OPTIONAL flag that indicates whether the server supports the client to identify elements that require exception server-operator handling to allow or restrict disclosure to third parties defined in RFC 5733. Default value is false.
  • <registry:supportedStatus> - The OPTIONAL set of supported contact statuses defined in RFC 5733.
  • <registry:transferHoldPeriod> - The OPTIONAL period of time a contact object is in the pending transfer before the transfer is auto approved by the server. The <registry:transferHoldPeriod> element MUST have the "unit" attribute with the possible values of "y" for year, "m" for month, and "d" for day.
  • <registry:customData> - The OPTIONAL set of custom data using key, value pairs.
See Also:
  • Field Details

    • TYPE_PER_ZONE

      public static final String TYPE_PER_ZONE
      Constant for share policy where contacts are shared across all objects of the zone. There is a single pool of contacts defined for the zone.
      See Also:
    • TYPE_PER_SYSTEM

      public static final String TYPE_PER_SYSTEM
      Constant for share policy where contacts are shared across all zones of the system. There is a single pool of contacts across all of the zones supported by the system.
      See Also:
    • ELM_LOCALNAME

      public static final String ELM_LOCALNAME
      Constant for the status local name
      See Also:
    • ELM_NAME

      public static final String ELM_NAME
      Constant for the contact (prefix and local name)
      See Also:
    • ELM_CONTACT_ID_REGEX

      public static final String ELM_CONTACT_ID_REGEX
      XML local name for the contactIdRegex
      See Also:
    • ELM_SHARE_POLICY

      public static final String ELM_SHARE_POLICY
      XML local name for the sharePolicy
      See Also:
    • ELM_INT_SUPPORT

      public static final String ELM_INT_SUPPORT
      XML local name for the intSupport
      See Also:
    • ELM_LOC_SUPPORT

      public static final String ELM_LOC_SUPPORT
      XML local name for the locSupport
      See Also:
    • ELM_MAX_CHECK

      public static final String ELM_MAX_CHECK
      XML local name for the maxCheckContact
      See Also:
    • ELM_AUTH_INFO_REGEX

      public static final String ELM_AUTH_INFO_REGEX
      XML local name for the authInfoRegex
      See Also:
    • ELM_CUSTOM_DATA

      public static final String ELM_CUSTOM_DATA
      XML local name for the customData
      See Also:
    • ELM_CUSTOM_CLIENT_DISCLOSURE_SUPPORTED

      public static final String ELM_CUSTOM_CLIENT_DISCLOSURE_SUPPORTED
      XML local name for the clientDisclosureSupported
      See Also:
  • Constructor Details

    • EPPRegistryContact

      public EPPRegistryContact()
  • Method Details

    • encode

      public Element encode(Document aDocument) throws EPPEncodeException
      Encode a DOM Element tree from the attributes of the EPPRegistryContact instance.
      Specified by:
      encode in interface EPPCodecComponent
      Parameters:
      aDocument - DOM Document that is being built. Used as an Element factory.
      Returns:
      Element Root DOM Element representing the EPPRegistryContact instance.
      Throws:
      EPPEncodeException - - Unable to encode EPPRegistryContact instance.
    • decode

      public void decode(Element aElement) throws EPPDecodeException
      Decode the EPPRegistryContact attributes from the aElement DOM Element tree.
      Specified by:
      decode in interface EPPCodecComponent
      Parameters:
      aElement - Root DOM Element to decode EPPRegistryContact from.
      Throws:
      EPPDecodeException - Unable to decode aElement
    • clone

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

      public boolean equals(Object aObject)
      implements a deep EPPRegistryContact compare.
      Overrides:
      equals in class Object
      Parameters:
      aObject - EPPRegistryContact instance to compare with
      Returns:
      true if this object is the same as the aObject argument; false otherwise
    • 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.
    • getContactIdRegex

      public EPPRegistryRegex getContactIdRegex()
      Get info about regular expression used to validate the contact object contact Id value.
      Returns:
      instance of EPPRegistryRegex that specifies regular expression used to validate the domain object authorization information value
    • setContactIdRegex

      public void setContactIdRegex(EPPRegistryRegex aContactIdRegex)
      Set info about regular expression used to validate the contact object contact Id value.
      Parameters:
      aContactIdRegex - instance of EPPRegistryRegex that specifies regular expression used to validate the contact object contact Id value
    • getSharePolicy

      public String getSharePolicy()
      Gets the policy for the sharing of contacts in the server.
      Returns:
      TYPE_PER_ZONE to share contacts per zone, TYPE_PER_SYSTEM to share contact for all zones of the system if defined; null otherwise.
    • setSharePolicy

      public void setSharePolicy(String aSharePolicy)
      Sets the policy for the sharing of contacts in the server.
      Parameters:
      aSharePolicy - TYPE_PER_ZONE to share contacts per zone or TYPE_PER_SYSTEM to share contact for all zones of the system
    • getIntSupport

      public Boolean getIntSupport()
      Gets flag for internationalization support
      Returns:
      true if internationalized form of postal-address is supported. false otherwise
    • setIntSupport

      public void setIntSupport(Boolean intSupport)
      Sets flag for internationalization support
      Parameters:
      intSupport - true if internationalized form of postal-address is supported. false otherwise
    • getLocSupport

      public Boolean getLocSupport()
      Gets flag for localization support
      Returns:
      true if localized form of postal-address is supported. false otherwise
    • setLocSupport

      public void setLocSupport(Boolean locSupport)
      Sets flag for localization support
      Parameters:
      locSupport - true if localized form of postal-address is supported. false otherwise
    • getMaxCheckContact

      public Integer getMaxCheckContact()
      Gets maximum number of contacts allowed in the check command.
      Returns:
      maximum number of contact identifiers (<contact:id> elements) that can be included in a contact check command defined in RFC 5733
    • setMaxCheckContact

      public void setMaxCheckContact(Integer maxCheckContact)
      Gets maximum number of contacts allowed in the check command.
      Parameters:
      maxCheckContact - maximum number of contact identifiers (<contact:id> elements) that can be included in a contact check command defined in RFC 5733
    • getAuthInfoRegex

      public EPPRegistryRegex getAuthInfoRegex()
      Gets authInfo regular expression.
      Returns:
      regular expression used to validate the contact object authorization information value
    • setAuthInfoRegex

      public void setAuthInfoRegex(EPPRegistryRegex authInfoRegex)
      Gets authInfo regular expression.
      Parameters:
      authInfoRegex - regular expression used to validate the contact object authorization information value
    • getCustomData

      public EPPRegistryCustomData getCustomData()
      Gets set of custom data using key, value pairs.
      Returns:
      instance of EPPRegistryCustomData that gives users the ability to specify custom data with key/value pairs
    • setCustomData

      public void setCustomData(EPPRegistryCustomData customData)
      Set set of custom data using key, value pairs.
      Parameters:
      customData - instance of EPPRegistryCustomData that gives users the ability to specify custom data with key/value pairs
    • getPostalInfo

      public EPPRegistryPostal getPostalInfo()
      Gets postal-address information policy information.
      Returns:
      the postal-address information policy information
    • setPostalInfo

      public void setPostalInfo(EPPRegistryPostal postalInfo)
      Sets postal-address information policy information.
      Parameters:
      postalInfo - the postal-address information policy information
    • getClientDisclosureSupported

      public Boolean getClientDisclosureSupported()
      Gets client disclosure flag.
      Returns:
      true if the server supports the client to identify elements that require exception server-operator handling to allow or restrict disclosure to third parties defined in RFC 5733. false otherwise
    • setClientDisclosureSupported

      public void setClientDisclosureSupported(Boolean clientDisclosureSupported)
      Sets client disclosure flag.
      Parameters:
      clientDisclosureSupported - true if the server supports the client to identify elements that require exception server-operator handling to allow or restrict disclosure to third parties defined in RFC 5733. false otherwise
    • getSupportedStatus

      public EPPRegistrySupportedStatus getSupportedStatus()
      Gets a set of supported host statuses defined in RFC 5733.
      Returns:
      set of supported host statuses defined in RFC 5733
    • setSupportedStatus

      public void setSupportedStatus(EPPRegistrySupportedStatus supportedStatus)
      Sets a set of supported host statuses defined in RFC 5733.
      Parameters:
      supportedStatus - set of supported host statuses defined in RFC 5733
    • getTransferHoldPeriod

      public EPPRegistryTransferHoldPeriodType getTransferHoldPeriod()
      Get the period of time a contact object is in the pending transfer before the transfer is auto approved by the server
      Returns:
      instance of EPPRegistryTransferHoldPeriodType
    • setTransferHoldPeriod

      public void setTransferHoldPeriod(EPPRegistryTransferHoldPeriodType transferHoldPeriod)
      Set the period of time a contact object is in the pending transfer before the transfer is auto approved by the server
      Parameters:
      transferHoldPeriod - instance of EPPRegistryTransferHoldPeriodType
    • getNamespace

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