blib/lib/AmberDB/Base/Cache.pm untested

filter: Statementstmt 0.0% 0 / 107 Branchbran 0.0% 0 / 44 Conditioncond 0.0% 0 / 68 MC/DCmcdc 0.0% 0 / 44 Subroutinesub 0.0% 0 / 13 Podpod 0.0% 0 / 10 totaltotal 0.0% 0 / 286 CC 23 SCAR 32.8
CC
23
Cov
0%
set_cache
56.0
get_cache
42.0
clear_cache
30.0
CRAP 26.5
1 package AmberDB::Base::Cache;
2  
3 use 5.016;
4 use warnings;
5 use Carp qw(croak cluck);
6  
7 our $VERSION = '5.26.6';
8 my $CREATED = '2026-08-11';
9  
10 # ============================================================================
11 # AmberDB In-Memory (L1 Process) Object Cache & Staging Buffer Engine
12 # ============================================================================
13  
14 # ----------------------------------------------------------------------------
15 # In-Memory L1 Object Cache ($self->{_cache})
16 # ----------------------------------------------------------------------------
17  
18 # my $val = $adb->get_cache( $group, $key );
19 # my %grp = $adb->get_cache( $group );
20 # ------------------------------------------------
21 sub get_cache {
22 my ( $self, $group, $key ) = @_;
23 return unless defined $group && length $group;
24 return unless $self->{_cache} && ref( $self->{_cache} ) eq 'HASH';
25  
26 my $val = defined $key ? $self->{_cache}{$group}{$key} : $self->{_cache}{$group};
27 return unless defined $val;
28  
29 if ( wantarray && ref($val) eq 'ARRAY' ) {
30 return @$val;
31 }
32 return $val;
33 }
34  
35 # $adb->set_cache( $group, $key, @vals );
36 # $adb->set_cache( $group, $key ); # deletes key
37 # $adb->set_cache( $group ); # deletes entire group
38 # $adb->set_cache(); # resets all cache
39 # ------------------------------------------------
40 sub set_cache {
41 my ( $self, $group, $key, @vals ) = @_;
42  
43 # Reset all cache if called without arguments
44 if ( !defined $group || $group eq '' ) {
45 %{ $self->{_cache} } = () if $self->{_cache};
46 return 1;
47 }
48  
49 # If key is omitted, delete entire group / table
50 if ( !defined $key || $key eq '' ) {
51 delete $self->{_cache}{$group};
52 return 1;
53 }
54  
55 # If vals omitted, delete key
56 if ( !@vals || !defined $vals[0] ) {
57 delete $self->{_cache}{$group}{$key};
58 if ( $key eq 'keys' || $key =~ /^keys_/ ) {
59 delete $self->{_cache}{$group}{keys};
60 delete $self->{_cache}{$group}{keys_desc};
61 delete $self->{_cache}{$group}{keys_asc};
62 }
63 return 1;
64 }
65  
66 my $store_val = ( @vals > 1 ) ? \@vals : $vals[0];
67 return $self->{_cache}{$group}{$key} = $store_val;
68 }
69  
70 # $adb->clear_cache( [$group], [$key] );
71 # ------------------------------------------------
72 sub clear_cache {
73 my ( $self, $group, $key ) = @_;
74  
75 if ( !defined $group || $group eq '' ) {
76 %{ $self->{_cache} } = () if $self->{_cache};
77 return 1;
78 }
79  
80 if ( !defined $key || $key eq '' ) {
81 delete $self->{_cache}{$group};
82 return 1;
83 }
84  
85 delete $self->{_cache}{$group}{$key};
86 if ( $key eq 'keys' || $key =~ /^keys_/ ) {
87 delete $self->{_cache}{$group}{keys};
88 delete $self->{_cache}{$group}{keys_desc};
89 delete $self->{_cache}{$group}{keys_asc};
90 }
91 return 1;
92 }
93  
94 # Backward compatibility aliases for in-memory caching
95 sub cache_read {
96 my $self = shift;
97 return $self->get_cache(@_);
98 }
99  
100 sub cache_write {
101 my $self = shift;
102 return $self->set_cache(@_);
103 }
104  
105 sub cache_delete {
106 my $self = shift;
107 return $self->clear_cache(@_);
108 }
109  
110 # ============================================================================
111 # Persistent Disk Buffer Staging Operations ($dbase_dir/buffer/)
112 # ============================================================================
113  
114 sub buffer_slot {
115 my ( $self, $tableid ) = @_;
116  
117 my $dbase = do { ( $tableid =~ /^([a-z0-9]+)_/ )[0] };
118 my $dbase_info = $self->dbase_info($dbase);
119  
120 my $buffer_dir = $self->path('buffer_dir')
121 || ( ( $self->path('dbase_dir') || "." ) . "/buffer" );
122  
123 my $prefix = '';
124 if (
125 $self->config('use_section')
126 and ( ( $dbase_info && $dbase_info->{section} )
127 or ( $self->table_info($tableid) && $self->table_info($tableid)->{section} ) )
128 ) {
129 $prefix = ( $self->config('section') // "center" ) . "-";
130 }
131 my $buffer_file = "${prefix}${tableid}.tmp";
132  
133 return ( $buffer_dir, $buffer_file );
134 }
135  
136 sub buffer_read {
137 my ( $self, $tableid ) = @_;
138  
139 my ( $buffer_dir, $buffer_file ) = $self->buffer_slot($tableid);
140 return unless $buffer_dir && -d $buffer_dir;
141 return unless -e "$buffer_dir/$buffer_file";
142  
143 my @lines;
144 open my $TMP, "<", "$buffer_dir/$buffer_file"
145 or do { cluck "[DB_BUFFER] $buffer_dir/$buffer_file can't open: $!\n"; return; };
146  
147 while ( my $line = <$TMP> ) {
148 my @fields = $self->db_decode($line);
149 push @lines, \@fields;
150 }
151 close $TMP;
152  
153 return @lines;
154 }
155  
156 sub buffer_write {
157 my ( $self, $tableid, @records ) = @_;
158  
159 $tableid or return;
160 @records or return;
161  
162 my ( $buffer_dir, $buffer_file ) = $self->buffer_slot($tableid);
163 return unless $buffer_dir && -d $buffer_dir;
164  
165 my $target_path = "$buffer_dir/$buffer_file";
166 my $tmp_path = "${target_path}.tmp.$$";
167  
168 open my $TMP, ">", $tmp_path
169 or do { cluck "[DB_BUFFER] $tmp_path can't open: $!\n"; return; };
170  
171 foreach my $fields (@records) {
172 $fields = [$fields] unless ref($fields) eq "ARRAY";
173 my $encoded = $self->db_encode( @{$fields} );
174 print $TMP "$encoded\n";
175 }
176 close $TMP;
177  
178 rename( $tmp_path, $target_path );
179 return 1;
180 }
181  
182 sub buffer_delete {
183 my ( $self, $tableid ) = @_;
184  
185 my ( $buffer_dir, $buffer_file ) = $self->buffer_slot($tableid);
186 return unless $buffer_dir && -d $buffer_dir;
187  
188 unlink("$buffer_dir/$buffer_file") if -e "$buffer_dir/$buffer_file";
189 return 1;
190 }
191  
192 1;
193  
194 __END__