NAME

Net::EPP::Frame::Command - an instance of Net::EPP::Frame for client commands

DESCRIPTION

This module is a base class for the Net::EPP::Frame::* subclasses, you should never need to access it directly.

OBJECT HIERARCHY

    L<XML::LibXML::Node>
    +----L<XML::LibXML::Document>
        +----L<Net::EPP::Frame>
            +----L<Net::EPP::Frame::Command>

METHODS

        my $object = $frame->addObject(@spec);

This method creates and returns a new element corresponding to the data in @spec, and appends it to the "command" element (as returned by the getCommandType() method below).

The Net::EPP::Frame::ObjectSpec module can be used to quickly retrieve EPP object specifications.

        my $type = $frame->getCommandType;

This method returns a scalar containing the command type (eg 'create').

        my $type = $frame->getCommandNode;

This method returns the XML::LibXML::Element object corresponding to the command in question, eg the "<create>" element (for a Net::EPP::Frame::Command::Create object). It is within this element that EPP objects are placed.

        my $node = $frame->command;

This method returns the XML::LibXML::Element object corresponding to the "<command>" element.

        my $node = $frame->clTRID;

This method returns the XML::LibXML::Element object corresponding to the "<clTRID>" element.

    my $extension = $frame->extension;

This method returns the XML::LibXML::Element object corresponding to the "<extension>" element. If one does not exist, it will be created and inserted at the correct position.

    my $element = $frame->createExtensionElementFor($xmlns);

This methods creates a new element in the "<extension>" element for the EPP extension specified by $xmlns which can be obtained from Net::EPP::Frame::ObjectSpec. The element's tag name will correspond to the command name ("create", "update" etc).

    Example usage:
    my $frame = Net::EPP::Frame::Command::Info::Domain->new;
    my $element = $frame->createExtensionElementFor(
        Net::EPP::Frame::ObjectSpec->xmlns('foobar')
    );
    // prints <info xmlns="namespace:for:foobar"/>
    print $element->toString();