lib/DBM/Deep/Hash.pm

   1 package DBM::Deep::Hash;
   2
   3 use 5.6.0;
   4
   5 use strict;
   6 use warnings;
   7
   8 our $VERSION = q(0.99_03);
   9
  10 use base 'DBM::Deep';
  11
  12 sub _get_self {
  13     eval { local $SIG{'__DIE__'}; tied( %{$_[0]} ) } || $_[0]
  14 }
  15
  16 #XXX Need to add a check here for @_ % 2
  17 sub _repr { shift;return { @_ } }
  18
  19 sub _import {
  20     my $self = shift;
  21     my ($struct) = @_;
  22
  23     eval {
  24         local $SIG{'__DIE__'};
  25         foreach my $key (keys %$struct) {
  26             $self->put($key, $struct->{$key});
  27         }
  28     }; if ($@) {
  29         $self->_throw_error("Cannot import: type mismatch");
  30     }
  31
  32     return 1;
  33 }
  34
  35 sub TIEHASH {
  36     ##
  37     # Tied hash constructor method, called by Perl's tie() function.
  38     ##
  39     my $class = shift;
  40     my $args = $class->_get_args( @_ );
  41
  42     $args->{type} = $class->TYPE_HASH;
  43
  44     return $class->_init($args);
  45 }
  46
  47 sub FETCH {
  48     my $self = shift->_get_self;
  49     my $key = ($self->_fileobj->{filter_store_key})
  50         ? $self->_fileobj->{filter_store_key}->($_[0])
  51         : $_[0];
  52
  53     return $self->SUPER::FETCH( $key, $_[0] );
  54 }
  55
  56 sub STORE {
  57     my $self = shift->_get_self;
  58         my $key = ($self->_fileobj->{filter_store_key})
  59         ? $self->_fileobj->{filter_store_key}->($_[0])
  60         : $_[0];
  61     my $value = $_[1];
  62
  63     return $self->SUPER::STORE( $key, $value, $_[0] );
  64 }
  65
  66 sub EXISTS {
  67     my $self = shift->_get_self;
  68         my $key = ($self->_fileobj->{filter_store_key})
  69         ? $self->_fileobj->{filter_store_key}->($_[0])
  70         : $_[0];
  71
  72     return $self->SUPER::EXISTS( $key );
  73 }
  74
  75 sub DELETE {
  76     my $self = shift->_get_self;
  77         my $key = ($self->_fileobj->{filter_store_key})
  78         ? $self->_fileobj->{filter_store_key}->($_[0])
  79         : $_[0];
  80
  81     return $self->SUPER::DELETE( $key, $_[0] );
  82 }
  83
  84 sub FIRSTKEY {
  85         ##
  86         # Locate and return first key (in no particular order)
  87         ##
  88     my $self = shift->_get_self;
  89
  90         ##
  91         # Request shared lock for reading
  92         ##
  93         $self->lock( $self->LOCK_SH );
  94
  95         my $result = $self->_engine->get_next_key($self->_base_offset);
  96
  97         $self->unlock();
  98
  99         return ($result && $self->_fileobj->{filter_fetch_key})
 100         ? $self->_fileobj->{filter_fetch_key}->($result)
 101         : $result;
 102 }
 103
 104 sub NEXTKEY {
 105         ##
 106         # Return next key (in no particular order), given previous one
 107         ##
 108     my $self = shift->_get_self;
 109
 110         my $prev_key = ($self->_fileobj->{filter_store_key})
 111         ? $self->_fileobj->{filter_store_key}->($_[0])
 112         : $_[0];
 113
 114         ##
 115         # Request shared lock for reading
 116         ##
 117         $self->lock( $self->LOCK_SH );
 118
 119         my $result = $self->_engine->get_next_key( $self->_base_offset, $prev_key );
 120
 121         $self->unlock();
 122
 123         return ($result && $self->_fileobj->{filter_fetch_key})
 124         ? $self->_fileobj->{filter_fetch_key}->($result)
 125         : $result;
 126 }
 127
 128 ##
 129 # Public method aliases
 130 ##
 131 sub first_key { (shift)->FIRSTKEY(@_) }
 132 sub next_key { (shift)->NEXTKEY(@_) }
 133
 134 sub _copy_node {
 135     my $self = shift;
 136     my ($db_temp) = @_;
 137
 138     my $key = $self->first_key();
 139     while ($key) {
 140         my $value = $self->get($key);
 141         $self->_copy_value( \$db_temp->{$key}, $value );
 142         $key = $self->next_key($key);
 143     }
 144
 145     return 1;
 146 }
 147
 148 1;
 149 __END__