Package com.verisign.epp.codec.registry
Class EPPRegistryDomain
java.lang.Object
com.verisign.epp.codec.registry.EPPRegistryDomain
- All Implemented Interfaces:
EPPCodecComponent,Serializable,Cloneable
Represents the domain name object policy information per RFC 5731. Instance
of this class is encoded into the <registry:domain> element in the
<registry:zone> element when the server responds with the detailed
information of the zone object. The <registry:domain> must contain the
following child elements:
- <registry:domainName> - The domain name object policy information
per RFC 5731. Use
getDomainNames()andsetDomainNames(List)to get and set the element. - <registry:idn> - OPTIONAL Internationalized Domain Name (IDN)
policy information. Use
getIdn()andsetIdn(EPPRegistryIDN)to get and set the element. - <registry:premiumSupport> - OPTIONAL boolean value that indicates
whether the server supports premium domain names. Default value is
false. UsegetPremiumSupport()andsetPremiumSupport(Boolean)to get and set the element. - <registry:contactsSupported> - OPTIONAL boolean value that
indicates whether contacts are supported. Default value is
true. UsegetContactsSupported()andsetContactsSupported(Boolean)to get and set the element. - <registry:contact> - Zero to three elements that define the minimum
and maximum numbers of contacts by contact type. Valid contact types are:
admin, tech and billing. Use
getContacts()andsetContacts(List)to get and set the element. UseaddContact(EPPRegistryDomainContact)to append a contact to the existing contact list. - <registry:ns> - Defines the minimum and maximum number of delegated
host objects (name servers) that can be associated with a domain object. Use
getNameServerLimit()andsetNameServerLimit(EPPRegistryDomainNSLimit)to get and set the element. - <registry:childHost> - Defines the minimum and maximum number of
subordinate host objects (child hosts) for a domain object. Use
getChildHostLimit()andsetChildHostLimit(EPPRegistryDomainHostLimit)to get and set the element. - <registry:period> - Zero or more elements that defines the
supported min/max registration periods and default periods by command type.
The required "command" attribute defines the command type with sample values
of "create", "renew", and "transfer". Use
getPeriods()andsetPeriods(List)to get and set the element. - <registry:transferHoldPeriod> - The period of time a domain object
is in the pending transfer before the transfer is auto approved by the
server. This element MUST have the "unit" attribute with the possible values
of "y" for year, "m" for month, and "d" for day. Use
getTransferHoldPeriod()andsetTransferHoldPeriod(EPPRegistryTransferHoldPeriodType)to get and set the element. - <registry:gracePeriod> - Zero or more elements that defines the
grace periods by operation type. The required "command" attribute defines the
operation type with the sample values of "create", "renew", "transfer", and
"autoRenew". This element requires the "unit" attribute with the possible
values of "d" for day, "h" for hour, and "m" for minute. Use
getGracePeriods()andsetGracePeriods(List)to get and set the element. - <registry:rgp> - OPTIONAL Registry Grace Period (RGP) status
periods. Use
getRgp()andsetRgp(EPPRegistryRGP)to get and set the element. - <registry:dnssec> - OPTIONAL DNS Security Extensions (DNSSEC)
policies for the server. Use
getDnssec()andsetDnssec(EPPRegistryDNSSEC)to get and set the element. - <registry:maxCheckDomain> - The maximum number of domain names
(<domain:name> elements) that can be included in a domain check command
defined in RFC 5731 Use
setMaxCheckDomain(Integer)andgetMaxCheckDomain()to get and set the element. - <registry:supportedStatus> - The OPTIONAL set of supported domain
status defined in RFC 5731 Use
getSupportedStatus()andsetSupportedStatus(EPPRegistrySupportedStatus)to get and set the element. - <registry:authInfoRegEx> - The OPTIONAL regular expression used to
validate the domain object authorization information value. Use
getAuthInfoRegex()andsetAuthInfoRegex(EPPRegistryRegex)to get and set the element. - <registry:customDate> - The OPTIONAL set of custom data using key,
value pairs. Use
getCustomData()andsetCustomData(EPPRegistryCustomData)to get and set the element.
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringXML Element Name ofauthInfoRegexattribute.static final StringXML Element Name ofmaxCheckDomainattribute.static final StringXML Element Name ofEPPRegistryDomainroot element.static final StringXML Element Name ofpremiumSupportattribute.static final StringXML Element Name ofcontactsSupportedattribute.static final StringDeprecated. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidaddContact(EPPRegistryDomainContact contact) Append a domain contact policy to the existing list.voidaddDomainName(EPPRegistryDomainName aDomainName) Add a domain name object policy to the list of domain name policies.voidaddGracePeriod(EPPRegistryGracePeriod gracePeriod) Append one instance ofEPPRegistryGracePeriodto the existingList.voidaddPeriod(EPPRegistryDomainPeriod period) clone()CloneEPPRegistryDomain.voidDecode theEPPRegistryDomainattributes from the aElement DOM Element tree.Encode a DOM Element tree from the attributes of theEPPRegistryDomaininstance.booleanimplements a deepEPPRegistryDomaincompare.Get info about regular expression used to validate the domain object authorization information value.Get child host limit.Get domain contact policy.Get the contact supported flag.Get set of custom data using key, value pairs.Get the DNS Security Extensions (DNSSEC) policies.Get theListofEPPRegistryDomainNamethat specifies the domain name object policy.Get theListof attributes that defines the grace periods by operation type.getIdn()Get the Internationalized Domain Name (IDN) policy information.Get the attribute that defines the maximum number of domain names (<domain:name> elements) that can be included in a domain check command defined in RFC 5731.Get NS limit definition.Returns the XML namespace associated with theEPPCodecComponent.GetListofEPPRegistryDomainPeriodinstances that define the supported min/max/default registration periods by command type.Get premium support flag.getRgp()Get the information about Registry Grace Period (RGP).Get domain status supported by the server.Get the period of time a domain object is in the pending transfer before the transfer is auto approved by the servervoidsetAuthInfoRegex(EPPRegistryRegex authInfoRegex) Set info about regular expression used to validate the domain object authorization information value.voidsetChildHostLimit(EPPRegistryDomainHostLimit childHostLimit) Set child host limit.voidsetContacts(List contacts) Set domain contact policy.voidsetContactsSupported(Boolean contactsSupported) Set the contact supported flag.voidsetCustomData(EPPRegistryCustomData customData) Set set of custom data using key, value pairs.voidsetDnssec(EPPRegistryDNSSEC dnssec) Set the DNS Security Extensions (DNSSEC) policies.voidsetDomainNames(List domainNames) Set theListofEPPRegistryDomainNamethat specifies the domain name object policy.voidsetGracePeriods(List gracePeriods) Set theListof attributes that defines the grace periods by operation type.voidsetIdn(EPPRegistryIDN idn) Set the Internationalized Domain Name (IDN) policy information.voidsetMaxCheckDomain(Integer maxCheckDomain) Set the attribute that defines the maximum number of domain names (<domain:name> elements) that can be included in a domain check command defined in RFC 5731.voidsetNameServerLimit(EPPRegistryDomainNSLimit nameServerLimit) Set NS limit definition.voidsetPeriods(List periods) SetListofEPPRegistryDomainPeriodinstances that define the supported min/max/default registration periods by command type.voidsetPremiumSupport(Boolean premiumSupport) Set premium support flag.voidsetRgp(EPPRegistryRGP rgp) Set the information about Registry Grace Period (RGP).voidsetSupportedStatus(EPPRegistrySupportedStatus supportedStatus) Set domain status supported by the server.voidsetTransferHoldPeriod(EPPRegistryTransferHoldPeriodType transferHoldPeriod) Set the period of time a domain object is in the pending transfer before the transfer is auto approved by the servertoString()Implementation ofObject.toString, which will result in an indented XMLStringrepresentation of the concreteEPPCodecComponent.
-
Field Details
-
ELM_NAME
XML Element Name ofEPPRegistryDomainroot element.- See Also:
-
ELM_PREMIUM_SUPPORT
XML Element Name ofpremiumSupportattribute.- See Also:
-
ELM_REGISTRANT
XML Element Name ofcontactsSupportedattribute.- See Also:
-
ELM_URGENT
Deprecated.XML Element Name ofurgentattribute.- See Also:
-
ELM_MAX_CHECK_DOMAIN
XML Element Name ofmaxCheckDomainattribute.- See Also:
-
ELM_AUTH_INFO_REGEX
XML Element Name ofauthInfoRegexattribute.- See Also:
-
-
Constructor Details
-
EPPRegistryDomain
public EPPRegistryDomain()
-
-
Method Details
-
encode
Encode a DOM Element tree from the attributes of theEPPRegistryDomaininstance.- Specified by:
encodein interfaceEPPCodecComponent- Parameters:
aDocument- DOM Document that is being built. Used as an Element factory.- Returns:
- Element Root DOM Element representing the
EPPRegistryDomaininstance. - Throws:
EPPEncodeException- - Unable to encodeEPPRegistryDomaininstance.
-
decode
Decode theEPPRegistryDomainattributes from the aElement DOM Element tree.- Specified by:
decodein interfaceEPPCodecComponent- Parameters:
aElement- Root DOM Element to decodeEPPRegistryDomainfrom.- Throws:
EPPDecodeException- Unable to decode aElement
-
equals
implements a deepEPPRegistryDomaincompare. -
clone
CloneEPPRegistryDomain.- Specified by:
clonein interfaceEPPCodecComponent- Overrides:
clonein classObject- Returns:
- clone of
EPPRegistryDomain - Throws:
CloneNotSupportedException- standard Object.clone exception
-
toString
Implementation ofObject.toString, which will result in an indented XMLStringrepresentation of the concreteEPPCodecComponent. -
addDomainName
Add a domain name object policy to the list of domain name policies.- Parameters:
aDomainName- Domain name policy to add
-
getDomainNames
Get theListofEPPRegistryDomainNamethat specifies the domain name object policy.- Returns:
- the
ListofEPPRegistryDomainNamethat specifies the domain name object policy
-
setDomainNames
Set theListofEPPRegistryDomainNamethat specifies the domain name object policy.- Parameters:
domainNames- theListofEPPRegistryDomainNamethat specifies the domain name object policy
-
getIdn
Get the Internationalized Domain Name (IDN) policy information.- Returns:
- Internationalized Domain Name (IDN) policy information
-
setIdn
Set the Internationalized Domain Name (IDN) policy information.- Parameters:
idn- the Internationalized Domain Name (IDN) policy information.
-
getPremiumSupport
Get premium support flag.- Returns:
- flag that indicates whether the server supports premium domain names
-
setPremiumSupport
Set premium support flag.- Parameters:
premiumSupport- flag that indicates whether the server supports premium domain names
-
getContactsSupported
Get the contact supported flag.- Returns:
- flag that indicates whether contacts are supported
-
setContactsSupported
Set the contact supported flag.- Parameters:
contactsSupported- flag that indicates whether contacts are supported
-
getContacts
Get domain contact policy.- Returns:
Listof domain contact policy
-
setContacts
Set domain contact policy.- Parameters:
contacts-Listof domain contact policy
-
addContact
Append a domain contact policy to the existing list.- Parameters:
contact- domain contact policy for one of the "admin", "tech", or "billing" contact.
-
getNameServerLimit
Get NS limit definition.- Returns:
- instance of
EPPRegistryDomainNSLimitthat defines min/max number of delegated host objects (name servers) that can be associated with a domain object
-
setNameServerLimit
Set NS limit definition.- Parameters:
nameServerLimit- instance ofEPPRegistryDomainNSLimitthat defines min/max number of delegated host objects (name servers) that can be associated with a domain object
-
getChildHostLimit
Get child host limit.- Returns:
- Instance of
EPPRegistryDomainHostLimitthat defines the minimum and maximum number of subordinate host objects (child hosts) for a domain object.
-
setChildHostLimit
Set child host limit.- Parameters:
childHostLimit- Instance ofEPPRegistryDomainHostLimitthat defines the minimum and maximum number of subordinate host objects (child hosts) for a domain object.
-
getPeriods
GetListofEPPRegistryDomainPeriodinstances that define the supported min/max/default registration periods by command type. Command type must be one of "create, "renew" and "transfer".- Returns:
ListofEPPRegistryDomainPeriodinstances
-
setPeriods
SetListofEPPRegistryDomainPeriodinstances that define the supported min/max/default registration periods by command type. Command type must be one of "create, "renew" and "transfer".- Parameters:
periods-ListofEPPRegistryDomainPeriodinstances
-
addPeriod
-
getTransferHoldPeriod
Get the period of time a domain object is in the pending transfer before the transfer is auto approved by the server- Returns:
- instance of
EPPRegistryTransferHoldPeriodType
-
setTransferHoldPeriod
Set the period of time a domain object is in the pending transfer before the transfer is auto approved by the server- Parameters:
transferHoldPeriod- instance ofEPPRegistryTransferHoldPeriodType
-
getGracePeriods
Get theListof attributes that defines the grace periods by operation type.- Returns:
ListofEPPRegistryGracePeriod
-
setGracePeriods
Set theListof attributes that defines the grace periods by operation type.- Parameters:
gracePeriods-ListofEPPRegistryGracePeriod
-
addGracePeriod
Append one instance ofEPPRegistryGracePeriodto the existingList.- Parameters:
gracePeriod- instance ofEPPRegistryGracePeriod
-
getRgp
Get the information about Registry Grace Period (RGP).- Returns:
- instance of
EPPRegistryRGP.
-
setRgp
Set the information about Registry Grace Period (RGP).- Parameters:
rgp- instance ofEPPRegistryRGP.
-
getDnssec
Get the DNS Security Extensions (DNSSEC) policies.- Returns:
- instance of
EPPRegistryDNSSECthat defines the DNS Security Extensions (DNSSEC) policies.
-
setDnssec
Set the DNS Security Extensions (DNSSEC) policies.- Parameters:
dnssec- instance ofEPPRegistryDNSSECthat defines the DNS Security Extensions (DNSSEC) policies.
-
getMaxCheckDomain
Get the attribute that defines the maximum number of domain names (<domain:name> elements) that can be included in a domain check command defined in RFC 5731.- Returns:
- maximum number of domain names (<domain:name> elements) that can be included in a domain check command defined in RFC 5731.
-
setMaxCheckDomain
Set the attribute that defines the maximum number of domain names (<domain:name> elements) that can be included in a domain check command defined in RFC 5731.- Parameters:
maxCheckDomain- maximum number of domain names (<domain:name> elements) that can be included in a domain check command defined in RFC 5731.
-
getCustomData
Get set of custom data using key, value pairs.- Returns:
- instance of
EPPRegistryCustomDatathat gives users the ability to specify custom data with key/value pairs
-
setCustomData
Set set of custom data using key, value pairs.- Parameters:
customData- instance ofEPPRegistryCustomDatathat gives users the ability to specify custom data with key/value pairs
-
getAuthInfoRegex
Get info about regular expression used to validate the domain object authorization information value.- Returns:
- instance of
EPPRegistryRegexthat specifies regular expression used to validate the domain object authorization information value
-
setAuthInfoRegex
Set info about regular expression used to validate the domain object authorization information value.- Parameters:
authInfoRegex- instance ofEPPRegistryRegexthat specifies regular expression used to validate the domain object authorization information value
-
getSupportedStatus
Get domain status supported by the server.- Returns:
- instance of
EPPRegistrySupportedStatusthat contains a list of supported domain status by the server
-
setSupportedStatus
Set domain status supported by the server.- Parameters:
supportedStatus- instance ofEPPRegistrySupportedStatusthat contains a list of supported domain status by the server
-
getNamespace
Returns the XML namespace associated with theEPPCodecComponent.- Specified by:
getNamespacein interfaceEPPCodecComponent- Returns:
- XML namespace for the
EPPCodecComponent.
-
urgentattribute.