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_path

sock
state
queue
store
/ );

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

use CWMP::Request;
use CWMP::Response;
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_path => 'state.db',
        queue => [ qw/GetRPCMethods GetParameterNames/ ],
        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;

        $self->store( CWMP::Store->new({
                debug => $self->debug,
                path => $self->store_path,
        }) );

        croak "can't open ", $self->store_path, ": $!" unless $self->store;

        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<< nr.dump >> 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 $chunk = $r->content;

        my $size = length( $chunk );

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

        if ( $self->debug > 2 ) {
                my $file = $dump_nr++ . '.dump';
                write_file( $file, $r->as_string );
                warn "### request dump: $file\n";
        }

        my $state;

        if ( $size > 0 ) {

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


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

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

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

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

                } else {
                        warn "## empty request\n";
                }

        } else {
                $state = $self->state;
                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 $xml = '';

        if ( my $dispatch = $state->{_dispatch} ) {
                $xml = $self->dispatch( $dispatch );
        } elsif ( $dispatch = shift @{ $self->queue } ) {
                $xml = $self->dispatch( $dispatch );
        } elsif ( $size == 0 ) {
                warn ">>> closing connection\n";
                return 0;
        } else {
                warn ">>> empty response\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\n";

        warn "### request over\n" if $self->debug;

        return 1;       # next request
};

=head2 dispatch

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

=cut

sub dispatch {
        my $self = shift;

        my $dispatch = shift || die "no dispatch?";

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

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