com.ausregistry.jtoolkit2.se

Class AuDomainCreateCommandV1

java.lang.Object

com.ausregistry.jtoolkit2.se.Command

com.ausregistry.jtoolkit2.se.ObjectCommand

com.ausregistry.jtoolkit2.se.CreateCommand

com.ausregistry.jtoolkit2.se.DomainCreateCommand

com.ausregistry.jtoolkit2.se.AuDomainCreateCommandV1

All Implemented Interfaces:

java.io.Serializable

public final class AuDomainCreateCommandV1
extends DomainCreateCommand

Extension of EPP urn:ietf:params:xml:ns:domain-1.0 create command specified in RFC5731 to urn:au:params:xml:ns:auext-1.0. .au domains must be provisioned using this class rather than DomainCreateCommand, as the au extension data is mandatory. Use this class to generate a standards-compliant XML document, given simple input parameters. The toXML method in Command serialises this object to XML. The response expected from a server should be handled by a DomainCreateResponse object.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.logging.Logger	userLogger
protected XMLWriter	xmlWriter

Fields inherited from class com.ausregistry.jtoolkit2.se.DomainCreateCommand

EMPTY_NAMESERVERS

Fields inherited from class com.ausregistry.jtoolkit2.se.ObjectCommand

objElement

Fields inherited from class com.ausregistry.jtoolkit2.se.Command

cmdElement, command, extension

Constructor Summary

Constructors

Constructor and Description
AuDomainCreateCommandV1(java.lang.String name, java.lang.String pw, java.lang.String registrantID, java.lang.String[] techContacts, java.lang.String[] adminContacts, java.lang.String[] billingContacts, java.lang.String[] nameservers, java.lang.String auEligibilityType, int auPolicyReason, java.lang.String auRegistrantName, java.lang.String auRegistrantID, java.lang.String auRegistrantIDType, java.lang.String auEligibilityName, java.lang.String auEligibilityID, java.lang.String auEligibilityIDType) Full data specification constructor for a domain:create + auext:create EPP command.
AuDomainCreateCommandV1(java.lang.String name, java.lang.String pw, java.lang.String registrantID, java.lang.String[] techContacts, java.lang.String auEligibilityType, int auPolicyReason, java.lang.String auRegistrantName) Minimal constructor for creating a domain:create + auext:create EPP command.

Method Summary

Modifier and Type	Method and Description
java.lang.String	toXML() Serialize the EPP service element to XML.
java.lang.String	toXML(XmlOutputConfig outputConfig) Serialize the EPP service element to XML using the given output config.

Methods inherited from class com.ausregistry.jtoolkit2.se.Command

appendExtension, getCommandType, getExtensionElement, getXmlWriter, initCmdElement, toXMLImpl

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

xmlWriter

protected final transient XMLWriter xmlWriter

userLogger

protected final transient java.util.logging.Logger userLogger

Constructor Detail

AuDomainCreateCommandV1

public AuDomainCreateCommandV1(java.lang.String name,
                               java.lang.String pw,
                               java.lang.String registrantID,
                               java.lang.String[] techContacts,
                               java.lang.String auEligibilityType,
                               int auPolicyReason,
                               java.lang.String auRegistrantName)

Minimal constructor for creating a domain:create + auext:create EPP command. These parameters are the least required for a valid .au domain create command.

Throws:

java.lang.IllegalArgumentException - if any required parameters are null.

AuDomainCreateCommandV1

public AuDomainCreateCommandV1(java.lang.String name,
                               java.lang.String pw,
                               java.lang.String registrantID,
                               java.lang.String[] techContacts,
                               java.lang.String[] adminContacts,
                               java.lang.String[] billingContacts,
                               java.lang.String[] nameservers,
                               java.lang.String auEligibilityType,
                               int auPolicyReason,
                               java.lang.String auRegistrantName,
                               java.lang.String auRegistrantID,
                               java.lang.String auRegistrantIDType,
                               java.lang.String auEligibilityName,
                               java.lang.String auEligibilityID,
                               java.lang.String auEligibilityIDType)

Full data specification constructor for a domain:create + auext:create EPP command. Please refer to the urn:au:params:xml:ns:auext-1.2 schema for specification of the required fields. The mapping of parameter names to au extension fields is given in the parameter documentation.

Parameters:

name - The name of the new domain.

pw - The password to assign to the domain (also known as authInfo or authorisation information).

registrantID - The identifier of an existing contact to assign as the registrant contact for this domain. Failure to ensure the contact exists prior to using them in this way will result in an EPP result of '2303 "Object does not exist"'.

techContacts - The identifiers of existing contacts to assign as technical contacts for this domain. Failure to ensure the contacts exist prior to using them in this way will result in an EPP result of '2303 "Object does not exist"'.

adminContacts - See techContacts (substitute administrative for technical).

billingContacts - See techContacts (substitute billing for technical).

nameservers - The names of existing hosts to delegate the domain being created to. Failure to ensure the hosts exist prior to using them in this way will result in an EPP result of '2303 "Object does not exist"'.

auEligibilityType - auext:eligType. Required.

auPolicyReason - auext:policyReason.

auRegistrantName - auext:registrantName. Required.

auRegistrantID - auext:registrantID.

auRegistrantIDType - auext:registrantID type attribute.

auEligibilityName - auext:eligibilityName.

auEligibilityID - auext:eligibilityID.

auEligibilityIDType - auext:eligibilityID type attribute.

Throws:

java.lang.IllegalArgumentException - if auEligibilityType or auRegistrantName is null.

Method Detail

toXML

public final java.lang.String toXML()
                             throws org.xml.sax.SAXException

Serialize the EPP service element to XML. This MUST be called prior to attempting to use Java serialization on this object. Failure to do so will result in NullPointerException when toXML is called after deserializing the object.

Returns:

XML content as string literal

Throws:

org.xml.sax.SAXException - The XML representation of the command failed schema validation. Further attempts to serialize this command will also fail.

See Also:

toXML

toXML

public final java.lang.String toXML(XmlOutputConfig outputConfig)
                             throws org.xml.sax.SAXException

Serialize the EPP service element to XML using the given output config.

Parameters:

outputConfig - a configuration that indicates how to output the XML

Returns:

XML content as string literal

Throws:

org.xml.sax.SAXException

See Also:

XmlOutputConfig