1 | ###############################################################################
|
---|
2 | #
|
---|
3 | # GDBM.pm -- utility functions for writing to gdbm databases
|
---|
4 | #
|
---|
5 | # A component of the Greenstone digital library software from the New Zealand
|
---|
6 | # Digital Library Project at the University of Waikato, New Zealand.
|
---|
7 | #
|
---|
8 | # Copyright (C) 1999-2015 New Zealand Digital Library Project
|
---|
9 | #
|
---|
10 | # This program is free software; you can redistribute it and/or modify it under
|
---|
11 | # the terms of the GNU General Public License as published by the Free Software
|
---|
12 | # Foundation; either version 2 of the License, or (at your option) any later
|
---|
13 | # version.
|
---|
14 | #
|
---|
15 | # This program is distributed in the hope that it will be useful, but WITHOUT
|
---|
16 | # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
---|
17 | # FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
---|
18 | # more details.
|
---|
19 | #
|
---|
20 | # You should have received a copy of the GNU General Public License along with
|
---|
21 | # this program; if not, write to the Free Software Foundation, Inc., 675 Mass
|
---|
22 | # Ave, Cambridge, MA 02139, USA.
|
---|
23 | #
|
---|
24 | ###############################################################################
|
---|
25 |
|
---|
26 | package DBDrivers::GDBM;
|
---|
27 |
|
---|
28 | # Pragma
|
---|
29 | use strict;
|
---|
30 |
|
---|
31 | # Libraries
|
---|
32 | use util;
|
---|
33 | use FileUtils;
|
---|
34 | use parent 'DBDrivers::70HyphenFormat';
|
---|
35 |
|
---|
36 |
|
---|
37 | ## @function constructor
|
---|
38 | #
|
---|
39 | sub new
|
---|
40 | {
|
---|
41 | my $class = shift(@_);
|
---|
42 | my $self = DBDrivers::70HyphenFormat->new(@_);
|
---|
43 | $self->{'default_file_extension'} = 'gdb';
|
---|
44 | # note: file separator agnostic
|
---|
45 | $self->{'executable_path'} = $ENV{'GSDLHOME'} . '/bin/' . $ENV{'GSDLOS'};
|
---|
46 | $self->{'read_executable'} = 'db2txt';
|
---|
47 | $self->{'keyread_executable'} = 'gdbmkeys';
|
---|
48 | $self->{'write_executable'} = 'txt2db';
|
---|
49 | bless($self, $class);
|
---|
50 | return $self;
|
---|
51 | }
|
---|
52 | ## new(void) => GDBM ##
|
---|
53 |
|
---|
54 |
|
---|
55 | # -----------------------------------------------------------------------------
|
---|
56 | # GDBM IMPLEMENTATION
|
---|
57 | # -----------------------------------------------------------------------------
|
---|
58 |
|
---|
59 | # Handled by BaseDBDriver
|
---|
60 | # sub get_infodb_file_path(string, string)
|
---|
61 |
|
---|
62 | # Handled by 70HyphenFormat
|
---|
63 | # sub close_infodb_write_handle(filehandle) => void
|
---|
64 | # sub delete_infodb_entry(filehandle, string) => void
|
---|
65 | # sub read_infodb_entry(string, string) => hashmap
|
---|
66 | # sub read_infodb_file(string, hashmap) => void
|
---|
67 | # sub read_infodb_keys(string, hashmap) => void
|
---|
68 | # sub read_infodb_rawentry(string, string) => string
|
---|
69 | # sub set_infodb_entry(string, string, hashmap) => integer
|
---|
70 | # sub write_infodb_entry(filehandle, string, hashmap) => void
|
---|
71 | # sub write_infodb_rawentry(filehandle, string, string) => void
|
---|
72 |
|
---|
73 |
|
---|
74 | ## @function open_infodb_write_handle(string, string*) => filehandle
|
---|
75 | #
|
---|
76 | # Handles legacy use of optional 'append' argument where '-append' is required
|
---|
77 | #
|
---|
78 | sub open_infodb_write_handle
|
---|
79 | {
|
---|
80 | my $self = shift(@_);
|
---|
81 | my $infodb_file_path = shift(@_);
|
---|
82 | my $opt_append = shift(@_);
|
---|
83 | my $infodb_file_handle;
|
---|
84 | if (defined $opt_append) {
|
---|
85 | if ($opt_append eq 'append') {
|
---|
86 | $opt_append = '-append';
|
---|
87 | }
|
---|
88 | $infodb_file_handle = $self->SUPER::open_infodb_write_handle($infodb_file_path, $opt_append);
|
---|
89 | }
|
---|
90 | else
|
---|
91 | {
|
---|
92 | $infodb_file_handle = $self->SUPER::open_infodb_write_handle($infodb_file_path);
|
---|
93 | }
|
---|
94 | return $infodb_file_handle;
|
---|
95 | }
|
---|
96 | ## open_infodb_write_handle(string, string*) => filehandle ##
|
---|
97 |
|
---|
98 |
|
---|
99 | 1;
|
---|