Commit | Line | Data |
---|---|---|
6fe26b29 | 1 | package DBM::Deep::Hash; |
2 | ||
b48ae6ec | 3 | use 5.006_000; |
460b1067 | 4 | |
6fe26b29 | 5 | use strict; |
460b1067 | 6 | use warnings; |
6fe26b29 | 7 | |
ef3cf62e | 8 | our $VERSION = q(1.0005); |
86867f3a | 9 | |
6fe26b29 | 10 | use base 'DBM::Deep'; |
11 | ||
596e9574 | 12 | sub _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 | 17 | sub _repr { shift;return { @_ } } |
18 | ||
19 | sub _import { | |
20 | my $self = shift; | |
21 | my ($struct) = @_; | |
22 | ||
9a63e1f2 | 23 | foreach my $key (keys %$struct) { |
24 | $self->put($key, $struct->{$key}); | |
f9c33187 | 25 | } |
26 | ||
27 | return 1; | |
28 | } | |
29 | ||
6fe26b29 | 30 | sub TIEHASH { |
31 | ## | |
32 | # Tied hash constructor method, called by Perl's tie() function. | |
33 | ## | |
34 | my $class = shift; | |
0ca7ea98 | 35 | my $args = $class->_get_args( @_ ); |
6fe26b29 | 36 | |
37 | $args->{type} = $class->TYPE_HASH; | |
38 | ||
39 | return $class->_init($args); | |
40 | } | |
41 | ||
cb79ec85 | 42 | sub FETCH { |
43 | my $self = shift->_get_self; | |
9a63e1f2 | 44 | DBM::Deep->_throw_error( "Cannot use an undefined hash key." ) unless defined $_[0]; |
83371fe3 | 45 | my $key = ($self->_storage->{filter_store_key}) |
46 | ? $self->_storage->{filter_store_key}->($_[0]) | |
cb79ec85 | 47 | : $_[0]; |
48 | ||
359a01ac | 49 | return $self->SUPER::FETCH( $key, $_[0] ); |
cb79ec85 | 50 | } |
51 | ||
81d3d316 | 52 | sub STORE { |
53 | my $self = shift->_get_self; | |
9a63e1f2 | 54 | DBM::Deep->_throw_error( "Cannot use an undefined hash key." ) unless defined $_[0]; |
e137c258 | 55 | my $key = ($self->_storage->{filter_store_key}) |
83371fe3 | 56 | ? $self->_storage->{filter_store_key}->($_[0]) |
81d3d316 | 57 | : $_[0]; |
58 | my $value = $_[1]; | |
59 | ||
359a01ac | 60 | return $self->SUPER::STORE( $key, $value, $_[0] ); |
81d3d316 | 61 | } |
62 | ||
baa27ab6 | 63 | sub EXISTS { |
64 | my $self = shift->_get_self; | |
9a63e1f2 | 65 | DBM::Deep->_throw_error( "Cannot use an undefined hash key." ) unless defined $_[0]; |
e137c258 | 66 | my $key = ($self->_storage->{filter_store_key}) |
83371fe3 | 67 | ? $self->_storage->{filter_store_key}->($_[0]) |
baa27ab6 | 68 | : $_[0]; |
69 | ||
70 | return $self->SUPER::EXISTS( $key ); | |
71 | } | |
72 | ||
feaf1e6f | 73 | sub DELETE { |
74 | my $self = shift->_get_self; | |
9a63e1f2 | 75 | DBM::Deep->_throw_error( "Cannot use an undefined hash key." ) unless defined $_[0]; |
e137c258 | 76 | my $key = ($self->_storage->{filter_store_key}) |
83371fe3 | 77 | ? $self->_storage->{filter_store_key}->($_[0]) |
feaf1e6f | 78 | : $_[0]; |
79 | ||
359a01ac | 80 | return $self->SUPER::DELETE( $key, $_[0] ); |
feaf1e6f | 81 | } |
82 | ||
6fe26b29 | 83 | sub FIRSTKEY { |
e137c258 | 84 | ## |
85 | # Locate and return first key (in no particular order) | |
86 | ## | |
eea0d863 | 87 | my $self = shift->_get_self; |
6fe26b29 | 88 | |
e137c258 | 89 | ## |
90 | # Request shared lock for reading | |
91 | ## | |
92 | $self->lock( $self->LOCK_SH ); | |
93 | ||
94 | my $result = $self->_engine->get_next_key( $self ); | |
95 | ||
96 | $self->unlock(); | |
97 | ||
98 | return ($result && $self->_storage->{filter_fetch_key}) | |
83371fe3 | 99 | ? $self->_storage->{filter_fetch_key}->($result) |
6fe26b29 | 100 | : $result; |
101 | } | |
102 | ||
103 | sub NEXTKEY { | |
e137c258 | 104 | ## |
105 | # Return next key (in no particular order), given previous one | |
106 | ## | |
eea0d863 | 107 | my $self = shift->_get_self; |
6fe26b29 | 108 | |
e137c258 | 109 | my $prev_key = ($self->_storage->{filter_store_key}) |
83371fe3 | 110 | ? $self->_storage->{filter_store_key}->($_[0]) |
eea0d863 | 111 | : $_[0]; |
6fe26b29 | 112 | |
e137c258 | 113 | ## |
114 | # Request shared lock for reading | |
115 | ## | |
116 | $self->lock( $self->LOCK_SH ); | |
117 | ||
118 | my $result = $self->_engine->get_next_key( $self, $prev_key ); | |
119 | ||
120 | $self->unlock(); | |
121 | ||
122 | return ($result && $self->_storage->{filter_fetch_key}) | |
83371fe3 | 123 | ? $self->_storage->{filter_fetch_key}->($result) |
6fe26b29 | 124 | : $result; |
125 | } | |
126 | ||
127 | ## | |
128 | # Public method aliases | |
129 | ## | |
f9c33187 | 130 | sub first_key { (shift)->FIRSTKEY(@_) } |
131 | sub next_key { (shift)->NEXTKEY(@_) } | |
132 | ||
133 | sub _copy_node { | |
898fd1fd | 134 | my $self = shift; |
f9c33187 | 135 | my ($db_temp) = @_; |
136 | ||
137 | my $key = $self->first_key(); | |
138 | while ($key) { | |
139 | my $value = $self->get($key); | |
140 | $self->_copy_value( \$db_temp->{$key}, $value ); | |
141 | $key = $self->next_key($key); | |
142 | } | |
143 | ||
144 | return 1; | |
145 | } | |
6fe26b29 | 146 | |
147 | 1; | |
148 | __END__ |