File: Domain.pm

package info (click to toggle)
libnet-epp-perl 0.28-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 384 kB
  • sloc: perl: 2,540; sh: 3; makefile: 2
file content (127 lines) | stat: -rw-r--r-- 2,809 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
package Net::EPP::Frame::Command::Transfer::Domain;
use base qw(Net::EPP::Frame::Command::Transfer);
use Net::EPP::Frame::ObjectSpec;
use strict;

=pod

=head1 NAME

Net::EPP::Frame::Command::Transfer::Domain - an instance of L<Net::EPP::Frame::Command::Transfer>
for domain objects.

=head1 SYNOPSIS

	use Net::EPP::Frame::Command::Transfer::Domain;
	use strict;

	my $info = Net::EPP::Frame::Command::Transfer::Domain->new;
	$info->setOp('query');
	$info->setDomain('example.tld');

	print $info->toString(1);

This results in an XML document like this:

	<?xml version="1.0" encoding="UTF-8"?>
	<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
	  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	  xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
	  epp-1.0.xsd">
	    <command>
	      <transfer op="query">
	        <domain:transfer
	          xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
	          xsi:schemaLocation="urn:ietf:params:xml:ns:domain-1.0
	          domain-1.0.xsd">
	            <domain:name>example.tldE<lt>/domain:name>
	        </domain:transfer>
	      </transfer>
	      <clTRID>0cf1b8f7e14547d26f03b7641660c641d9e79f45</clTRIDE<gt>
	    </command>
	</epp>

=head1 OBJECT HIERARCHY

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

=cut

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

    my $domain = $self->addObject(Net::EPP::Frame::ObjectSpec->spec('domain'));

    return $self;
}

=pod

=head1 METHODS

	$frame->setDomain('example.tld');

This method specifies the domain name for the transfer.

=cut

sub setDomain {
    my ($self, $domain) = @_;

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

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

    return 1;
}

=pod

	$frame->period($years);

This sets the optional renewal period for the transfer.

=cut

sub setPeriod {
    my ($self, $years) = @_;

    my $period = $self->createElement('domain:period');
    $period->setAttribute('unit', 'y');
    $period->appendText($years);

    $self->getNode('transfer')->getChildNodes->shift->appendChild($period);

    return 1;
}

=pod

	$frame->setAuthInfo($pw);

This sets the authInfo code for the transfer.

=cut

sub setAuthInfo {
    my ($self, $code) = @_;

    my $pw = $self->createElement('domain:pw');
    $pw->appendText($code);

    my $authInfo = $self->createElement('domain:authInfo');
    $authInfo->appendChild($pw);

    $self->getNode('transfer')->getChildNodes->shift->appendChild($authInfo);

    return 1;
}

1;