Broke out write_value in order to create scalarrefs
[dbsrgits/DBM-Deep.git] / lib / DBM / Deep / Engine.pm
index c7da872..9cfeef4 100644 (file)
@@ -4,6 +4,20 @@ use strict;
 
 use Fcntl qw( :DEFAULT :flock :seek );
 
+##
+# Setup file and tag signatures.  These should never change.
+##
+sub SIG_FILE     () { 'DPDB' }
+sub SIG_INTERNAL () { 'i'    }
+sub SIG_HASH     () { 'H'    }
+sub SIG_ARRAY    () { 'A'    }
+sub SIG_REF      () { 'R'    }
+sub SIG_NULL     () { 'N'    }
+sub SIG_DATA     () { 'D'    }
+sub SIG_INDEX    () { 'I'    }
+sub SIG_BLIST    () { 'B'    }
+sub SIG_SIZE     () {  1     }
+
 sub precalc_sizes {
     ##
     # Precalculate index, bucket and bucket list sizes
@@ -37,9 +51,9 @@ sub set_pack {
 
     ##
     # Set to 4 and 'N' for 32-bit data length prefixes.  Limit of 4 GB for each
-    # key/value. Upgrading this is possible (see above) but probably not necessary.
-    # If you need more than 4 GB for a single key or value, this module is really
-    # not for you :-)
+    # key/value. Upgrading this is possible (see above) but probably not
+    # necessary. If you need more than 4 GB for a single key or value, this
+    # module is really not for you :-)
     ##
     $self->{data_size} = $data_s ? $data_s : 4;
     $self->{data_pack} = $data_p ? $data_p : 'N';
@@ -74,9 +88,11 @@ sub new {
         hash_size   => 16,
 
         ##
-        # Maximum number of buckets per list before another level of indexing is done.
-        # Increase this value for slightly greater speed, but larger database files.
-        # DO NOT decrease this value below 16, due to risk of recursive reindex overrun.
+        # Maximum number of buckets per list before another level of indexing is
+        # done.
+        # Increase this value for slightly greater speed, but larger database
+        # files. DO NOT decrease this value below 16, due to risk of recursive
+        # reindex overrun.
         ##
         max_buckets => 16,
     }, $class;
@@ -117,8 +133,9 @@ sub open {
     my $flags = O_RDWR | O_CREAT | O_BINARY;
 
     my $fh;
-    sysopen( $fh, $obj->_root->{file}, $flags )
-        or $obj->_throw_error("Cannot sysopen file: " . $obj->_root->{file} . ": $!");
+    my $filename = $obj->_root->{file};
+    sysopen( $fh, $filename, $flags )
+        or $obj->_throw_error("Cannot sysopen file '$filename': $!");
     $obj->_root->{fh} = $fh;
 
     #XXX Can we remove this by using the right sysopen() flags?
@@ -132,24 +149,20 @@ sub open {
     }
 
     seek($fh, 0 + $obj->_root->{file_offset}, SEEK_SET);
-
     my $signature;
-    my $bytes_read = read( $fh, $signature, length(DBM::Deep->SIG_FILE));
+    my $bytes_read = read( $fh, $signature, length(SIG_FILE));
 
     ##
     # File is empty -- write signature and master index
     ##
     if (!$bytes_read) {
         seek($fh, 0 + $obj->_root->{file_offset}, SEEK_SET);
-        print( $fh DBM::Deep->SIG_FILE);
+        print( $fh SIG_FILE);
 
-        $self->create_tag($obj, $obj->_base_offset, $obj->_type, chr(0) x $self->{index_size});
-
-        # Why is this being printed here? I'm not seeing where anything actually points to
-        # this spot.
-        #XXX $obj->_root->{end} isn't updated from these 10 bytes that are being written
-        my $plain_key = "[base]";
-        print( $fh pack($self->{data_pack}, length($plain_key)) . $plain_key );
+        $self->create_tag(
+            $obj, $obj->_base_offset, $obj->_type,
+            chr(0) x $self->{index_size},
+        );
 
         # Flush the filehandle
         my $old_fh = select $fh;
@@ -162,7 +175,7 @@ sub open {
     ##
     # Check signature was valid
     ##
-    unless ($signature eq DBM::Deep->SIG_FILE) {
+    unless ($signature eq SIG_FILE) {
         $self->close_fh( $obj );
         $obj->_throw_error("Signature not found -- file is not a Deep DB");
     }
@@ -209,13 +222,13 @@ sub create_tag {
     print( $fh $sig . pack($self->{data_pack}, $size) . $content );
 
     if ($offset == $obj->_root->{end}) {
-        $obj->_root->{end} += DBM::Deep->SIG_SIZE + $self->{data_size} + $size;
+        $obj->_root->{end} += SIG_SIZE + $self->{data_size} + $size;
     }
 
     return {
         signature => $sig,
         size => $size,
-        offset => $offset + DBM::Deep->SIG_SIZE + $self->{data_size},
+        offset => $offset + SIG_SIZE + $self->{data_size},
         content => $content
     };
 }
@@ -235,7 +248,7 @@ sub load_tag {
     return if eof $fh;
 
     my $b;
-    read( $fh, $b, DBM::Deep->SIG_SIZE + $self->{data_size} );
+    read( $fh, $b, SIG_SIZE + $self->{data_size} );
     my ($sig, $size) = unpack( "A $self->{data_pack}", $b );
 
     my $buffer;
@@ -244,7 +257,7 @@ sub load_tag {
     return {
         signature => $sig,
         size => $size,
-        offset => $offset + DBM::Deep->SIG_SIZE + $self->{data_size},
+        offset => $offset + SIG_SIZE + $self->{data_size},
         content => $buffer
     };
 }
@@ -257,189 +270,180 @@ sub add_bucket {
     my $self = shift;
     my ($obj, $tag, $md5, $plain_key, $value) = @_;
 
-    my $keys = $tag->{content};
     my $location = 0;
     my $result = 2;
 
     my $root = $obj->_root;
 
-    my $is_dbm_deep = eval { local $SIG{'__DIE__'}; $value->isa( 'DBM::Deep' ) };
+    my $is_dbm_deep = eval {
+        local $SIG{'__DIE__'};
+        $value->isa( 'DBM::Deep' );
+    };
+
     my $internal_ref = $is_dbm_deep && ($value->_root eq $root);
 
     my $fh = $obj->_fh;
 
-    ##
-    # Iterate through buckets, seeing if this is a new entry or a replace.
-    ##
-    BUCKET:
-    for (my $i = 0; $i < $self->{max_buckets}; $i++) {
-        my ($key, $subloc) = $self->_get_key_subloc( $keys, $i );
-
-        if (!$subloc) {
-            ##
-            # Found empty bucket (end of list).  Populate and exit loop.
-            ##
-            $result = 2;
-
-            $location = $internal_ref
-                ? $value->_base_offset
-                : $root->{end};
-print "NEW: $location\n";
-
-            seek(
-                $fh,
-                $tag->{offset} + ($i * $self->{bucket_size}) + $root->{file_offset},
-                SEEK_SET,
-            );
-
-            print( $fh $md5 . pack($self->{long_pack}, $location) );
-            last;
-        }
-
-        if ( $md5 ne $key ) {
-            next BUCKET;
-        }
+    my ($subloc, $offset) = $self->_find_in_buckets( $tag, $md5 );
 
-        ##
-        # Found existing bucket with same key.  Replace with new value.
-        ##
+    # Updating a known md5
+    if ( $subloc ) {
         $result = 1;
 
-        if ($internal_ref) {
-            $location = $value->_base_offset;
-            seek($fh, $tag->{offset} + ($i * $self->{bucket_size}) + $root->{file_offset}, SEEK_SET);
-            print( $fh $md5 . pack($self->{long_pack}, $location) );
-            return $result;
-        }
-
-        seek($fh, $subloc + DBM::Deep->SIG_SIZE + $root->{file_offset}, SEEK_SET);
-        my $size;
-        read( $fh, $size, $self->{data_size});
-        $size = unpack($self->{data_pack}, $size);
-
         ##
-        # If value is a hash, array, or raw value with equal or less size, we can
-        # reuse the same content area of the database.  Otherwise, we have to create
-        # a new content area at the EOF.
+        # If value is a hash, array, or raw value with equal or less size, we
+        # can reuse the same content area of the database.  Otherwise, we have
+        # to create a new content area at the EOF.
         ##
         my $actual_length;
-        my $r = Scalar::Util::reftype( $value ) || '';
-        if ( $r eq 'HASH' || $r eq 'ARRAY' ) {
-            $actual_length = $self->{index_size};
-
-            # if autobless is enabled, must also take into consideration
-            # the class name, as it is stored along with key/value.
-            if ( $root->{autobless} ) {
-                my $value_class = Scalar::Util::blessed($value);
-                if ( defined $value_class && !$value->isa('DBM::Deep') ) {
-                    $actual_length += length($value_class);
+        if ( $internal_ref ) {
+            $actual_length = $self->{long_size};
+        }
+        else {
+            my $r = Scalar::Util::reftype( $value ) || '';
+            if ( $r eq 'HASH' || $r eq 'ARRAY' ) {
+                $actual_length = $self->{index_size};
+
+                # if autobless is enabled, must also take into consideration
+                # the class name, as it is stored along with key/value.
+                if ( $root->{autobless} ) {
+                    my $value_class = Scalar::Util::blessed($value);
+                    if ( defined $value_class && !$value->isa('DBM::Deep') ) {
+                        $actual_length += length($value_class);
+                    }
                 }
             }
+            else { $actual_length = length($value); }
         }
-        else { $actual_length = length($value); }
+
+        seek($fh, $subloc + SIG_SIZE + $root->{file_offset}, SEEK_SET);
+        my $size;
+        read( $fh, $size, $self->{data_size});
+        $size = unpack($self->{data_pack}, $size);
 
         if ($actual_length <= $size) {
             $location = $subloc;
         }
         else {
             $location = $root->{end};
-            seek($fh, $tag->{offset} + ($i * $self->{bucket_size}) + $self->{hash_size} + $root->{file_offset}, SEEK_SET);
+            seek(
+                $fh,
+                $tag->{offset} + $offset + $self->{hash_size} + $root->{file_offset},
+                SEEK_SET,
+            );
             print( $fh pack($self->{long_pack}, $location) );
         }
-
-        last;
     }
+    # Adding a new md5
+    elsif ( defined $offset ) {
+        $result = 2;
+        $location = $root->{end};
 
-    ##
-    # If this is an internal reference, return now.
-    # No need to write value or plain key
-    ##
-    #XXX We need to store the key as a reference to the internal spot
-    if ($internal_ref) {
-        return $result;
+        seek( $fh, $tag->{offset} + $offset + $root->{file_offset}, SEEK_SET );
+        print( $fh $md5 . pack($self->{long_pack}, $location) );
     }
-
-    ##
     # If bucket didn't fit into list, split into a new index level
-    ##
-    if (!$location) {
-        # re-index bucket list
-
+    else {
         $self->split_index( $obj, $md5, $tag );
 
         $location = $root->{end};
     }
 
+    $self->write_value( $obj, $location, $plain_key, $value );
+
+    return $result;
+}
+
+sub write_value {
+    my $self = shift;
+    my ($obj, $location, $key, $value) = @_;
+
+    my $fh = $obj->_fh;
+    my $root = $obj->_root;
+
+    my $is_dbm_deep = eval {
+        local $SIG{'__DIE__'};
+        $value->isa( 'DBM::Deep' );
+    };
+
+    my $internal_ref = $is_dbm_deep && ($value->_root eq $root);
+
+    seek($fh, $location + $root->{file_offset}, SEEK_SET);
+
     ##
-    # Seek to content area and store signature, value and plaintext key
+    # Write signature based on content type, set content length and write
+    # actual value.
     ##
-    if ($location) {
-        my $content_length;
-        seek($fh, $location + $root->{file_offset}, SEEK_SET);
-
-        ##
-        # Write signature based on content type, set content length and write actual value.
-        ##
-        my $r = Scalar::Util::reftype($value) || '';
+    my $r = Scalar::Util::reftype($value) || '';
+    my $content_length;
+    if ( $internal_ref ) {
+        print( $fh SIG_INTERNAL );
+        print( $fh pack($self->{data_pack}, $self->{long_size}) );
+        print( $fh pack($self->{long_pack}, $value->_base_offset) );
+        $content_length = $self->{long_size};
+    }
+    else {
         if ($r eq 'HASH') {
-            print( $fh DBM::Deep->TYPE_HASH );
+            print( $fh SIG_HASH );
             print( $fh pack($self->{data_pack}, $self->{index_size}) . chr(0) x $self->{index_size} );
             $content_length = $self->{index_size};
         }
         elsif ($r eq 'ARRAY') {
-            print( $fh DBM::Deep->TYPE_ARRAY );
+            print( $fh SIG_ARRAY );
             print( $fh pack($self->{data_pack}, $self->{index_size}) . chr(0) x $self->{index_size} );
             $content_length = $self->{index_size};
         }
         elsif (!defined($value)) {
-            print( $fh DBM::Deep->SIG_NULL );
+            print( $fh SIG_NULL );
             print( $fh pack($self->{data_pack}, 0) );
             $content_length = 0;
         }
         else {
-            print( $fh DBM::Deep->SIG_DATA );
+            print( $fh SIG_DATA );
             print( $fh pack($self->{data_pack}, length($value)) . $value );
             $content_length = length($value);
         }
+    }
 
-        ##
-        # Plain key is stored AFTER value, as keys are typically fetched less often.
-        ##
-        print( $fh pack($self->{data_pack}, length($plain_key)) . $plain_key );
+    ##
+    # Plain key is stored AFTER value, as keys are typically fetched less often.
+    ##
+    print( $fh pack($self->{data_pack}, length($key)) . $key );
 
-        ##
-        # If value is blessed, preserve class name
-        ##
-        if ( $root->{autobless} ) {
-            my $value_class = Scalar::Util::blessed($value);
-            if ( defined $value_class && $value_class ne 'DBM::Deep' ) {
-                ##
-                # Blessed ref -- will restore later
-                ##
-                print( $fh chr(1) );
-                print( $fh pack($self->{data_pack}, length($value_class)) . $value_class );
-                $content_length += 1;
-                $content_length += $self->{data_size} + length($value_class);
-            }
-            else {
-                print( $fh chr(0) );
-                $content_length += 1;
-            }
+    ##
+    # If value is blessed, preserve class name
+    ##
+    if ( $root->{autobless} ) {
+        my $value_class = Scalar::Util::blessed($value);
+        if ( defined $value_class && !$value->isa( 'DBM::Deep' ) ) {
+            ##
+            # Blessed ref -- will restore later
+            ##
+            print( $fh chr(1) );
+            print( $fh pack($self->{data_pack}, length($value_class)) . $value_class );
+            $content_length += 1;
+            $content_length += $self->{data_size} + length($value_class);
         }
-
-        ##
-        # If this is a new content area, advance EOF counter
-        ##
-        if ($location == $root->{end}) {
-            $root->{end} += DBM::Deep->SIG_SIZE;
-            $root->{end} += $self->{data_size} + $content_length;
-            $root->{end} += $self->{data_size} + length($plain_key);
+        else {
+            print( $fh chr(0) );
+            $content_length += 1;
         }
+    }
 
-        ##
-        # If content is a hash or array, create new child DBM::Deep object and
-        # pass each key or element to it.
-        ##
+    ##
+    # If this is a new content area, advance EOF counter
+    ##
+    if ($location == $root->{end}) {
+        $root->{end} += SIG_SIZE;
+        $root->{end} += $self->{data_size} + $content_length;
+        $root->{end} += $self->{data_size} + length($key);
+    }
+
+    ##
+    # If content is a hash or array, create new child DBM::Deep object and
+    # pass each key or element to it.
+    ##
+    if ( ! $internal_ref ) {
         if ($r eq 'HASH') {
             my $branch = DBM::Deep->new(
                 type => DBM::Deep->TYPE_HASH,
@@ -462,11 +466,9 @@ print "NEW: $location\n";
                 $index++;
             }
         }
-
-        return $result;
     }
 
-    $obj->_throw_error("Fatal error: indexing failed -- possibly due to corruption in file");
+    return 1;
 }
 
 sub split_index {
@@ -483,7 +485,7 @@ sub split_index {
     my $index_tag = $self->create_tag(
         $obj,
         $root->{end},
-        DBM::Deep->SIG_INDEX,
+        SIG_INDEX,
         chr(0) x $self->{index_size},
     );
 
@@ -500,7 +502,7 @@ sub split_index {
         my $num = ord(substr($key, $tag->{ch} + 1, 1));
 
         if ($offsets[$num]) {
-            my $offset = $offsets[$num] + DBM::Deep->SIG_SIZE + $self->{data_size};
+            my $offset = $offsets[$num] + SIG_SIZE + $self->{data_size};
             seek($fh, $offset + $root->{file_offset}, SEEK_SET);
             my $subkeys;
             read( $fh, $subkeys, $self->{bucket_list_size});
@@ -520,7 +522,7 @@ sub split_index {
             seek($fh, $index_tag->{offset} + ($num * $self->{long_size}) + $root->{file_offset}, SEEK_SET);
             print( $fh pack($self->{long_pack}, $root->{end}) );
 
-            my $blist_tag = $self->create_tag($obj, $root->{end}, DBM::Deep->SIG_BLIST, chr(0) x $self->{bucket_list_size});
+            my $blist_tag = $self->create_tag($obj, $root->{end}, SIG_BLIST, chr(0) x $self->{bucket_list_size});
 
             seek($fh, $blist_tag->{offset} + $root->{file_offset}, SEEK_SET);
             print( $fh $key . pack($self->{long_pack}, $old_subloc || $root->{end}) );
@@ -530,138 +532,120 @@ sub split_index {
     return;
 }
 
-sub get_bucket_value {
-    ##
-    # Fetch single value given tag and MD5 digested key.
-    ##
+sub read_from_loc {
     my $self = shift;
-    my ($obj, $tag, $md5) = @_;
-    my $keys = $tag->{content};
+    my ($obj, $subloc) = @_;
 
     my $fh = $obj->_fh;
 
     ##
-    # Iterate through buckets, looking for a key match
+    # Found match -- seek to offset and read signature
     ##
-    BUCKET:
-    for (my $i = 0; $i < $self->{max_buckets}; $i++) {
-        my ($key, $subloc) = $self->_get_key_subloc( $keys, $i );
+    my $signature;
+    seek($fh, $subloc + $obj->_root->{file_offset}, SEEK_SET);
+    read( $fh, $signature, SIG_SIZE);
+
+    ##
+    # If value is a hash or array, return new DBM::Deep object with correct offset
+    ##
+    if (($signature eq SIG_HASH) || ($signature eq SIG_ARRAY)) {
+        my $obj = DBM::Deep->new(
+            type => $signature,
+            base_offset => $subloc,
+            root => $obj->_root,
+        );
 
-        if (!$subloc) {
+        if ($obj->_root->{autobless}) {
             ##
-            # Hit end of list, no match
+            # Skip over value and plain key to see if object needs
+            # to be re-blessed
             ##
-            return;
-        }
-
-        if ( $md5 ne $key ) {
-            next BUCKET;
-        }
-
-        ##
-        # Found match -- seek to offset and read signature
-        ##
-        my $signature;
-        seek($fh, $subloc + $obj->_root->{file_offset}, SEEK_SET);
-        read( $fh, $signature, DBM::Deep->SIG_SIZE);
+            seek($fh, $self->{data_size} + $self->{index_size}, SEEK_CUR);
 
-        ##
-        # If value is a hash or array, return new DBM::Deep object with correct offset
-        ##
-        if (($signature eq DBM::Deep->TYPE_HASH) || ($signature eq DBM::Deep->TYPE_ARRAY)) {
-            my $obj = DBM::Deep->new(
-                type => $signature,
-                base_offset => $subloc,
-                root => $obj->_root,
-            );
+            my $size;
+            read( $fh, $size, $self->{data_size}); $size = unpack($self->{data_pack}, $size);
+            if ($size) { seek($fh, $size, SEEK_CUR); }
 
-            if ($obj->_root->{autobless}) {
+            my $bless_bit;
+            read( $fh, $bless_bit, 1);
+            if (ord($bless_bit)) {
                 ##
-                # Skip over value and plain key to see if object needs
-                # to be re-blessed
+                # Yes, object needs to be re-blessed
                 ##
-                seek($fh, $self->{data_size} + $self->{index_size}, SEEK_CUR);
-
-                my $size;
+                my $class_name;
                 read( $fh, $size, $self->{data_size}); $size = unpack($self->{data_pack}, $size);
-                if ($size) { seek($fh, $size, SEEK_CUR); }
-
-                my $bless_bit;
-                read( $fh, $bless_bit, 1);
-                if (ord($bless_bit)) {
-                    ##
-                    # Yes, object needs to be re-blessed
-                    ##
-                    my $class_name;
-                    read( $fh, $size, $self->{data_size}); $size = unpack($self->{data_pack}, $size);
-                    if ($size) { read( $fh, $class_name, $size); }
-                    if ($class_name) { $obj = bless( $obj, $class_name ); }
-                }
+                if ($size) { read( $fh, $class_name, $size); }
+                if ($class_name) { $obj = bless( $obj, $class_name ); }
             }
-
-            return $obj;
         }
 
-        ##
-        # Otherwise return actual value
-        ##
-        elsif ($signature eq DBM::Deep->SIG_DATA) {
-            my $size;
-            read( $fh, $size, $self->{data_size});
-            $size = unpack($self->{data_pack}, $size);
+        return $obj;
+    }
+    elsif ( $signature eq SIG_INTERNAL ) {
+        my $size;
+        read( $fh, $size, $self->{data_size});
+        $size = unpack($self->{data_pack}, $size);
+
+        if ( $size ) {
+            my $new_loc;
+            read( $fh, $new_loc, $size );
+            $new_loc = unpack( $self->{long_pack}, $new_loc );
 
-            my $value = '';
-            if ($size) { read( $fh, $value, $size); }
-            return $value;
+            return $self->read_from_loc( $obj, $new_loc );
         }
+        else {
+            return;
+        }
+    }
+    ##
+    # Otherwise return actual value
+    ##
+    elsif ($signature eq SIG_DATA) {
+        my $size;
+        read( $fh, $size, $self->{data_size});
+        $size = unpack($self->{data_pack}, $size);
 
-        ##
-        # Key exists, but content is null
-        ##
-        else { return; }
-    } # i loop
+        my $value = '';
+        if ($size) { read( $fh, $value, $size); }
+        return $value;
+    }
 
+    ##
+    # Key exists, but content is null
+    ##
     return;
 }
 
-sub delete_bucket {
+sub get_bucket_value {
     ##
-    # Delete single key/value pair given tag and MD5 digested key.
+    # Fetch single value given tag and MD5 digested key.
     ##
     my $self = shift;
     my ($obj, $tag, $md5) = @_;
-    my $keys = $tag->{content};
 
-    my $fh = $obj->_fh;
+    my ($subloc, $offset) = $self->_find_in_buckets( $tag, $md5 );
+    if ( $subloc ) {
+        return $self->read_from_loc( $obj, $subloc );
+    }
+    return;
+}
 
+sub delete_bucket {
     ##
-    # Iterate through buckets, looking for a key match
+    # Delete single key/value pair given tag and MD5 digested key.
     ##
-    BUCKET:
-    for (my $i=0; $i<$self->{max_buckets}; $i++) {
-        my ($key, $subloc) = $self->_get_key_subloc( $keys, $i );
-
-        if (!$subloc) {
-            ##
-            # Hit end of list, no match
-            ##
-            return;
-        }
-
-        if ( $md5 ne $key ) {
-            next BUCKET;
-        }
+    my $self = shift;
+    my ($obj, $tag, $md5) = @_;
 
-        ##
-        # Matched key -- delete bucket and return
-        ##
-        seek($fh, $tag->{offset} + ($i * $self->{bucket_size}) + $obj->_root->{file_offset}, SEEK_SET);
-        print( $fh substr($keys, ($i+1) * $self->{bucket_size} ) );
+    my ($subloc, $offset) = $self->_find_in_buckets( $tag, $md5 );
+    if ( $subloc ) {
+        my $fh = $obj->_fh;
+        seek($fh, $tag->{offset} + $offset + $obj->_root->{file_offset}, SEEK_SET);
+        print( $fh substr($tag->{content}, $offset + $self->{bucket_size} ) );
         print( $fh chr(0) x $self->{bucket_size} );
 
         return 1;
-    } # i loop
-
+    }
     return;
 }
 
@@ -671,33 +655,9 @@ sub bucket_exists {
     ##
     my $self = shift;
     my ($obj, $tag, $md5) = @_;
-    my $keys = $tag->{content};
-
-    ##
-    # Iterate through buckets, looking for a key match
-    ##
-    BUCKET:
-    for (my $i=0; $i<$self->{max_buckets}; $i++) {
-        my ($key, $subloc) = $self->_get_key_subloc( $keys, $i );
-
-        if (!$subloc) {
-            ##
-            # Hit end of list, no match
-            ##
-            return;
-        }
 
-        if ( $md5 ne $key ) {
-            next BUCKET;
-        }
-
-        ##
-        # Matched key -- return true
-        ##
-        return 1;
-    } # i loop
-
-    return;
+    my ($subloc, $offset) = $self->_find_in_buckets( $tag, $md5 );
+    return $subloc && 1;
 }
 
 sub find_bucket_list {
@@ -712,36 +672,32 @@ sub find_bucket_list {
     # Locate offset for bucket list using digest index system
     ##
     my $tag = $self->load_tag($obj, $obj->_base_offset)
-        or $self->_throw_error( "INTERNAL ERROR - Cannot find tag" );
-#print $obj->_base_offset, " : $tag->{signature} : $tag->{offset} : $tag->{size}\n";
+        or $obj->_throw_error( "INTERNAL ERROR - Cannot find tag" );
 
     my $ch = 0;
-    while ($tag->{signature} ne DBM::Deep->SIG_BLIST) {
+    while ($tag->{signature} ne SIG_BLIST) {
         my $num = ord substr($md5, $ch, 1);
 
         my $ref_loc = $tag->{offset} + ($num * $self->{long_size});
         $tag = $self->index_lookup( $obj, $tag, $num );
 
         if (!$tag) {
-            if ( $args->{create} ) {
-                my $fh = $obj->_fh;
-                seek($fh, $ref_loc + $obj->_root->{file_offset}, SEEK_SET);
-                print( $fh pack($self->{long_pack}, $obj->_root->{end}) );
-
-                $tag = $self->create_tag(
-                    $obj, $obj->_root->{end},
-                    DBM::Deep->SIG_BLIST,
-                    chr(0) x $self->{bucket_list_size},
-                );
+            return if ! $args->{create};
 
-                $tag->{ref_loc} = $ref_loc;
-                $tag->{ch} = $ch;
+            my $fh = $obj->_fh;
+            seek($fh, $ref_loc + $obj->_root->{file_offset}, SEEK_SET);
+            print( $fh pack($self->{long_pack}, $obj->_root->{end}) );
 
-                last;
-            }
-            else {
-                return;
-            }
+            $tag = $self->create_tag(
+                $obj, $obj->_root->{end},
+                SIG_BLIST,
+                chr(0) x $self->{bucket_list_size},
+            );
+
+            $tag->{ref_loc} = $ref_loc;
+            $tag->{ch} = $ch;
+
+            last;
         }
 
         $tag->{ch} = $ch;
@@ -785,14 +741,14 @@ sub traverse_index {
 
     my $fh = $obj->_fh;
 
-    if ($tag->{signature} ne DBM::Deep->SIG_BLIST) {
+    if ($tag->{signature} ne SIG_BLIST) {
         my $content = $tag->{content};
         my $start = $obj->{return_next} ? 0 : ord(substr($obj->{prev_md5}, $ch, 1));
 
-        for (my $index = $start; $index < 256; $index++) {
+        for (my $idx = $start; $idx < (2**8); $idx++) {
             my $subloc = unpack(
                 $self->{long_pack},
-                substr($content, $index * $self->{long_size}, $self->{long_size}),
+                substr($content, $idx * $self->{long_size}, $self->{long_size}),
             );
 
             if ($subloc) {
@@ -814,40 +770,33 @@ sub traverse_index {
         ##
         # Iterate through buckets, looking for a key match
         ##
-        for (my $i=0; $i<$self->{max_buckets}; $i++) {
+        for (my $i = 0; $i < $self->{max_buckets}; $i++) {
             my ($key, $subloc) = $self->_get_key_subloc( $keys, $i );
 
+            # End of bucket list -- return to outer loop
             if (!$subloc) {
-                ##
-                # End of bucket list -- return to outer loop
-                ##
                 $obj->{return_next} = 1;
                 last;
             }
+            # Located previous key -- return next one found
             elsif ($key eq $obj->{prev_md5}) {
-                ##
-                # Located previous key -- return next one found
-                ##
                 $obj->{return_next} = 1;
                 next;
             }
+            # Seek to bucket location and skip over signature
             elsif ($obj->{return_next}) {
-                ##
-                # Seek to bucket location and skip over signature
-                ##
-                seek($fh, $subloc + DBM::Deep->SIG_SIZE + $obj->_root->{file_offset}, SEEK_SET);
+                seek($fh, $subloc + $obj->_root->{file_offset}, SEEK_SET);
 
-                ##
                 # Skip over value to get to plain key
-                ##
+                my $sig;
+                read( $fh, $sig, SIG_SIZE );
+
                 my $size;
                 read( $fh, $size, $self->{data_size});
                 $size = unpack($self->{data_pack}, $size);
                 if ($size) { seek($fh, $size, SEEK_CUR); }
 
-                ##
                 # Read in plain key and return as scalar
-                ##
                 my $plain_key;
                 read( $fh, $size, $self->{data_size});
                 $size = unpack($self->{data_pack}, $size);
@@ -855,7 +804,7 @@ sub traverse_index {
 
                 return $plain_key;
             }
-        } # bucket loop
+        }
 
         $obj->{return_next} = 1;
     } # tag is a bucket list
@@ -903,5 +852,47 @@ sub _get_key_subloc {
     return ($key, $subloc);
 }
 
+sub _find_in_buckets {
+    my $self = shift;
+    my ($tag, $md5) = @_;
+
+    BUCKET:
+    for ( my $i = 0; $i < $self->{max_buckets}; $i++ ) {
+        my ($key, $subloc) = $self->_get_key_subloc( $tag->{content}, $i );
+
+        return ($subloc, $i * $self->{bucket_size}) unless $subloc;
+
+        next BUCKET if $key ne $md5;
+
+        return ($subloc, $i * $self->{bucket_size});
+    }
+
+    return;
+}
+
 1;
 __END__
+
+# This will be added in later, after more refactoring is done. This is an early
+# attempt at refactoring on the physical level instead of the virtual level.
+sub _read_at {
+    my $self = shift;
+    my ($obj, $spot, $amount, $unpack) = @_;
+
+    my $fh = $obj->_fh;
+    seek( $fh, $spot + $obj->_root->{file_offset}, SEEK_SET );
+
+    my $buffer;
+    my $bytes_read = read( $fh, $buffer, $amount );
+
+    if ( $unpack ) {
+        $buffer = unpack( $unpack, $buffer );
+    }
+
+    if ( wantarray ) {
+        return ($buffer, $bytes_read);
+    }
+    else {
+        return $buffer;
+    }
+}