Masatoshi Mizuno
and 1 contributors

NAME

Egg::Model::Session::Manager::TieHash - Tie HASH base class for session manager.

SYNOPSIS

  package MyApp::Model::Session::TieHash;
  use base qw/ Egg::Model::Session::Manager::TieHash /;

DESCRIPTION

It is a base class for the TieHash class of the component module generated with Egg::Helper::Model::Sesson to use it.

METHODS

This module has succeeded to Egg::Component.

TIEHASH

This constructor is called among constructors of the Manager class. Therefore, because the application is executed at the same time when model is called, it is not necessary to consider it.

  # It is called at the same time at this time.
  my $session= $e->model('session_label');
  
  # The object of this class is obtained by 'Context' method of the Manager class.
  my $tiehash= $session->context;

data

The raw data of the session is returned.

Because 'is_update' is not renewed even if this value is operated directly, data is not preserved with 'close' method.

The thing used directly doesn't come recommended usually. Or, after the value is substituted, 'is_update' should be made effective.

  # This is equivalent to $session->{hoge}.
  my $hoge= $tiehash->data->{hoge};
  
  # 'is_update' is made effective if it saves data by the 'close' method.
  $tiehash->data->{banban}= 'hooo';
  $tiehash->is_update(1);
  
  # Only this makes 'is_update' effective usually.
  $session->{banban}= 'hooo';

attr

The HASH reference of the data etc. shared in this class is returned.

e

The object of the project is returned.

session_id

ID of the session that has been treated now is returned.

startup

It is a method of the terminal to keep interchangeability with the module of an old version.

is_new

Ture is returned if a present session is new.

is_update

When the value is substituted for the session data, it becomes effective.

However, please note not becoming effective because the substitution of the data of manipulating data directly by the data method and a deep hierarchy cannot be detected.

  # As for this, 'is_update' becomes effective at the same time. There is no 
  # necessity especially considered usually.
  $session->{hoge}= 'boo';
  
  # In this case, 'is_update' : like invalidity.
  $session->{mydata}{banban}= 'booo';
  
  # However, if the value of single hierarchical key can be updated even once,
  # 'is_update' becomes effective.
  $session->{hoge}= 'boo';
  $session->{mydata}{banban}= 'booo';
  
  # When data is operated directly, it is necessary to update 'is_update' for 
  # oneself.
  $tiehash->data->{hoo}= 'boo';
  $tiehash->is_update(1);

init_session

The session is initialized.

If session ID is obtained from the client, reading existing data is tried. New session ID is issued and a new session is begun when failing in this reading.

change

Session ID is newly issued and it exchanges it for existing ID.

Data is succeeded as it is.

  $session->{hoge}= 'boo';
  my $session_id= $session->session_id;
  
  $session->change;
  
  # Then, $session_id and $session->session_id become not equal.
  # The content of $session->{hoge} : like 'boo'.

clear

All the session data is cleared, new session ID is issued, and it makes it to a new session.

  $session->{hoge}= 'boo';
  my $session_id= $session->session_id;
  
  $session->clear;
  
  # Then, $session_id and $session->session_id disappear equally,
  # and $session->{hoge} is not obtained.

accept_session_id

Session ID is received from the client or a new session is issued and it returns it.

This method is used to use it internally.

output_session_id

It is processed to send the client session ID.

This method is called from 'close' method.

create_session_id

New session ID is issued and 'is_new' method is made effective.

store_encode

This method originally wards off the received data as it is though it is a method for the encode of the data passed to 'insert' and 'update' method.

This method is override by Store system module such as Egg::Model::Session::Store::Base64.

store_decode

This method originally wards off the received data as it is though it is a method for deciphered doing the data received from 'restore' method.

This method is override by Store system module such as Egg::Model::Session::Store::Base64.

valid_session_id

This method originally wards off received ID as it is though it is a method for the judgment whether the format of session ID received from the client is correct.

This method is override by ID system module such as Egg::Model::Session::ID::SHA1.

close

The session is close.

If 'is_update' method is effective, it saves data.

If 'is_new' is effective at this time, 'insert' method and if it is invalid, 'update' method is used for preservation.

And, after it preserves it, 'is_new' and 'is_update' are invalidated.

This method need not usually be called by the application because it is called with '_finish' hook at the end of processing.

ABSOLUTE METHODS

  • restore, insert, update, get_bind_data, set_bind_data, issue_session_id, make_session_id,

When the component module with the above-mentioned method is not loaded, the exception is generated.

  __PACKAGE__->startup qw/
    Base::FileCache
    ID::SHA1
    Bind::Cookie
    /;

COMPONENT MODULES

It is a component module of package enclosing list. Egg::Plugin::SessionKit

Base system

It processes it concerning the preservation of the session data.

Egg::Model::Session::Base::DBI, Egg::Model::Session::Base::DBIC, Egg::Model::Session::Base::FileCache,

ID system

It processes it concerning session ID issue etc.

Egg::Model::Session::ID::IPaddr, Egg::Model::Session::ID::SHA1, Egg::Model::Session::ID::MD5, Egg::Model::Session::ID::UniqueID, Egg::Model::Session::ID::UUID,

Store system

The encode of the session data and processing concerning the decipherment are done.

Egg::Model::Session::Store::Base64, Egg::Model::Session::Store::UUencode,

Plugin system

The function is enhanced.

Egg::Model::Session::Plugin::AbsoluteIP, Egg::Model::Session::Plugin::AgreeAgent, Egg::Model::Session::Plugin::CclassIP, Egg::Model::Session::Plugin::Ticket,

SEE ALSO

Egg::Release, Egg::Model::Session, Egg::Model::Session::Manager::Base, Egg::Helper::Model::Session, Egg::Component, Tie::ExtraHash,

AUTHOR

Masatoshi Mizuno <lushe@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2008 Bee Flag, Corp. <http://egg.bomcity.com/>, All Rights Reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.