com.ausregistry.jtoolkit2.se

Class HostCreateCommand

java.lang.Object

com.ausregistry.jtoolkit2.se.Command

com.ausregistry.jtoolkit2.se.ObjectCommand

com.ausregistry.jtoolkit2.se.CreateCommand

com.ausregistry.jtoolkit2.se.HostCreateCommand

All Implemented Interfaces:

java.io.Serializable

public class HostCreateCommand
extends CreateCommand

Use this to request that a host object be provisioned in an EPP Registry. Instances of this class generate RFC5730 and RFC5732 compliant host create EPP command service elements via the toXML method.

See Also:

HostCreateResponse, 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.ObjectCommand

objElement

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

cmdElement, command, extension

Constructor Summary

Constructors

Constructor and Description
HostCreateCommand(java.lang.String name) Provision a host with the specified details which constitute the minimum valid parameters according to the EPP specification.
HostCreateCommand(java.lang.String name, InetAddress[] addresses) Provision a host with the specified details.

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

HostCreateCommand

public HostCreateCommand(java.lang.String name)

Provision a host with the specified details which constitute the minimum valid parameters according to the EPP specification. This is the appropriate constructor to use for provisioning external hosts.

Parameters:

name - The new host's name.

HostCreateCommand

public HostCreateCommand(java.lang.String name,
                         InetAddress[] addresses)

Provision a host with the specified details. This constructor allows specification of any and all parameters for a host create command.

Parameters:

name - The new host's name.

addresses - The Internet addresses of the host to be provisioned. These should only be specified if the parent domain is sponsored by the client provisioning this host and the parent domain is provisioned in the domain name registry in which this host is being provisioned. That is, external hosts must not be assigned Internet addresses.

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