r13607@rob-kinyons-powerbook58: rob | 2006-05-25 15:12:31 -0400
[dbsrgits/DBM-Deep.git] / lib / DBM / Deep / Hash.pm
CommitLineData
6fe26b29 1package DBM::Deep::Hash;
2
460b1067 3use 5.6.0;
4
6fe26b29 5use strict;
460b1067 6use warnings;
6fe26b29 7
c3aafc14 8our $VERSION = q(0.99_03);
86867f3a 9
6fe26b29 10use base 'DBM::Deep';
11
596e9574 12sub _get_self {
a4e2db58 13 eval { local $SIG{'__DIE__'}; tied( %{$_[0]} ) } || $_[0]
596e9574 14}
15
12b96196 16#XXX Need to add a check here for @_ % 2
f9c33187 17sub _repr { shift;return { @_ } }
18
19sub _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
6fe26b29 35sub TIEHASH {
36 ##
37 # Tied hash constructor method, called by Perl's tie() function.
38 ##
39 my $class = shift;
0ca7ea98 40 my $args = $class->_get_args( @_ );
6fe26b29 41
42 $args->{type} = $class->TYPE_HASH;
43
44 return $class->_init($args);
45}
46
cb79ec85 47sub FETCH {
48 my $self = shift->_get_self;
460b1067 49 my $key = ($self->_fileobj->{filter_store_key})
50 ? $self->_fileobj->{filter_store_key}->($_[0])
cb79ec85 51 : $_[0];
52
359a01ac 53 return $self->SUPER::FETCH( $key, $_[0] );
cb79ec85 54}
55
81d3d316 56sub STORE {
57 my $self = shift->_get_self;
460b1067 58 my $key = ($self->_fileobj->{filter_store_key})
59 ? $self->_fileobj->{filter_store_key}->($_[0])
81d3d316 60 : $_[0];
61 my $value = $_[1];
62
359a01ac 63 return $self->SUPER::STORE( $key, $value, $_[0] );
81d3d316 64}
65
baa27ab6 66sub EXISTS {
67 my $self = shift->_get_self;
460b1067 68 my $key = ($self->_fileobj->{filter_store_key})
69 ? $self->_fileobj->{filter_store_key}->($_[0])
baa27ab6 70 : $_[0];
71
72 return $self->SUPER::EXISTS( $key );
73}
74
feaf1e6f 75sub DELETE {
76 my $self = shift->_get_self;
460b1067 77 my $key = ($self->_fileobj->{filter_store_key})
78 ? $self->_fileobj->{filter_store_key}->($_[0])
feaf1e6f 79 : $_[0];
80
359a01ac 81 return $self->SUPER::DELETE( $key, $_[0] );
feaf1e6f 82}
83
6fe26b29 84sub FIRSTKEY {
85 ##
86 # Locate and return first key (in no particular order)
87 ##
eea0d863 88 my $self = shift->_get_self;
6fe26b29 89
90 ##
6fe26b29 91 # Request shared lock for reading
92 ##
93 $self->lock( $self->LOCK_SH );
94
83c43bb5 95 my $result = $self->_engine->get_next_key($self->_base_offset);
6fe26b29 96
97 $self->unlock();
98
460b1067 99 return ($result && $self->_fileobj->{filter_fetch_key})
100 ? $self->_fileobj->{filter_fetch_key}->($result)
6fe26b29 101 : $result;
102}
103
104sub NEXTKEY {
105 ##
106 # Return next key (in no particular order), given previous one
107 ##
eea0d863 108 my $self = shift->_get_self;
6fe26b29 109
460b1067 110 my $prev_key = ($self->_fileobj->{filter_store_key})
111 ? $self->_fileobj->{filter_store_key}->($_[0])
eea0d863 112 : $_[0];
6fe26b29 113
6fe26b29 114 ##
6fe26b29 115 # Request shared lock for reading
116 ##
117 $self->lock( $self->LOCK_SH );
118
83c43bb5 119 my $result = $self->_engine->get_next_key( $self->_base_offset, $prev_key );
6fe26b29 120
121 $self->unlock();
122
460b1067 123 return ($result && $self->_fileobj->{filter_fetch_key})
124 ? $self->_fileobj->{filter_fetch_key}->($result)
6fe26b29 125 : $result;
126}
127
128##
129# Public method aliases
130##
f9c33187 131sub first_key { (shift)->FIRSTKEY(@_) }
132sub next_key { (shift)->NEXTKEY(@_) }
133
134sub _copy_node {
898fd1fd 135 my $self = shift;
f9c33187 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}
6fe26b29 147
1481;
149__END__