| File | /usr/share/perl5/CGI/Session/Serialize/yaml.pm | Statements Executed | 17 | Total Time | 0.0003 seconds |
| Calls | Inclusive Time | Subroutine | |
|---|---|---|---|
| 1 | 0.00016 | CGI::Session::Serialize::yaml:: | freeze |
| 0 | 0 | CGI::Session::Serialize::yaml:: | thaw |
| Line | Stmts. | Exclusive Time | Avg. | Code |
|---|---|---|---|---|
| 1 | package CGI::Session::Serialize::yaml; | |||
| 2 | ||||
| 3 | 3 | 0.00003 | 9e-06 | use strict; # spent 0.00001s making 1 calls to strict::import |
| 4 | 3 | 0.00018 | 0.00006 | use CGI::Session::ErrorHandler; # spent 3e-06s making 1 calls to 1 |
| 5 | ||||
| 6 | 1 | 1e-06 | 1e-06 | $CGI::Session::Serialize::yaml::VERSION = '4.20'; |
| 7 | 1 | 2e-06 | 2e-06 | @CGI::Session::Serialize::yaml::ISA = ( "CGI::Session::ErrorHandler" ); |
| 8 | 1 | 1e-06 | 1e-06 | our $Flavour; |
| 9 | ||||
| 10 | 1 | 0 | 0 | unless($Flavour) { |
| 11 | 3 | 0.00006 | 0.00002 | my $package = (grep { eval("use $_ (); 1;") } qw(YAML::Syck YAML))[0] |
| 12 | or die "Either YAML::Syck or YAML are required to use ", __PACKAGE__; | |||
| 13 | 1 | 1e-06 | 1e-06 | $Flavour = $package; |
| 14 | } | |||
| 15 | ||||
| 16 | # spent 0.00016s within CGI::Session::Serialize::yaml::freeze which was called:
# 1 times (0.00016s) by CGI::Session::flush at line 240 of /usr/share/perl5/CGI/Session.pm sub freeze { | |||
| 17 | 1 | 1e-06 | 1e-06 | my ($self, $data) = @_; |
| 18 | 1 | 0.00002 | 0.00002 | return $Flavour->can('Dump')->($data); # spent 0.00014s making 1 calls to YAML::Syck::Dump
# spent 7e-06s making 1 calls to UNIVERSAL::can |
| 19 | } | |||
| 20 | ||||
| 21 | ||||
| 22 | sub thaw { | |||
| 23 | my ($self, $string) = @_; | |||
| 24 | return ($Flavour->can('Load')->($string))[0]; | |||
| 25 | } | |||
| 26 | ||||
| 27 | 1 | 9e-06 | 9e-06 | 1; |
| 28 | ||||
| 29 | __END__; | |||
| 30 | ||||
| 31 | =pod | |||
| 32 | ||||
| 33 | =head1 NAME | |||
| 34 | ||||
| 35 | CGI::Session::Serialize::yaml - serializer for CGI::Session | |||
| 36 | ||||
| 37 | =head1 DESCRIPTION | |||
| 38 | ||||
| 39 | This library can be used by CGI::Session to serialize session data. It uses | |||
| 40 | L<YAML|YAML>, or the faster C implementation, L<YAML::Syck|YAML::Syck> | |||
| 41 | if it is available. YAML serializers exist not just for Perl but also other | |||
| 42 | dynamic languages, such as PHP, Python, and Ruby, so storing session data | |||
| 43 | in this format makes it easy to share session data across different languages. | |||
| 44 | ||||
| 45 | YAML is made to be friendly for humans to parse as well as other computer | |||
| 46 | languages. It creates a format that is easier to read than the default | |||
| 47 | serializer. | |||
| 48 | ||||
| 49 | =head1 METHODS | |||
| 50 | ||||
| 51 | =over 4 | |||
| 52 | ||||
| 53 | =item freeze($class, \%hash) | |||
| 54 | ||||
| 55 | Receives two arguments. First is the class name, the second is the data to be serialized. Should return serialized string on success, undef on failure. Error message should be set using C<set_error()|CGI::Session::ErrorHandler/"set_error()"> | |||
| 56 | ||||
| 57 | =item thaw($class, $string) | |||
| 58 | ||||
| 59 | Received two arguments. First is the class name, second is the I<YAML> data string. Should return thawed data structure on success, undef on failure. Error message should be set using C<set_error()|CGI::Session::ErrorHandler/"set_error()"> | |||
| 60 | ||||
| 61 | =back | |||
| 62 | ||||
| 63 | =head1 SEE ALSO | |||
| 64 | ||||
| 65 | L<CGI::Session>, L<YAML>, L<YAML::Syck>. | |||
| 66 | ||||
| 67 | =cut |