# Copyright (c) 2006 CentralNic Ltd. All rights reserved. This program is
# free software; you can redistribute it and/or modify it under the same
# terms as Perl itself.
# 
# $Id: Greeting.pm,v 1.2 2006/01/09 13:24:42 gavin Exp $
package Net::EPP::Frame::Greeting;
use base qw(Net::EPP::Frame);

=pod

=head1 NAME

Net::EPP::Frame::Greeting - an instance of L<Net::EPP::Frame> for server greetings

=head1 DESCRIPTION

This module is a subclass of L<Net::EPP::Frame> that represents EPP server
greetings.

According to the EPP RFC, the server must transmit an EPP greeting frame to the
client upon connection, and in response to an EPP C<E<lt>helloE<gt>> command.
The C<E<lt>greetingE<gt>> frame provides information about the server,
including the server time, access control rules, and a list of the object
types that are provisioned by the server.

=head1 OBJECT HIERARCHY

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


=cut

sub _addExtraElements {
	my $self = shift;
	$self->greeting->addChild($self->createElement('svID'));
	$self->greeting->addChild($self->createElement('svDate'));
	$self->greeting->addChild($self->createElement('svcMenu'));
	$self->greeting->addChild($self->createElement('dcp'));
	return 1;
}

=pod

=head1 METHODS

	my $node = $frame->greeting;

This method returns the L<XML::LibXML::Element> object corresponding to the
C<E<lt>greetingE<gt>> element.

	my $node = $frame->svID;

This method returns the L<XML::LibXML::Element> object corresponding to the
C<E<lt>svIDE<gt>> element.

	my $node = $frame->svDate;

This method returns the L<XML::LibXML::Element> object corresponding to the
C<E<lt>svDateE<gt>> element.

	my $node = $frame->svcMenu;

This method returns the L<XML::LibXML::Element> object corresponding to the
C<E<lt>svcMenuE<gt>> element.

	my $node = $frame->dcp;

This method returns the L<XML::LibXML::Element> object corresponding to the
C<E<lt>dcpE<gt>> element.

=cut

sub greeting { $_[0]->getNode('greeting') }
sub svID { $_[0]->getNode('svID') }
sub svDate { $_[0]->getNode('svDate') }
sub svcMenu { $_[0]->getNode('svcMenu') }
sub dcp { $_[0]->getNode('dcp') }

=pod

=head1 AUTHOR

Gavin Brown (L<epp@centralnic.com>) for CentralNic Ltd (http://www.centralnic.com/).

=head1 COPYRIGHT

This module is (c) 2006 CentralNic Ltd. This module is free software; you can
redistribute it and/or modify it under the same terms as Perl itself.

=head1 SEE ALSO

=over

=item * L<Net::EPP::Frame>

=back

=cut

1;