source: main/trunk/greenstone2/perllib/DBDrivers/JDBM.pm@ 31188

Last change on this file since 31188 was 31188, checked in by ak19, 4 years ago

This commit is related to but not specific to the upcoming commit to do with the new oaiinfo db and its directly affected files. This commit: New remove and rename (move) methods in DB package to clean up main db file and any additional db files created by any specific infodbtype. The new methods in dbutil/jdbm.pm are not called, for some reason. Requires more investigation, but committing for now.

File size: 3.8 KB
Line 
1###############################################################################
2#
3# DBDrivers/JDBM.pm -- utility functions for writing to jdbm 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
26package DBDrivers::JDBM;
27
28# Pragma
29use strict;
30
31# Libraries
32use util;
33use FileUtils;
34use DBDrivers::70HyphenFormat;
35
36sub BEGIN
37{
38 if (!defined $ENV{'GSDLHOME'} || !defined $ENV{'GSDLOS'}) {
39 die("Error! Environment must be prepared by sourcing setup.bash\n");
40 }
41 @DBDrivers::JDBM::ISA = ('DBDrivers::70HyphenFormat');
42}
43
44
45## @function constructor
46#
47sub new
48{
49 my $class = shift(@_);
50 my $self = DBDrivers::70HyphenFormat->new(@_);
51 $self->{'default_file_extension'} = 'jdb';
52 $self->{'supports_concurrent_read_and_write'} = 1;
53
54 # Executables need a little extra work since we are using Java
55 # - we need to build up the classpath continue the Jar libraries to use
56 my $jdbmwrap_jar = &FileUtils::filenameConcatenate($ENV{'GSDLHOME'}, 'bin', 'java', 'JDBMWrapper.jar');
57 my $jdbm_jar = &FileUtils::filenameConcatenate($ENV{'GSDLHOME'}, 'lib', 'java', 'jdbm.jar');
58 my $classpath = &util::pathname_cat($jdbmwrap_jar,$jdbm_jar);
59 # Massage paths for Cygwin. Away to run a java program, using a binary that
60 # is native to Windows, so need Windows directory and path separators
61 # Note: this is done after the util::pathname_cat as that fuction can also
62 # (incorrectly) change file separators.
63 if ($^O eq "cygwin") {
64 $classpath = `cygpath -wp "$classpath"`;
65 chomp($classpath);
66 $classpath =~ s%\\%\\\\%g;
67 }
68 $self->{'executable_path'} = '';
69 $self->{'read_executable'} = 'java -cp "' . $classpath . '" Jdb2Txt';
70 $self->{'keyread_executable'} = 'java -cp "' . $classpath . '" JdbKeys';
71 $self->{'write_executable'} = 'java -cp "' . $classpath . '" Txt2Jdb';
72 # Support
73 $self->{'supports_set'} = 1;
74
75 bless($self, $class);
76 return $self;
77}
78## constructor() ##
79
80
81# -----------------------------------------------------------------------------
82# JDBM IMPLEMENTATION
83# -----------------------------------------------------------------------------
84
85# When DBUtil::* is properly structured with inheritance, then
86# much of this code (along with GDBM and GDBM-TXT-GZ) can be grouped into
87# a shared base class. Really it is only the the command that needs to
88# be constructed that changes between much of the code that is used
89
90# Handled by BaseDBDriver
91# sub get_infodb_file_path {}
92
93# Handled by 70HyphenFormat
94# sub open_infodb_write_handle(string, string?) => filehandle
95# sub close_infodb_write_handle(filehandle) => void
96# sub read_infodb_file(string, hashmap) => void
97# sub read_infodb_keys(string, hashmap) => void
98# sub write_infodb_entry(filehandle, string, hashmap) => void
99# sub write_infodb_rawentry(filehandle, string, string) => void
100# sub set_infodb_entry(filehandle, string, string) => void
101# sub delete_infodb_entry(filehandle, string) => void
102
1031;
Note: See TracBrowser for help on using the repository browser.