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
128
129
|
package Net::EPP::Frame::Response;
use Net::EPP::ResponseCodes;
use base qw(Net::EPP::Frame);
=pod
=head1 NAME
Net::EPP::Frame::Response - an instance of L<Net::EPP::Frame> for server responses
=head1 DESCRIPTION
This module is a subclass of L<Net::EPP::Frame> that represents EPP server
responses.
Responses are sent back to clients when the server receives a
C<E<lt>commandE<gt>> frame.
=head1 OBJECT HIERARCHY
L<XML::LibXML::Node>
+----L<XML::LibXML::Document>
+----L<Net::EPP::Frame>
+----L<Net::EPP::Frame::Response>
=cut
sub new {
my $package = shift;
my $self = $package->SUPER::new('response');
return bless($self, $package);
}
sub _addExtraElements {
my $self = shift;
my $result = $self->createElement('result');
$result->appendChild($self->createElement('msg'));
$self->response->addChild($result);
$self->result->setAttribute('code' => COMMAND_FAILED);
$self->response->addChild($self->createElement('resData'));
my $trID = $self->createElement('trID');
$trID->addChild($self->createElement('clTRID'));
$trID->addChild($self->createElement('svTRID'));
$self->response->addChild($trID);
return 1;
}
=pod
=head1 METHODS
my $node = $frame->response;
This method returns the L<XML::LibXML::Element> object corresponding to the
C<E<lt>commandE<gt>> element.
my $node = $frame->result;
This method returns the L<XML::LibXML::Element> object corresponding to the
C<E<lt>resultE<gt>> element.
my $node = $frame->resData;
This method returns the L<XML::LibXML::Element> object corresponding to the
C<E<lt>resDataE<gt>> element.
my $node = $frame->trID;
This method returns the L<XML::LibXML::Element> object corresponding to the
C<E<lt>trIDE<gt>> element.
my $node = $frame->clTRID;
This method returns the L<XML::LibXML::Element> object corresponding to the
C<E<lt>clTRIDE<gt>> element.
my $node = $frame->svTRID;
This method returns the L<XML::LibXML::Element> object corresponding to the
C<E<lt>svTRIDE<gt>> element.
=cut
sub response { $_[0]->getNode('response') }
sub result { $_[0]->getNode('result') }
sub resData { $_[0]->getNode('resData') }
sub trID { $_[0]->getNode('trID') }
sub clTRID { $_[0]->getNode('clTRID') }
sub svTRID { $_[0]->getNode('svTRID') }
=pod
my $msg = $frame->code;
This method returns the code attribute of the C<E<lt>resultE<gt>>
element.
=cut
sub code {
my $self = shift;
my $result = $self->result;
if ($result) {
return $result->getAttribute('code');
}
return COMMAND_FAILED;
}
=pod
my $msg = $frame->msg;
This method returns a string containing the text content of the
C<E<lt>msgE<gt>> element.
=cut
sub msg {
my $self = shift;
my $msgs = $self->getElementsByLocalName('msg');
return $msgs->shift->textContent if ($msgs->size == 1);
}
1;
|
