lib/CWMP/Session.pm

# Dobrica Pavlinusic, <dpavlin@rot13.org> 06/18/07 10:19:50 CEST
package CWMP::Session;

use strict;
use warnings;

use base qw/Class::Accessor/;
__PACKAGE__->mk_accessors( qw/
debug
store

sock
state
store
/ );

use HTTP::Daemon;
use Data::Dump qw/dump/;
use Carp qw/confess cluck croak/;
use File::Slurp;

use CWMP::Request;
use CWMP::Methods;
use CWMP::Store;

=head1 NAME

CWMP::Session - implement logic of CWMP protocol

=head1 METHODS

=head2 new

  my $server = CWMP::Session->new({
        sock => $io_socket_object,
        store => 'state.db',
        debug => 1,
  });

=cut

sub new {
        my $class = shift;
        my $self = $class->SUPER::new( @_ );

        confess "need sock" unless $self->sock;

        $self->debug( 0 ) unless $self->debug;

        warn "created ", __PACKAGE__, "(", dump( @_ ), ") for ", $self->sock->peerhost, "\n" if $self->debug;

        my $store_obj = CWMP::Store->new({
                debug => $self->debug,
                %{ $self->store },
        });

        croak "can't open ", dump( $self->store ), ": $!" unless $store_obj;

        # FIXME looks ugly. Should we have separate accessor for this?
        $self->store( $store_obj );

        return $self;
}

=head2 process_request

One request from client/response from server cycle. Call multiple times to
facilitate brain-dead concept of adding state to stateless protocol like
HTTP.

If used with debugging level of 3 or more, it will also create dumps of
requests named C<< dump/nr.request >> where C<nr> is number from 0 to total number
of requests in single session.

=cut

my $dump_nr = 0;

sub process_request {
        my $self = shift;

        my $sock = $self->sock || die "no sock?";

#       die "not IO::Socket::INET but ", ref( $sock ) unless ( ref($sock) eq 'Net::Server::Proto::TCP' );

        if ( ! $sock->connected ) {
                warn "SOCKET NOT CONNECTED\n";
                return 0;
        }

        bless $sock, 'HTTP::Daemon::ClientConn';

        # why do I have to do this?
        # solution from http://use.perl.org/~Matts/journal/12896
        ${*$sock}{'httpd_daemon'} = HTTP::Daemon->new;

        my $r = $sock->get_request || confess "can't get_request";

        my $xml = $r->content;

        my $size = length( $xml );

        warn "<<<< ", $sock->peerhost, " [" . localtime() . "] ", $r->method, " ", $r->uri, " $size bytes\n";

        $dump_nr++;
        my $file = sprintf("dump/%04d-%s.request", $dump_nr, $sock->peerhost);

        if ( $self->debug > 2 ) {
                write_file( $file, $r->as_string );
                warn "### request dumped to file: $file\n";
        }

        my $state;

        if ( $size > 0 ) {

                die "no SOAPAction header in ",dump($xml) unless defined ( $r->header('SOAPAction') );

                warn "## request payload: ",length($xml)," bytes\n$xml\n" if $self->debug;

                $state = CWMP::Request->parse( $xml );

                if ( defined( $state->{_dispatch} ) && $self->debug > 2 ) {
                        my $type = sprintf("dump/%04d-%s-%s", $dump_nr, $sock->peerhost, $state->{_dispatch});
                        symlink $file, $type || warn "can't symlink $file -> $type: $!";
                }

                warn "## acquired state = ", dump( $state ), "\n";

                $self->state( $state );
                $self->store->update_state( ID => $state->{ID}, $state );

        } else {

                warn "## empty request, using last request state\n";

                $state = $self->state;
                delete( $state->{_dispatch} );
                #warn "last request state = ", dump( $state ), "\n" if $self->debug > 1;
        }


        $sock->send(join("\r\n",
                'HTTP/1.1 200 OK',
                'Content-Type: text/xml; charset="utf-8"',
                'Server: AcmeCWMP/42',
                'SOAPServer: AcmeCWMP/42'
        )."\r\n");

        $sock->send( "Set-Cookie: ID=" . $state->{ID} . "; path=/\r\n" ) if ( $state->{ID} );

        my $uid = $self->store->ID_to_uid( $state->{ID}, $state );

        my $queue = CWMP::Queue->new({
                id => $uid,
                debug => $self->debug,
        });
        my $job;
        $xml = '';

        if ( my $dispatch = $state->{_dispatch} ) {
                $xml = $self->dispatch( $dispatch );
        } elsif ( $job = $queue->dequeue ) {
                $xml = $self->dispatch( $job->dispatch );
        } elsif ( $size == 0 ) {
                warn ">>> no more queued commands, closing connection to $uid\n";
                return 0;
        } else {
                warn ">>> empty response to $uid\n";
                $state->{NoMoreRequests} = 1;
                $xml = $self->dispatch( 'xml', sub {} );
        }

        $sock->send( "Content-Length: " . length( $xml ) . "\r\n\r\n" );
        $sock->send( $xml ) or die "can't send response";

        warn ">>>> " . $sock->peerhost . " [" . localtime() . "] sent ", length( $xml )," bytes to $uid\n";

        $job->finish if $job;
        warn "### request over for $uid\n" if $self->debug;

        return 1;       # next request
};

=head2 dispatch

  $xml = $self->dispatch('Inform', $response_arguments );

If debugging level of 3 or more, it will create dumps of responses named C<< dump/nr.response >>

=cut

sub dispatch {
        my $self = shift;

        my $dispatch = shift || die "no dispatch?";
        my @args = @_;

        if ( ref($dispatch) eq 'ARRAY' ) {
                my @a = @$dispatch;
                $dispatch = shift @a;
                push @args, @a;
        }

        my $response = CWMP::Methods->new({ debug => $self->debug });

        if ( $response->can( $dispatch ) ) {
                warn ">>> dispatching to $dispatch\n";
                my $xml = $response->$dispatch( $self->state, @args );
                warn "## response payload: ",length($xml)," bytes\n$xml\n" if $self->debug;
                if ( $self->debug > 2 ) {
                        my $file = sprintf("dump/%04d-%s.response", $dump_nr++, $self->sock->peerhost);
                        write_file( $file, $xml );
                        warn "### response dump: $file\n";
                }
                return $xml;
        } else {
                confess "can't dispatch to $dispatch";
        }
};


=head2 error

  return $self->error( 501, 'System error' );

=cut

sub error {
  my ($self, $number, $msg) = @_;
  $msg ||= 'ERROR';
  $self->sock->send( "HTTP/1.1 $number $msg\r\n" );
  warn "Error - $number - $msg\n";
  return 0;     # close connection
}

1;
1	dpavlin	30	# Dobrica Pavlinusic, <dpavlin@rot13.org> 06/18/07 10:19:50 CEST
2	dpavlin	82	package CWMP::Session;
3	dpavlin	30
4			use strict;
5			use warnings;
6
7	dpavlin	40	use base qw/Class::Accessor/;
8	dpavlin	30	__PACKAGE__->mk_accessors( qw/
9			debug
10	dpavlin	150	store
11	dpavlin	77
12	dpavlin	41	sock
13	dpavlin	49	state
14	dpavlin	77	store
15	dpavlin	30	/ );
16
17	dpavlin	110	use HTTP::Daemon;
18	dpavlin	30	use Data::Dump qw/dump/;
19	dpavlin	77	use Carp qw/confess cluck croak/;
20	dpavlin	111	use File::Slurp;
21	dpavlin	77
22	dpavlin	35	use CWMP::Request;
23	dpavlin	173	use CWMP::Methods;
24	dpavlin	77	use CWMP::Store;
25	dpavlin	30
26	dpavlin	34	=head1 NAME
27
28	dpavlin	82	CWMP::Session - implement logic of CWMP protocol
29	dpavlin	34
30			=head1 METHODS
31
32	dpavlin	40	=head2 new
33	dpavlin	34
34	dpavlin	82	my $server = CWMP::Session->new({
35	dpavlin	110	sock => $io_socket_object,
36	dpavlin	150	store => 'state.db',
37	dpavlin	77	debug => 1,
38			});
39	dpavlin	34
40			=cut
41
42	dpavlin	83	sub new {
43			my $class = shift;
44			my $self = $class->SUPER::new( @_ );
45	dpavlin	30
46	dpavlin	83	confess "need sock" unless $self->sock;
47	dpavlin	40
48	dpavlin	84	$self->debug( 0 ) unless $self->debug;
49
50	dpavlin	83	warn "created ", __PACKAGE__, "(", dump( @_ ), ") for ", $self->sock->peerhost, "\n" if $self->debug;
51	dpavlin	40
52	dpavlin	150	my $store_obj = CWMP::Store->new({
53	dpavlin	77	debug => $self->debug,
54	dpavlin	150	%{ $self->store },
55			});
56	dpavlin	83
57	dpavlin	150	croak "can't open ", dump( $self->store ), ": $!" unless $store_obj;
58	dpavlin	77
59	dpavlin	150	# FIXME looks ugly. Should we have separate accessor for this?
60			$self->store( $store_obj );
61
62	dpavlin	83	return $self;
63	dpavlin	40	}
64
65	dpavlin	48	=head2 process_request
66
67			One request from client/response from server cycle. Call multiple times to
68			facilitate brain-dead concept of adding state to stateless protocol like
69			HTTP.
70
71	dpavlin	111	If used with debugging level of 3 or more, it will also create dumps of
72	dpavlin	117	requests named C<< dump/nr.request >> where C<nr> is number from 0 to total number
73	dpavlin	111	of requests in single session.
74
75	dpavlin	48	=cut
76
77	dpavlin	111	my $dump_nr = 0;
78
79	dpavlin	40	sub process_request {
80			my $self = shift;
81
82	dpavlin	42	my $sock = $self->sock \|\| die "no sock?";
83	dpavlin	40
84	dpavlin	110	# die "not IO::Socket::INET but ", ref( $sock ) unless ( ref($sock) eq 'Net::Server::Proto::TCP' );
85	dpavlin	40
86	dpavlin	42	if ( ! $sock->connected ) {
87	dpavlin	53	warn "SOCKET NOT CONNECTED\n";
88	dpavlin	42	return 0;
89			}
90
91	dpavlin	110	bless $sock, 'HTTP::Daemon::ClientConn';
92	dpavlin	40
93	dpavlin	110	# why do I have to do this?
94			# solution from http://use.perl.org/~Matts/journal/12896
95			${*$sock}{'httpd_daemon'} = HTTP::Daemon->new;
96	dpavlin	40
97	dpavlin	110	my $r = $sock->get_request \|\| confess "can't get_request";
98	dpavlin	40
99	dpavlin	169	my $xml = $r->content;
100	dpavlin	40
101	dpavlin	169	my $size = length( $xml );
102	dpavlin	34
103	dpavlin	111	warn "<<<< ", $sock->peerhost, " [" . localtime() . "] ", $r->method, " ", $r->uri, " $size bytes\n";
104	dpavlin	34
105	dpavlin	177	$dump_nr++;
106			my $file = sprintf("dump/%04d-%s.request", $dump_nr, $sock->peerhost);
107
108	dpavlin	111	if ( $self->debug > 2 ) {
109			write_file( $file, $r->as_string );
110	dpavlin	169	warn "### request dumped to file: $file\n";
111	dpavlin	111	}
112
113	dpavlin	36	my $state;
114
115	dpavlin	49	if ( $size > 0 ) {
116	dpavlin	30
117	dpavlin	169	die "no SOAPAction header in ",dump($xml) unless defined ( $r->header('SOAPAction') );
118	dpavlin	34
119	dpavlin	169	warn "## request payload: ",length($xml)," bytes\n$xml\n" if $self->debug;
120	dpavlin	49
121	dpavlin	169	$state = CWMP::Request->parse( $xml );
122
123	dpavlin	177	if ( defined( $state->{_dispatch} ) && $self->debug > 2 ) {
124			my $type = sprintf("dump/%04d-%s-%s", $dump_nr, $sock->peerhost, $state->{_dispatch});
125			symlink $file, $type \|\| warn "can't symlink $file -> $type: $!";
126			}
127
128	dpavlin	119	warn "## acquired state = ", dump( $state ), "\n";
129	dpavlin	49
130	dpavlin	119	$self->state( $state );
131			$self->store->update_state( ID => $state->{ID}, $state );
132	dpavlin	49
133	dpavlin	119	} else {
134	dpavlin	49
135	dpavlin	150	warn "## empty request, using last request state\n";
136	dpavlin	49
137			$state = $self->state;
138	dpavlin	119	delete( $state->{_dispatch} );
139	dpavlin	150	#warn "last request state = ", dump( $state ), "\n" if $self->debug > 1;
140	dpavlin	34	}
141
142
143	dpavlin	44	$sock->send(join("\r\n",
144			'HTTP/1.1 200 OK',
145			'Content-Type: text/xml; charset="utf-8"',
146			'Server: AcmeCWMP/42',
147	dpavlin	49	'SOAPServer: AcmeCWMP/42'
148	dpavlin	54	)."\r\n");
149	dpavlin	30
150	dpavlin	43	$sock->send( "Set-Cookie: ID=" . $state->{ID} . "; path=/\r\n" ) if ( $state->{ID} );
151	dpavlin	197
152	dpavlin	198	my $uid = $self->store->ID_to_uid( $state->{ID}, $state );
153
154	dpavlin	197	my $queue = CWMP::Queue->new({
155	dpavlin	198	id => $uid,
156	dpavlin	197	debug => $self->debug,
157			});
158			my $job;
159	dpavlin	170	$xml = '';
160	dpavlin	40
161	dpavlin	36	if ( my $dispatch = $state->{_dispatch} ) {
162	dpavlin	50	$xml = $self->dispatch( $dispatch );
163	dpavlin	197	} elsif ( $job = $queue->dequeue ) {
164			$xml = $self->dispatch( $job->dispatch );
165	dpavlin	50	} elsif ( $size == 0 ) {
166	dpavlin	198	warn ">>> no more queued commands, closing connection to $uid\n";
167	dpavlin	50	return 0;
168	dpavlin	36	} else {
169	dpavlin	198	warn ">>> empty response to $uid\n";
170	dpavlin	50	$state->{NoMoreRequests} = 1;
171			$xml = $self->dispatch( 'xml', sub {} );
172	dpavlin	36	}
173	dpavlin	40
174	dpavlin	43	$sock->send( "Content-Length: " . length( $xml ) . "\r\n\r\n" );
175	dpavlin	44	$sock->send( $xml ) or die "can't send response";
176	dpavlin	40
177	dpavlin	198	warn ">>>> " . $sock->peerhost . " [" . localtime() . "] sent ", length( $xml )," bytes to $uid\n";
178	dpavlin	72
179	dpavlin	197	$job->finish if $job;
180	dpavlin	198	warn "### request over for $uid\n" if $self->debug;
181	dpavlin	40
182	dpavlin	72	return 1; # next request
183	dpavlin	30	};
184
185	dpavlin	50	=head2 dispatch
186
187			$xml = $self->dispatch('Inform', $response_arguments );
188
189	dpavlin	117	If debugging level of 3 or more, it will create dumps of responses named C<< dump/nr.response >>
190
191	dpavlin	50	=cut
192
193			sub dispatch {
194			my $self = shift;
195
196			my $dispatch = shift \|\| die "no dispatch?";
197	dpavlin	169	my @args = @_;
198	dpavlin	50
199	dpavlin	169	if ( ref($dispatch) eq 'ARRAY' ) {
200			my @a = @$dispatch;
201			$dispatch = shift @a;
202			push @args, @a;
203			}
204
205	dpavlin	173	my $response = CWMP::Methods->new({ debug => $self->debug });
206	dpavlin	50
207			if ( $response->can( $dispatch ) ) {
208			warn ">>> dispatching to $dispatch\n";
209	dpavlin	169	my $xml = $response->$dispatch( $self->state, @args );
210	dpavlin	53	warn "## response payload: ",length($xml)," bytes\n$xml\n" if $self->debug;
211	dpavlin	117	if ( $self->debug > 2 ) {
212	dpavlin	127	my $file = sprintf("dump/%04d-%s.response", $dump_nr++, $self->sock->peerhost);
213	dpavlin	117	write_file( $file, $xml );
214			warn "### response dump: $file\n";
215			}
216	dpavlin	50	return $xml;
217			} else {
218			confess "can't dispatch to $dispatch";
219			}
220			};
221
222	dpavlin	40
223	dpavlin	48	=head2 error
224
225			return $self->error( 501, 'System error' );
226
227			=cut
228
229	dpavlin	44	sub error {
230	dpavlin	40	my ($self, $number, $msg) = @_;
231	dpavlin	44	$msg \|\|= 'ERROR';
232			$self->sock->send( "HTTP/1.1 $number $msg\r\n" );
233	dpavlin	40	warn "Error - $number - $msg\n";
234	dpavlin	48	return 0; # close connection
235	dpavlin	40	}
236
237	dpavlin	30	1;