Storage/Handler/Abstract.pm

##    --------------------------------------------------------------------------------
##    $Id: Abstract.pm,v 1.9 2002/12/19 16:30:23 joko Exp $
##    --------------------------------------------------------------------------------
##    $Log: Abstract.pm,v $
##    Revision 1.9  2002/12/19 16:30:23  joko
##    + added 'sub dropDb' and 'sub rebuildDb' as croakers for concrete implementations of methods in proper handlers
##
##    Revision 1.8  2002/12/13 21:48:35  joko
##    + sub _abstract_function
##
##    Revision 1.7  2002/12/05 07:57:48  joko
##    + now using Tie::SecureHash as a base for the COREHANDLE
##    + former public COREHANDLE becomes private _COREHANDLE now
##
##    Revision 1.6  2002/12/03 15:52:24  joko
##    + fix/feature: if dispatching to deep core method fails (is not declared), try method at Data::Storage - level
##
##    Revision 1.5  2002/12/01 22:19:33  joko
##    + just disconnect if COREHANDLE exists
##
##    Revision 1.4  2002/12/01 04:45:38  joko
##    + sub eraseAll
##    + sub createDb
##
##    Revision 1.3  2002/11/29 04:58:20  joko
##    + Storage::Result now uses the same dispatching mechanism like Storage::Handler
##
##    Revision 1.2  2002/10/17 00:08:07  joko
##    + bugfixes regarding "deep recursion" stuff
##
##    Revision 1.1  2002/10/10 03:44:07  cvsjoko
##    + new
##    --------------------------------------------------------------------------------


package Data::Storage::Handler::Abstract;

use strict;
use warnings;

use base qw( DesignPattern::Object );

use Data::Dumper;
use Tie::SecureHash;
#use Data::Storage::Handler;

# get logger instance
my $logger = Log::Dispatch::Config->instance;

#our $lock_info;

sub new {
  my $invocant = shift;
  my $class = ref($invocant) || $invocant;
  
  # logging info about the actual handler called
    $logger->debug( "$invocant->new( @_ )" );
    #$logger->debug( __PACKAGE__ . "->" . "new()" );

  # V1 - arguments become properties automagically / normal perl mode blessing
=pod
  # autovivify passed-in arguments as future object attributes into to-be-blessed hash
  my $self = { @_ };
  # create object from blessed hash-reference
  bless $self, $class;
=cut

#=pod
  # V2 - maybe more convenient/secure? utilizing Damian Conway's Tie::SecureHash...
  my $self = Tie::SecureHash->new(
    $class,
    # that's it:
      'metainfo' => undef,
      'lock_info' => undef,
      '_COREHANDLE' => undef,
      'meta' => undef,
      'locator' => undef,
      'dataStorageLayer' => undef,
      'dbi' => undef,
    # tries:
      #'Data::Storage::Handler::Abstract::metainfo' => undef,
      #'dataStorageLayer'
      #'Data::Storage::Handler::Abstract::dataStorageLayer' => undef,
      #'Data::Storage::Handler::Tangram::dataStorageLayer' => undef,
      #'Data::Dumper::locator' => undef,
      #$class . '::locator' => undef,
      #'Data::Storage::Handler::Tangram::locator' => undef,
      #'Data::Storage::Handler::DBI::locator' => undef,
      #_protected => ,
      #__private => ,
  );
#=cut

  # merge passed-in arguments to constructor as properties into already blessed secure object
    
    # mungle arguments from array into hash - perl does the job  ;)
    my %args = @_;
  
    # merge attributes one-by-one
    # TODO: deep_copy? / merge_deep?
    foreach (keys %args) {
      #print "key: $_", "\n";
      $self->{$_} = $args{$_};
    }
  
  # V3 - rolling our own security (just for {COREHANDLE} - nothing else)  -  nope, Tie::SecureHash works wonderful
  #my $self = { @_ };
  #bless $self, $class;
  
  
  # handle meta data
    #my $metainfo = $self->getMetaInfo($class);
    my $metainfo = $self->getMetaInfo();
    if (!$metainfo->{disconnectMethod}) { $metainfo->{disconnectMethod} = 'disconnect'; }
    # type?
    $invocant =~ s/Data::Storage::Handler:://;
    $metainfo->{type} = $invocant;

    # direct accessible (non-protected) properties         ( was: my $self = { }; )
    $self->{metainfo} = $metainfo;

  return $self;
}


# TODO: use NEXT.pm inside this mechanism (to avoid repetitions...)
sub AUTOLOAD {

  # recursion problem to be avoided here!!!
  
    # - problem: we get recursion-hangs!!!   =>  perl stops with ...
    # "Deep recursion on subroutine "Data::Storage::Handler::Abstract::AUTOLOAD" at [...]/libs/Data/Storage.pm line 38."
    
    # - when: if we log to ourselves as a storage-implementation (e.g. via Log::Dispatch::Tangram)
    # - why:  debug-messages are on a very low level including every data-operation to "Data::Storage(::Handler::X)",
    #             so e.g. a "$storage->insert" would trigger another "$storage->insert" itself 
    #             which leads to a infinite recursion loop (deep recursion)
    # - solution: locks! (by Hack or (maybe) via Perl "local"s)

  my $self = shift;

  our $AUTOLOAD;
  #return if $AUTOLOAD =~ m/::DESTROY$/;

  # find out methodname
  my $methodname = $AUTOLOAD;
  $methodname =~ s/^.*:://;
  
#print "method: $methodname", "\n";
  
  # TODO: document this! handler-private methods listed here will not be triggered (internal use)
  # in this case, "exists" is a method reserved for Tie::SecureHash,
  # which encapsulates the perl data structure (HASH) under this object
  # this is to prevent deep recursion's
  return if lc $methodname eq 'exists';

#print "$methodname - 1", "\n";

  # TODO: enhance logging/debugging
  #if (!$self->exists('COREHANDLE')) { return; }

  # handle locking (hack)
  if ($self->can('exists') && $self->exists('lock_info') && $self->{lock_info}->{last_method} && $methodname eq $self->{lock_info}->{last_method}) {
    $self->{lock_info}->{log_lock} = 1;
  } else {
    $self->{lock_info}->{log_lock} = 0;
  }
  $self->{lock_info}->{last_method} = $methodname;
  
#print "$methodname - 2", "\n";

#print Dumper($self);
#exit;

  # get corehandle instance from underlying handler
  my $core = $self->getCOREHANDLE();

  # test for COREHANDLE
  #if (!$self->{_COREHANDLE}) {
#=pod
  #if (!$self->exists('_COREHANDLE')) {
  #if (!$self->{_COREHANDLE}) {
  if (!$core) {

#print Dumper($self);    
#exit;

    my $handlertype = $self->{metainfo}->{type};
    $handlertype ||= '';

    my $err_msg_core = __PACKAGE__ . "[$handlertype]" . ": " . "COREHANDLE is undefined while trying to execute method \"$methodname\"";
print $err_msg_core, "\n";
    if ($self->exists('lock_info') && !$self->{lock_info}->{log_lock}) {
      $logger->error( $err_msg_core );
    }
    return;
  }
#=cut

#print "$methodname - 3", "\n";

  # try to dispatch method-call to Storage::Handler::*
  #if ($self->can($methodname)) {
    #$logger->debug( __PACKAGE__ . "[$self->{metainfo}->{type}]" . "->" . $methodname . "(@_)" );
    #my $res = $self->$methodname(@_);
    #if ($res) { return $res; }
  #}

#print "$methodname - 4", "\n";

  # try to dispatch method-call to COREHANDLE
  # was:
  #my $core = $self->{_COREHANDLE};
  # is:
  #my $core = $self->getCOREHANDLE();

#print Dumper($core);
#exit;

  # was:
  #if ($self->{_COREHANDLE}->can($methodname) || $self->{_COREHANDLE}->can("AUTOLOAD")) {
  # is:
  if ($core->can($methodname) || $core->can("AUTOLOAD")) {
    #$logger->debug( __PACKAGE__ . "->" . $methodname . " (AUTOLOAD)" );
    #$lock_AUTOLOAD = 1 if ($methodname eq 'insert');
    if (!$self->{lock_info}->{log_lock}) {
      #print "method: $methodname", "\n";
      $logger->debug( __PACKAGE__ . "[$self->{metainfo}->{type}]" . "->" . $methodname . "(@_)" );
    } else {
      # AUTOLOAD - sub is locked to prevent deep recursions if (e.g.) db-inserts cause log-actions to same db itself
    }
    #$lock_AUTOLOAD = 0;
    #$logger->log( level => 'debug', message => __PACKAGE__ . "->" . $methodname . " (AUTOLOAD)" );
    
#print "calling: $methodname", "\n";
    
    # method calls making it until here will get dispatched to the proper handler
    return $core->$methodname(@_);
  
  } elsif ($self->can($methodname)) {
    # try to call specified method inside our or inherited module(s) scope(s)
    return $self->$methodname(@_);
  }

}

sub DESTROY {
  my $self = shift;
  #if ($self->{COREHANDLE}) {
  if ($self->exists('_COREHANDLE')) {
    $logger->debug( __PACKAGE__ . "[$self->{metainfo}->{type}]" . "->DESTROY" );

    my $disconnectMethod = $self->{metainfo}->{disconnectMethod};

    # call "disconnect" or alike on COREHANDLE
    # was: $self->{COREHANDLE}->disconnect();
    $disconnectMethod && $self->{_COREHANDLE} && ( $self->{_COREHANDLE}->$disconnectMethod() );

    undef $self->{_COREHANDLE};
  }
}

sub _typeCheck2 {
  my $type = shift;
  print "type: $type";
  eval("use Data::Storage::$type;");
}


# ====================================================
#   PUBLIC METHODS
# ====================================================

  sub existsChildNode {
    my $self = shift;
    my $nodename = shift;
    #$nodename = 'TransactionRoutingTable';
    $logger->debug( __PACKAGE__ . "->existsChildNode( nodename $nodename )" );
    $self->getChildNodes() unless $self->{meta}->{childnodes};
    my $result = grep(m/$nodename/i, @{$self->{meta}->{childnodes}});     # TODO: use "/i" only on win32-systems!
    return $result;
  }

  sub connect_tmp {
    
#    my $self = shift;
#    my $connectionString = shift;
#    # todo: patch connectionString to $args
#    _typeCheck($self->{args}{type});

  }
  

# ====================================================
#   CONCRETE METHOD DUMMIES (croaking via "$logger" by calling "_abstract_function")
# ====================================================

  # TODO:
  #   - abstract "abstract methods" to list/hash to be used in AUTOLOAD
  #      e.g.: my @ABSTRACT_METHODS = (qw( connect sendCommand getChildNodes ));
  #      use Class::XYZ (Construct)
  #   - build them via anonymous subs 
  #   - introduce them via symbols

  sub getCOREHANDLE {
    my $self = shift;
    $self->_abstract_function('getCOREHANDLE');
  }

  sub sendCommand {
    my $self = shift;
    $self->_abstract_function('sendCommand');
  }

  sub existsChildNode_tmp {
    my $self = shift;
    $self->_abstract_function('existsChildNode');
  }

  sub getChildNodes {
    my $self = shift;
    $self->_abstract_function('getChildNodes');
  }

  sub configureCOREHANDLE {
    my $self = shift;
    $self->_abstract_function('configureCOREHANDLE');
  }

  sub getMetaInfo {
    my $self = shift;
    $self->_abstract_function('getMetaInfo');
    return;
  }

  sub getListUnfiltered {
    my $self = shift;
    $self->_abstract_function('getListUnfiltered');
    return;
  }

  sub getListFiltered {
    my $self = shift;
    $self->_abstract_function('getListFiltered');
    return;
  }

  sub sendQuery {
    my $self = shift;
    $self->_abstract_function('sendQuery');
    return;
  }

  sub connect {
    my $self = shift;
    $self->_abstract_function('connect');
    return;
  }

  sub testIntegrity {
    my $self = shift;
    $self->_abstract_function('testIntegrity');
    return;
  }

  sub quoteSql {
    my $self = shift;
    $self->_abstract_function('quoteSql');
    return;
  }

  sub eraseAll {
    my $self = shift;
    $self->_abstract_function('eraseAll');
    return;
  }

  sub createDb {
    my $self = shift;
    $self->_abstract_function('createDb');
    return;
  }

  sub dropDb {
    my $self = shift;
    $self->_abstract_function('dropDb');
    return;
  }

  sub rebuildDb {
    my $self = shift;
    $self->_abstract_function('rebuildDb');
    return;
  }

1;
1	joko	1.7	## --------------------------------------------------------------------------------
2	joko	1.10	## $Id: Abstract.pm,v 1.9 2002/12/19 16:30:23 joko Exp $
3	joko	1.7	## --------------------------------------------------------------------------------
4			## $Log: Abstract.pm,v $
5	joko	1.10	## Revision 1.9 2002/12/19 16:30:23 joko
6			## + added 'sub dropDb' and 'sub rebuildDb' as croakers for concrete implementations of methods in proper handlers
7			##
8	joko	1.9	## Revision 1.8 2002/12/13 21:48:35 joko
9			## + sub _abstract_function
10			##
11	joko	1.8	## Revision 1.7 2002/12/05 07:57:48 joko
12			## + now using Tie::SecureHash as a base for the COREHANDLE
13			## + former public COREHANDLE becomes private _COREHANDLE now
14			##
15	joko	1.7	## Revision 1.6 2002/12/03 15:52:24 joko
16			## + fix/feature: if dispatching to deep core method fails (is not declared), try method at Data::Storage - level
17			##
18			## Revision 1.5 2002/12/01 22:19:33 joko
19			## + just disconnect if COREHANDLE exists
20			##
21			## Revision 1.4 2002/12/01 04:45:38 joko
22			## + sub eraseAll
23			## + sub createDb
24			##
25			## Revision 1.3 2002/11/29 04:58:20 joko
26			## + Storage::Result now uses the same dispatching mechanism like Storage::Handler
27			##
28			## Revision 1.2 2002/10/17 00:08:07 joko
29			## + bugfixes regarding "deep recursion" stuff
30			##
31			## Revision 1.1 2002/10/10 03:44:07 cvsjoko
32			## + new
33			## --------------------------------------------------------------------------------
34
35	cvsjoko	1.1
36			package Data::Storage::Handler::Abstract;
37
38			use strict;
39			use warnings;
40
41	joko	1.8	use base qw( DesignPattern::Object );
42
43	cvsjoko	1.1	use Data::Dumper;
44	joko	1.7	use Tie::SecureHash;
45			#use Data::Storage::Handler;
46	cvsjoko	1.1
47			# get logger instance
48			my $logger = Log::Dispatch::Config->instance;
49
50			#our $lock_info;
51
52			sub new {
53			my $invocant = shift;
54			my $class = ref($invocant) \|\| $invocant;
55
56			# logging info about the actual handler called
57			$logger->debug( "$invocant->new( @_ )" );
58	joko	1.2	#$logger->debug( __PACKAGE__ . "->" . "new()" );
59	cvsjoko	1.1
60	joko	1.7	# V1 - arguments become properties automagically / normal perl mode blessing
61			=pod
62			# autovivify passed-in arguments as future object attributes into to-be-blessed hash
63	joko	1.3	my $self = { @_ };
64			# create object from blessed hash-reference
65			bless $self, $class;
66	joko	1.7	=cut
67
68	joko	1.10	#=pod
69	joko	1.7	# V2 - maybe more convenient/secure? utilizing Damian Conway's Tie::SecureHash...
70			my $self = Tie::SecureHash->new(
71			$class,
72			# that's it:
73			'metainfo' => undef,
74			'lock_info' => undef,
75			'_COREHANDLE' => undef,
76			'meta' => undef,
77			'locator' => undef,
78			'dataStorageLayer' => undef,
79			'dbi' => undef,
80			# tries:
81			#'Data::Storage::Handler::Abstract::metainfo' => undef,
82			#'dataStorageLayer'
83			#'Data::Storage::Handler::Abstract::dataStorageLayer' => undef,
84			#'Data::Storage::Handler::Tangram::dataStorageLayer' => undef,
85			#'Data::Dumper::locator' => undef,
86			#$class . '::locator' => undef,
87			#'Data::Storage::Handler::Tangram::locator' => undef,
88			#'Data::Storage::Handler::DBI::locator' => undef,
89			#_protected => ,
90			#__private => ,
91			);
92	joko	1.10	#=cut
93	joko	1.7
94			# merge passed-in arguments to constructor as properties into already blessed secure object
95
96			# mungle arguments from array into hash - perl does the job ;)
97			my %args = @_;
98
99			# merge attributes one-by-one
100			# TODO: deep_copy? / merge_deep?
101			foreach (keys %args) {
102			#print "key: $_", "\n";
103			$self->{$_} = $args{$_};
104			}
105
106			# V3 - rolling our own security (just for {COREHANDLE} - nothing else) - nope, Tie::SecureHash works wonderful
107			#my $self = { @_ };
108			#bless $self, $class;
109
110
111	joko	1.3
112	cvsjoko	1.1	# handle meta data
113	joko	1.3	#my $metainfo = $self->getMetaInfo($class);
114			my $metainfo = $self->getMetaInfo();
115	cvsjoko	1.1	if (!$metainfo->{disconnectMethod}) { $metainfo->{disconnectMethod} = 'disconnect'; }
116			# type?
117			$invocant =~ s/Data::Storage::Handler:://;
118			$metainfo->{type} = $invocant;
119
120			# direct accessible (non-protected) properties ( was: my $self = { }; )
121	joko	1.3	$self->{metainfo} = $metainfo;
122	cvsjoko	1.1
123			return $self;
124			}
125
126
127	joko	1.10	# TODO: use NEXT.pm inside this mechanism (to avoid repetitions...)
128	cvsjoko	1.1	sub AUTOLOAD {
129
130			# recursion problem to be avoided here!!!
131
132			# - problem: we get recursion-hangs!!! => perl stops with ...
133			# "Deep recursion on subroutine "Data::Storage::Handler::Abstract::AUTOLOAD" at [...]/libs/Data/Storage.pm line 38."
134
135			# - when: if we log to ourselves as a storage-implementation (e.g. via Log::Dispatch::Tangram)
136			# - why: debug-messages are on a very low level including every data-operation to "Data::Storage(::Handler::X)",
137			# so e.g. a "$storage->insert" would trigger another "$storage->insert" itself
138			# which leads to a infinite recursion loop (deep recursion)
139	joko	1.2	# - solution: locks! (by Hack or (maybe) via Perl "local"s)
140	cvsjoko	1.1
141			my $self = shift;
142
143			our $AUTOLOAD;
144			#return if $AUTOLOAD =~ m/::DESTROY$/;
145
146			# find out methodname
147			my $methodname = $AUTOLOAD;
148			$methodname =~ s/^.*:://;
149	joko	1.7
150			#print "method: $methodname", "\n";
151
152			# TODO: document this! handler-private methods listed here will not be triggered (internal use)
153			# in this case, "exists" is a method reserved for Tie::SecureHash,
154			# which encapsulates the perl data structure (HASH) under this object
155			# this is to prevent deep recursion's
156			return if lc $methodname eq 'exists';
157
158			#print "$methodname - 1", "\n";
159
160			# TODO: enhance logging/debugging
161			#if (!$self->exists('COREHANDLE')) { return; }
162	cvsjoko	1.1
163			# handle locking (hack)
164	joko	1.10	if ($self->can('exists') && $self->exists('lock_info') && $self->{lock_info}->{last_method} && $methodname eq $self->{lock_info}->{last_method}) {
165	cvsjoko	1.1	$self->{lock_info}->{log_lock} = 1;
166			} else {
167			$self->{lock_info}->{log_lock} = 0;
168			}
169			$self->{lock_info}->{last_method} = $methodname;
170
171	joko	1.7	#print "$methodname - 2", "\n";
172
173			#print Dumper($self);
174			#exit;
175
176			# get corehandle instance from underlying handler
177			my $core = $self->getCOREHANDLE();
178
179	cvsjoko	1.1	# test for COREHANDLE
180	joko	1.7	#if (!$self->{_COREHANDLE}) {
181			#=pod
182			#if (!$self->exists('_COREHANDLE')) {
183			#if (!$self->{_COREHANDLE}) {
184			if (!$core) {
185	joko	1.10
186			#print Dumper($self);
187			#exit;
188
189			my $handlertype = $self->{metainfo}->{type};
190			$handlertype \|\|= '';
191
192			my $err_msg_core = __PACKAGE__ . "[$handlertype]" . ": " . "COREHANDLE is undefined while trying to execute method \"$methodname\"";
193	joko	1.7	print $err_msg_core, "\n";
194			if ($self->exists('lock_info') && !$self->{lock_info}->{log_lock}) {
195			$logger->error( $err_msg_core );
196	joko	1.2	}
197	cvsjoko	1.1	return;
198			}
199	joko	1.7	#=cut
200
201			#print "$methodname - 3", "\n";
202	cvsjoko	1.1
203			# try to dispatch method-call to Storage::Handler::*
204			#if ($self->can($methodname)) {
205			#$logger->debug( __PACKAGE__ . "[$self->{metainfo}->{type}]" . "->" . $methodname . "(@_)" );
206			#my $res = $self->$methodname(@_);
207			#if ($res) { return $res; }
208			#}
209
210	joko	1.7	#print "$methodname - 4", "\n";
211
212	cvsjoko	1.1	# try to dispatch method-call to COREHANDLE
213	joko	1.7	# was:
214			#my $core = $self->{_COREHANDLE};
215			# is:
216			#my $core = $self->getCOREHANDLE();
217
218			#print Dumper($core);
219			#exit;
220
221			# was:
222			#if ($self->{_COREHANDLE}->can($methodname) \|\| $self->{_COREHANDLE}->can("AUTOLOAD")) {
223			# is:
224			if ($core->can($methodname) \|\| $core->can("AUTOLOAD")) {
225	cvsjoko	1.1	#$logger->debug( __PACKAGE__ . "->" . $methodname . " (AUTOLOAD)" );
226			#$lock_AUTOLOAD = 1 if ($methodname eq 'insert');
227			if (!$self->{lock_info}->{log_lock}) {
228			#print "method: $methodname", "\n";
229			$logger->debug( __PACKAGE__ . "[$self->{metainfo}->{type}]" . "->" . $methodname . "(@_)" );
230			} else {
231			# AUTOLOAD - sub is locked to prevent deep recursions if (e.g.) db-inserts cause log-actions to same db itself
232			}
233			#$lock_AUTOLOAD = 0;
234			#$logger->log( level => 'debug', message => __PACKAGE__ . "->" . $methodname . " (AUTOLOAD)" );
235	joko	1.3
236	joko	1.7	#print "calling: $methodname", "\n";
237
238	joko	1.10	# method calls making it until here will get dispatched to the proper handler
239	joko	1.7	return $core->$methodname(@_);
240	joko	1.6
241			} elsif ($self->can($methodname)) {
242	joko	1.10	# try to call specified method inside our or inherited module(s) scope(s)
243	joko	1.6	return $self->$methodname(@_);
244	cvsjoko	1.1	}
245
246			}
247
248			sub DESTROY {
249			my $self = shift;
250	joko	1.7	#if ($self->{COREHANDLE}) {
251			if ($self->exists('_COREHANDLE')) {
252	cvsjoko	1.1	$logger->debug( __PACKAGE__ . "[$self->{metainfo}->{type}]" . "->DESTROY" );
253
254			my $disconnectMethod = $self->{metainfo}->{disconnectMethod};
255
256			# call "disconnect" or alike on COREHANDLE
257			# was: $self->{COREHANDLE}->disconnect();
258	joko	1.7	$disconnectMethod && $self->{_COREHANDLE} && ( $self->{_COREHANDLE}->$disconnectMethod() );
259	cvsjoko	1.1
260	joko	1.7	undef $self->{_COREHANDLE};
261	cvsjoko	1.1	}
262			}
263
264	joko	1.7	sub _typeCheck2 {
265	cvsjoko	1.1	my $type = shift;
266			print "type: $type";
267			eval("use Data::Storage::$type;");
268			}
269
270
271			# ====================================================
272			# PUBLIC METHODS
273			# ====================================================
274
275	joko	1.3	sub existsChildNode {
276			my $self = shift;
277			my $nodename = shift;
278			#$nodename = 'TransactionRoutingTable';
279	joko	1.10	$logger->debug( __PACKAGE__ . "->existsChildNode( nodename $nodename )" );
280	joko	1.3	$self->getChildNodes() unless $self->{meta}->{childnodes};
281			my $result = grep(m/$nodename/i, @{$self->{meta}->{childnodes}}); # TODO: use "/i" only on win32-systems!
282			return $result;
283			}
284	cvsjoko	1.1
285	joko	1.3	sub connect_tmp {
286	cvsjoko	1.1
287			# my $self = shift;
288			# my $connectionString = shift;
289			# # todo: patch connectionString to $args
290			# _typeCheck($self->{args}{type});
291
292			}
293
294	joko	1.3
295			# ====================================================
296			# CONCRETE METHOD DUMMIES (croaking via "$logger" by calling "_abstract_function")
297			# ====================================================
298
299			# TODO:
300			# - abstract "abstract methods" to list/hash to be used in AUTOLOAD
301			# e.g.: my @ABSTRACT_METHODS = (qw( connect sendCommand getChildNodes ));
302	joko	1.4	# use Class::XYZ (Construct)
303	joko	1.3	# - build them via anonymous subs
304			# - introduce them via symbols
305
306	joko	1.7	sub getCOREHANDLE {
307			my $self = shift;
308			$self->_abstract_function('getCOREHANDLE');
309			}
310
311	cvsjoko	1.1	sub sendCommand {
312			my $self = shift;
313			$self->_abstract_function('sendCommand');
314	joko	1.7	}
315
316			sub existsChildNode_tmp {
317			my $self = shift;
318			$self->_abstract_function('existsChildNode');
319	cvsjoko	1.1	}
320
321			sub getChildNodes {
322			my $self = shift;
323			$self->_abstract_function('getChildNodes');
324			}
325
326			sub configureCOREHANDLE {
327			my $self = shift;
328			$self->_abstract_function('configureCOREHANDLE');
329			}
330
331	joko	1.3	sub getMetaInfo {
332			my $self = shift;
333			$self->_abstract_function('getMetaInfo');
334			return;
335			}
336
337			sub getListUnfiltered {
338			my $self = shift;
339			$self->_abstract_function('getListUnfiltered');
340			return;
341			}
342
343			sub getListFiltered {
344			my $self = shift;
345			$self->_abstract_function('getListFiltered');
346			return;
347			}
348
349			sub sendQuery {
350			my $self = shift;
351			$self->_abstract_function('sendQuery');
352			return;
353			}
354
355			sub connect {
356			my $self = shift;
357			$self->_abstract_function('connect');
358			return;
359			}
360
361			sub testIntegrity {
362			my $self = shift;
363			$self->_abstract_function('testIntegrity');
364			return;
365			}
366
367			sub quoteSql {
368			my $self = shift;
369			$self->_abstract_function('quoteSql');
370	joko	1.4	return;
371			}
372
373			sub eraseAll {
374			my $self = shift;
375			$self->_abstract_function('eraseAll');
376			return;
377			}
378
379			sub createDb {
380			my $self = shift;
381			$self->_abstract_function('createDb');
382	joko	1.9	return;
383			}
384
385			sub dropDb {
386			my $self = shift;
387			$self->_abstract_function('dropDb');
388			return;
389			}
390
391			sub rebuildDb {
392			my $self = shift;
393			$self->_abstract_function('rebuildDb');
394	joko	1.3	return;
395			}
396
397			1;
MailToCvsAdmin">MailToCvsAdmin	ViewVC Help
Powered by ViewVC 1.1.26