use strict;
use warnings;
+use Digest::SHA1 ();
+
use Plack::Util::Accessor qw[
- generator
- extractor
session_key
+ sid_generator
];
sub new {
my ($class, %params) = @_;
- bless {
- session_key => $params{ session_key } || 'plack_session',
- generator => do { my $id = 1; sub { $id++ } },
- extractor => sub { $_[0]->param( $_[1] ) },
- expired => {}
- } => $class;
+
+ $params{'_expired'} ||= +{};
+ $params{'session_key'} ||= 'plack_session';
+ $params{'sid_generator'} ||= sub {
+ Digest::SHA1::sha1_hex(rand() . $$ . {} . time)
+ };
+
+ bless { %params } => $class;
}
sub expire_session_id {
my ($self, $id) = @_;
- $self->{expired}->{ $id }++;
+ $self->{'_expired'}->{ $id }++;
}
-sub extract {
- my ($self, $request) = @_;
- my $id = $self->extractor->( $request, $self->session_key );
- return unless $id && not exists $self->{expired}->{ $id };
- return $id;
+sub is_session_expired {
+ my ($self, $id) = @_;
+ exists $self->{'_expired'}->{ $id }
}
-sub generate {
- my $self = shift;
- $self->generator->()
+sub check_expired {
+ my ($self, $id) = @_;
+ return unless $id && not $self->is_session_expired( $id );
+ return $id;
}
-# given a request, get the
-# session id from it
sub get_session_id {
my ($self, $request) = @_;
$self->extract( $request )
||
- $self->generate
+ $self->generate( $request )
+}
+
+sub extract {
+ my ($self, $request) = @_;
+ $self->check_expired( $request->param( $self->session_key ) );
+}
+
+sub generate {
+ my $self = shift;
+ $self->sid_generator->( @_ );
}
-1;
\ No newline at end of file
+
+sub finalize {
+ my ($self, $id, $response) = @_;
+ ();
+}
+
+1;
+
+__END__
+
+=pod
+
+=head1 NAME
+
+Plack::Session::State - Basic parameter-based session state
+
+=head1 SYNOPSIS
+
+ use Plack::Builder;
+ use Plack::Middleware::Session;
+ use Plack::Session::State;
+
+ my $app = sub {
+ return [ 200, [ 'Content-Type' => 'text/plain' ], [ 'Hello Foo' ] ];
+ };
+
+ builder {
+ enable 'Session',
+ state => Plack::Session::State->new;
+ $app;
+ };
+
+=head1 DESCRIPTION
+
+This will maintain session state by passing the session through
+the request params. It does not do this automatically though,
+you are responsible for passing the session param.
+
+This should be considered the state "base" class (although
+subclassing is not a requirement) and defines the spec for
+all B<Plack::Session::State::*> modules. You will only
+need to override a couple methods if you do subclass. See
+L<Plack::Session::State::Cookie> for an example of this.
+
+=head1 METHODS
+
+=over 4
+
+=item B<new ( %params )>
+
+The C<%params> can include I<session_key> and I<sid_generator>,
+however in both cases a default will be provided for you.
+
+=item B<session_key>
+
+This is the name of the session key, it default to 'plack_session'.
+
+=item B<sid_generator>
+
+This is a CODE ref used to generate unique session ids, by default
+it will generate a SHA1 using fairly sufficient entropy. If you are
+concerned or interested, just read the source.
+
+=back
+
+=head2 Session ID Managment
+
+=over 4
+
+=item B<get_session_id ( $request )>
+
+Given a C<$request> this will first attempt to extract the session,
+if the is expired or does not exist, it will then generate a new
+session. The C<$request> is expected to be a L<Plack::Request> instance
+or an object with an equivalent interface.
+
+=item B<extract ( $request )>
+
+This will attempt to extract the session from a C<$request> by looking
+for the C<session_key> in the C<$request> params. It will then check to
+see if the session has expired and return the session id if it is not.
+The C<$request> is expected to be a L<Plack::Request> instance or an
+object with an equivalent interface.
+
+=item B<generate ( $request )>
+
+This will generate a new session id using the C<sid_generator> callback.
+The C<$request> argument is not used by this method but is there for
+use by subclasses. The C<$request> is expected to be a L<Plack::Request>
+instance or an object with an equivalent interface.
+
+=item B<finalize ( $session_id, $response )>
+
+Given a C<$session_id> and a C<$response> this will perform any
+finalization nessecary to preserve state. This method is called by
+the L<Plack::Session> C<finalize> method. The C<$response> is expected
+to be a L<Plack::Response> instance or an object with an equivalent
+interface.
+
+=back
+
+=head2 Session Expiration Handling
+
+=over 4
+
+=item B<expire_session_id ( $id )>
+
+This will mark the session for C<$id> as expired. This method is called
+by the L<Plack::Session> C<expire> method.
+
+=item B<is_session_expired ( $id )>
+
+This will check to see if the session C<$id> has been marked as
+expired.
+
+=item B<check_expired ( $id )>
+
+Given an session C<$id> this will return C<undef> if the session is
+expired or return the C<$id> if it is not.
+
+=back
+
+=head1 BUGS
+
+All complex software has bugs lurking in it, and this module is no
+exception. If you find a bug please either email me, or add the bug
+to cpan-RT.
+
+=head1 AUTHOR
+
+Stevan Little E<lt>stevan.little@iinteractive.comE<gt>
+
+=head1 COPYRIGHT AND LICENSE
+
+Copyright 2009 Infinity Interactive, Inc.
+
+L<http://www.iinteractive.com>
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+=cut
+
+