com.verisign.epp.codec.domain

Class EPPDomainPeriod

java.lang.Object

com.verisign.epp.codec.domain.EPPDomainPeriod

All Implemented Interfaces:

EPPCodecComponent, java.io.Serializable, java.lang.Cloneable

public class EPPDomainPeriod
extends java.lang.Object
implements EPPCodecComponent

Represents a domain Period. A domain name object MAY have a specified validity period. If server policy supports domain object validity periods, the validity period is defined when a domain object is created, and it MAY be extended by the EPP <renew> or <transfer> commands. As a matter of server policy, this specification does not define actions to be taken upon expiration of a domain object's validity period.

Validity periods are measured in years or months with the appropriate units specified using the unit attribute. Valid values for the unit attribute are y for years and m for months.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ELM_LOCALNAME XML local name for EPPDomainPeriod.
static java.lang.String	ELM_NAME XML Element Name of EPPDomainPeriod root element.
static java.lang.String	PERIOD_UNIT_MONTH Period in Unit Month
static java.lang.String	PERIOD_UNIT_YEAR Period in Unit Year

Constructor Summary

Constructors

Constructor and Description
EPPDomainPeriod() EPPDomainPeriod default constructor.
EPPDomainPeriod(int aPeriod) EPPDomainPeriod constructor that takes the domain period (in unit of year) as an argument
EPPDomainPeriod(java.lang.String aPUnit, int aPeriod) EPPDomainPeriod constructor that takes the domain period and period unit as an arguments

Method Summary

Modifier and Type	Method and Description
java.lang.Object	clone() Clone EPPDomainPeriod.
void	decode(org.w3c.dom.Element aElement) Decode the EPPDomainPeriod attributes from the aElement DOM Element tree.
org.w3c.dom.Element	encode(org.w3c.dom.Document aDocument) Encode a DOM Element tree from the attributes of the EPPDomainPeriod instance.
boolean	equals(java.lang.Object aObject) implements a deep EPPDomainPeriod compare.
java.lang.String	getNamespace() Returns the XML namespace associated with the EPPCodecComponent.
int	getPeriod() Get domain period.
java.lang.String	getPUnit() Get domain period unit.
boolean	isPeriodUnspec() Test whether the period has been specfied: true is unspecified and false is specified.
void	setPeriod(int newPeriod) Set domain period.
void	setPUnit(java.lang.String newPUnit) Set domain period of un.
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

ELM_LOCALNAME

public static final java.lang.String ELM_LOCALNAME

XML local name for EPPDomainPeriod.

See Also:

Constant Field Values

ELM_NAME

public static final java.lang.String ELM_NAME

XML Element Name of EPPDomainPeriod root element.

See Also:

Constant Field Values

PERIOD_UNIT_MONTH

public static final java.lang.String PERIOD_UNIT_MONTH

Period in Unit Month

See Also:

Constant Field Values

PERIOD_UNIT_YEAR

public static final java.lang.String PERIOD_UNIT_YEAR

Period in Unit Year

See Also:

Constant Field Values

Constructor Detail

EPPDomainPeriod

public EPPDomainPeriod()

EPPDomainPeriod default constructor. The period is initialized to unspecified. The period must be set before invoking encode.

EPPDomainPeriod

public EPPDomainPeriod(int aPeriod)

EPPDomainPeriod constructor that takes the domain period (in unit of year) as an argument

Parameters:

aPeriod - int

EPPDomainPeriod

public EPPDomainPeriod(java.lang.String aPUnit,
                       int aPeriod)

EPPDomainPeriod constructor that takes the domain period and period unit as an arguments

Parameters:

aPUnit - String

aPeriod - int

Method Detail

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

Clone EPPDomainPeriod.

Specified by:

clone in interface EPPCodecComponent

Overrides:

clone in class java.lang.Object

Returns:

clone of EPPDomainPeriod

Throws:

java.lang.CloneNotSupportedException - standard Object.clone exception

decode

public void decode(org.w3c.dom.Element aElement)
            throws EPPDecodeException

Decode the EPPDomainPeriod attributes from the aElement DOM Element tree.

Specified by:

decode in interface EPPCodecComponent

Parameters:

aElement - - Root DOM Element to decode EPPDomainPeriod from.

Throws:

EPPDecodeException - Unable to decode aElement

encode

public org.w3c.dom.Element encode(org.w3c.dom.Document aDocument)
                           throws EPPEncodeException

Encode a DOM Element tree from the attributes of the EPPDomainPeriod 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 EPPDomainPeriod instance.

Throws:

EPPEncodeException - - Unable to encode EPPDomainPeriod instance.

equals

public boolean equals(java.lang.Object aObject)

implements a deep EPPDomainPeriod compare.

Overrides:

equals in class java.lang.Object

Parameters:

aObject - EPPDomainPeriod instance to compare with

Returns:

true if equal; false otherwise.

getPeriod

public int getPeriod()

Get domain period.

Returns:

int

getPUnit

public java.lang.String getPUnit()

Get domain period unit.

Returns:

String

isPeriodUnspec

public boolean isPeriodUnspec()

Test whether the period has been specfied: true is unspecified and false is specified.

Returns:

boolean

setPeriod

public void setPeriod(int newPeriod)
               throws EPPCodecException

Set domain period.

Parameters:

newPeriod - int

Throws:

EPPCodecException - DOCUMENT ME!

setPUnit

public void setPUnit(java.lang.String newPUnit)

Set domain period of un. Creation date: (5/30/01 11:36:52 AM)

Parameters:

newPUnit - java.lang.String

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.