File Coverage

blib/lib/Net/EPP/Frame/Command/Create/Host.pm

Criterion	Covered	Total	%
statement	9	25	36.0
branch			n/a
condition			n/a
subroutine	3	6	50.0
pod	0	3	0.0
total	12	34	35.2

# Copyright (c) 2016 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$
package Net::EPP::Frame::Command::Create::Host;
use base qw(Net::EPP::Frame::Command::Create);
use Net::EPP::Frame::ObjectSpec;
use strict;

=pod

=head1 NAME

Net::EPP::Frame::Command::Create::Host - an instance of L
for host objects.

=head1 SYNOPSIS

	use Net::EPP::Frame::Command::Create::Host;
	use strict;

	my $create = Net::EPP::Frame::Command::Create::Host->new;
	$create->setHost('ns1.example.uk.com);

	print $create->toString(1);

This results in an XML document like this:



	  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	  xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
	  epp-1.0.xsd">



	          xmlns:contact="urn:ietf:params:xml:ns:host-1.0"
	          xsi:schemaLocation="urn:ietf:params:xml:ns:host-1.0
	          host-1.0.xsd">
	            ns1.example.uk.com


	      0cf1b8f7e14547d26f03b7641660c641d9e79f45




=head1 OBJECT HIERARCHY

    L
    +----L
        +----L
            +----L
                +----L
                    +----L

=cut

sub new {
	my $package = shift;
	my $self = bless($package->SUPER::new('create'), $package);

	$self->addObject(Net::EPP::Frame::ObjectSpec->spec('host'));

	return $self;
}

=pod

=head1 METHODS

	my $element = $frame->setHost($host_name);

This sets the name of the object to be created. Returns the
host:nameE> element.

=cut


sub setHost {
	my ($self, $host) = @_;

	my $name = $self->createElement('host:name');
	$name->appendText($host);

	$self->getNode('create')->getChildNodes->shift->appendChild($name);

	return 1;
}

=pod

	$frame->setAddr({ 'ip' => '10.0.0.1', 'version' => 'v4' });

This adds an IP address to the host object. EPP supports multiple
addresses of different versions.

=cut

sub setAddr {
	my ($self, @addr) = @_;

	foreach my $ip (@addr) {
		my $hostAttr = $self->createElement('host:addr');
		$hostAttr->appendText($ip->{ip});
		$hostAttr->setAttribute('ip', $ip->{version});
		$self->getNode('create')->getChildNodes->shift->appendChild($hostAttr);
	}
	return 1;
}

=pod

=head1 AUTHOR

CentralNic Ltd (http://www.centralnic.com/).

United Domains AG (http://www.united-domains.de/) provided the original version of Net::EPP::Frame::Command::Create::Host.

=head1 COPYRIGHT

This module is (c) 2016 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

=back

=cut

1;