1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
package TM::ResourceAble::MLDBM;
use TM;
use base qw (TM);
use Class::Trait qw(TM::ResourceAble);
use Data::Dumper;
use BerkeleyDB ;
use MLDBM qw(BerkeleyDB::Hash Storable) ;
#use MLDBM qw(BerkeleyDB::Hash Data::Dumper) ;
#use MLDBM qw(BerkeleyDB::Hash Data::Dumper) ;
use Fcntl;
=pod
=head1 NAME
TM::ResourceAble::MLDBM - Topic Maps, DBM Storage (synchronous)
=head1 SYNOPSIS
use TM::ResourceAble::MLDBM;
{
my $tm = new TM::ResourceAble::MLDBM (file => '/tmp/map.dbm');
# modify the map here.....
} # it goes out of scope here, and all changes are written back automagically
# later in the game
{
my $tm = new TM::ResourceAble::MLDBM (file => '/tmp/map.dbm');
# we are back in business, no sync necessary
}
=head1 DESCRIPTION
This package just implements L<TM> with a BerkeleyDB store. Unlike L<TM::Materialized::MLDBM> this
module does not need explicit synchronisation with the external resource (the DBM file here). It
ties content-wise with the DBM file at constructor time and unties at DESTROY time.
The advantage of this storage form is that there is little memory usage. Only those fractions of the
map are loaded which are actually needed. If one has very intense interactions with the map (as a
query processor has), then this storage technique is not optimal.
=head1 INTERFACE
=head2 Constructor
The constructor expects a hash with the following keys:
=over
=item B<file> (no default)
This contains the file name of the DBM file to tie to.
=back
=cut
sub new {
my $class = shift;
my %options = @_;
my $file = delete $options{file} or die $TM::log->logdie ("no file specified");
my $whatever = $class->SUPER::new (%options, url => 'file:'.$file); # this ensures that we have a proper url component
my %self; # forget about the object itself, make a new one
#warn "file exists $file?";
if (-e $file) { # file does exist already
tie %self, 'MLDBM', -Filename => $file
or $TM::log->logdie ( "Cannot create DBM file '$file: $!");
# oh, we are done now
} else { # no file yet
#warn "file not exists $file!";
tie %self, 'MLDBM', -Filename => $file, # bind to one
-Flags => DB_CREATE # which we create here
or $TM::log->logdie ( "Cannot create DBM file '$file: $!");
foreach (keys %$whatever) { # clone all components
$self{$_} = $whatever->{$_}; # this makes sure that Berkeley'ed tie picks it up
}
}
return bless \%self, $class; # give the reference a blessing
}
sub DESTROY { # if an object went out of scope
my $self = shift;
untie %$self; # release the tie with the underlying resource
}
=pod
=head1 SEE ALSO
L<TM>, L<TM::Materialized::MLDBM>
=head1 AUTHOR INFORMATION
Copyright 200[68], Robert Barta <drrho@cpan.org>, All rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl
itself. http://www.perl.com/perl/misc/Artistic.html
=cut
our $VERSION = '0.02';
our $REVISION = '$Id: MLDBM2.pm,v 1.3 2006/11/13 08:02:34 rho Exp $';
1;
__END__
|
