r218@brr: dpavlin | 2007-11-14 22:54:48 +0100
[perl-cwmp.git] / lib / CWMP / Request.pm
1 package CWMP::Request;
2
3 use warnings;
4 use strict;
5
6 use XML::Rules;
7 use CWMP::Tree;
8 use Data::Dump qw/dump/;
9 use Carp qw/confess cluck/;
10 use Class::Trigger;
11
12 =head1 NAME
13
14 CWMP::Request - parse SOAP request metods
15
16 =head1 CPE metods
17
18 All methods described below call triggers with same name
19
20 =cut
21
22 my $tree = CWMP::Tree->new({ debug => 0 });
23
24 our $state;     # FIXME check this!
25
26 my $rules =  [
27                 #_default => 'content trim',
28                 x_default => sub {
29                         my ($tag_name, $tag_hash, $context, $parent_data) = @_;
30                         warn dump( $tag_name, $tag_hash, $context );
31                 },
32                 'ID' => sub {
33                         my ($tag_name, $tag_hash, $context, $parent_data) = @_;
34                         $state->{ID} = $tag_hash->{_content};
35                 },
36
37                 'DeviceId' => sub {
38                         my ($tag_name, $tag_hash, $context, $parent_data) = @_;
39                         foreach my $name ( keys %$tag_hash ) {
40                                 next if $name eq '_content';
41                                 my $key = $name;
42                                 $key =~ s/^\w+://;      # stip namespace
43                                 $state->{DeviceID}->{ $key } = _tag( $tag_hash, $name, '_content' );
44                         }
45                 },
46                 'EventStruct' => sub {
47                         my ($tag_name, $tag_hash, $context, $parent_data) = @_;
48                         push @{ $state->{EventStruct} }, $tag_hash->{EventCode}->{_content};
49                 },
50                 qr/(MaxEnvelopes|CurrentTime|RetryCount)/ => sub {
51                         my ($tag_name, $tag_hash, $context, $parent_data) = @_;
52                         $state->{$tag_name} = $tag_hash->{_content};
53                 },
54                 'ParameterValueStruct' => sub {
55                         my ($tag_name, $tag_hash, $context, $parent_data) = @_;
56                         # Name/Value tags must be case insnesitive
57                         my $value = (grep( /value/i, keys %$tag_hash ))[0];
58                         $state->{Parameter}->{ _tag($tag_hash, 'Name', '_content') } = _tag($tag_hash, 'Value', '_content' );
59                         $state->{_trigger} = 'ParameterValue';
60                 },
61
62 ];
63
64 =head2 Inform
65
66 Generate InformResponse to CPE
67
68 =cut
69
70 push @$rules,
71         'Inform' => sub {
72                 $state->{_dispatch} = 'InformResponse';         # what reponse to call
73                 $state->{_trigger} = 'Inform';
74         };
75
76 =head2 GetRPCMethodsResponse
77
78 =cut
79
80 push @$rules,
81                 qr/^(?:^\w+:)*string$/ => 'content array',
82                 'MethodList' => sub {
83                         my ($tag_name, $tag_hash, $context, $parent_data) = @_;
84                         $state->{MethodList} = _tag( $tag_hash, 'string' );
85                         $state->{_trigger} = 'GetRPCMethodsResponse';
86                 };
87
88 =head2 GetParameterNamesResponse
89
90 =cut
91
92 push @$rules,
93                 'ParameterInfoStruct' => sub {
94                         my ($tag_name, $tag_hash, $context, $parent_data) = @_;
95                         my $name = _tag($tag_hash, 'Name', '_content');
96                         my $writable = _tag($tag_hash, 'Writable', '_content' );
97
98                         confess "need state" unless ( $state ); # don't remove!
99
100                         # XXX dragons ahead: convert name to tree rewriting it into perl
101                         my $s = '$state->{ParameterInfo}->' . $tree->name2perl( $name ) . "->{writable} = $writable;";
102                         eval "$s";
103                         confess "can't eval $s : $@" if ($@);
104
105                         #warn "## state = dump( $state ), "\n";
106
107                         $state->{_trigger} = 'GetParameterNamesResponse';
108                 };
109         
110 =head2 Fault
111
112 =cut
113
114 push @$rules,
115                 'Fault' => sub {
116                         my ($tag_name, $tag_hash, $context, $parent_data) = @_;
117                         $state->{Fault} = {
118                                 FaultCode => _tag( $tag_hash, 'FaultCode', '_content' ),
119                                 FaultString => _tag( $tag_hash, 'FaultString', '_content' ),
120                         };
121                         warn "FAULT: ", $state->{Fault}->{FaultCode}, " ", $state->{Fault}->{FaultString}, "\n";
122                         $state->{_trigger} = 'Fault';
123                 };
124
125 my $parser = XML::Rules->new(
126 #       start_rules => [
127 #               '^division_name,fax' => 'skip',
128 #       ],
129         namespaces => {
130                 'http://schemas.xmlsoap.org/soap/envelope/' => 'soapenv',
131                 'http://schemas.xmlsoap.org/soap/encoding/' => 'soap',
132                 'http://www.w3.org/2001/XMLSchema' => 'xsd',
133                 'http://www.w3.org/2001/XMLSchema-instance' => 'xsi',
134                 'urn:dslforum-org:cwmp-1-0' => '',
135         },
136         rules => $rules,
137 );
138
139 =head1 METHODS
140
141 =head2 parse
142
143   my $state = CWMP::Request->parse( "<soap>request</soap>" );
144
145 =cut
146
147 sub parse {
148         my $self = shift;
149
150         my $xml = shift || confess "no xml?";
151
152         $state = {};
153         $parser->parsestring( $xml );
154         if ( my $trigger = $state->{_trigger} ) {
155                 warn "### call_trigger( $trigger )\n";
156                 $self->call_trigger( $trigger, $state );
157         }
158         # XXX don't propagate _trigger (useful?)
159         delete( $state->{_trigger} );
160         return $state;
161 }
162
163 =head2 _tag
164
165 Get value of tag. Tag name is case insensitive (don't ask why),
166 we ignore namespaces and can take optional C<sub_key>
167 (usually C<_content>).
168
169   _tag( $tag_hash, $name, $sub_key )
170
171 =cut
172
173 sub _tag {
174         my ( $tag_hash, $name, $sub_key ) = @_;
175         confess "need hash as first argument" unless ( ref $tag_hash eq 'HASH' );
176         $name = (grep { m/^(?:\w+:)*$name$/i } keys %$tag_hash )[0];
177 #       $name =~ s/^\w+://;
178         if ( defined $tag_hash->{$name} ) {
179                 if ( ! defined $sub_key ) {
180                         return $tag_hash->{$name};
181                 } elsif ( defined $tag_hash->{$name}->{$sub_key} ) {
182                         return $tag_hash->{$name}->{$sub_key};
183                 } else {
184                         return if ( $name =~ m/^value$/i );
185                         warn "can't find '$name/$sub_key' in ", dump( $tag_hash );
186                         return;
187                 }
188         } else {
189                 warn "can't find '$name' in ", dump( $tag_hash );
190                 return;
191         }
192 }
193
194 1;