com.ausregistry.jtoolkit2.se

Class ContactCreateCommand

java.lang.Object

com.ausregistry.jtoolkit2.se.Command

com.ausregistry.jtoolkit2.se.ObjectCommand

com.ausregistry.jtoolkit2.se.CreateCommand

com.ausregistry.jtoolkit2.se.ContactCreateCommand

All Implemented Interfaces:

java.io.Serializable

public class ContactCreateCommand
extends CreateCommand

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

See Also:

ContactCreateResponse, 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
ContactCreateCommand(java.lang.String id, java.lang.String pw, PostalInfo postalInfo, LocalPostalInfo localPostalInfo, java.lang.String voice, java.lang.String voiceExt, java.lang.String fax, java.lang.String faxExt, java.lang.String email, Disclose disclose) Provision a contact with the specified details.
ContactCreateCommand(java.lang.String id, java.lang.String pw, PostalInfo postalInfo, java.lang.String email) Provision a contact with the specified details which constitute the minimum valid parameters according to the EPP specification.

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

ContactCreateCommand

public ContactCreateCommand(java.lang.String id,
                            java.lang.String pw,
                            PostalInfo postalInfo,
                            java.lang.String email)

Provision a contact with the specified details which constitute the minimum valid parameters according to the EPP specification.

Parameters:

id - The new contact's identifier.

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

postalInfo - The postal information for the new contact. This may be either of type IntPostalInfo or LocalPostalInfo.

email - The contact's email address.

ContactCreateCommand

public ContactCreateCommand(java.lang.String id,
                            java.lang.String pw,
                            PostalInfo postalInfo,
                            LocalPostalInfo localPostalInfo,
                            java.lang.String voice,
                            java.lang.String voiceExt,
                            java.lang.String fax,
                            java.lang.String faxExt,
                            java.lang.String email,
                            Disclose disclose)

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

Parameters:

id - The new contact's identifier. Required.

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

postalInfo - Postal information for the new contact. If localPostalInfo is also specified, then this MUST be IntPostalInfo. Required if localPostInfo is not supplied.

localPostalInfo - Local postal information for the new contact. Required if postalInfo is not supplied.

voice - The contact's voice telephone number.

voiceExt - The extension for the contact's voice telephone number, if applicable.

fax - The contact's fax telephone number.

faxExt - The extension for the contact's fax telephone number, if applicable.

email - The contact's email address. Required.

disclose - Disclosure request information, which may modify what information is disclosed by the Registry system in response to queries. Note that the server may not accept specification of this parameter, or may ignore any requests described by this parameter.

Throws:

java.lang.IllegalArgumentException - if any required parameter 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