Storage/Handler/Tangram.pm

############################################
#
#  $Id: Tangram.pm,v 1.22 2002/12/18 22:28:16 jonen Exp $
#
#  $Log: Tangram.pm,v $
#  Revision 1.22  2002/12/18 22:28:16  jonen
#  + added extended logging at 'getObjectByGuid()'
#
#  Revision 1.21  2002/12/16 22:20:49  jonen
#  + fixed bug at 'getObjectByGuid()'
#
#  Revision 1.20  2002/12/16 20:49:17  jonen
#  + added sub 'getObjectByGuid()'
#  + added functionality to use 'getObjectByGuid' at 'getObjectAsHash()'
#
#  Revision 1.19  2002/12/16 06:46:09  joko
#  + attempt to introduce a generic '_patchSchema' - cancelled!
#
#  Revision 1.18  2002/12/13 21:48:07  joko
#  + fix to 'sub sendQuery'
#
#  Revision 1.17  2002/12/12 02:51:09  joko
#  + cosmetics
#
#  Revision 1.16  2002/12/11 06:54:10  joko
#  + fix: encapsulated object-loading inside an 'eval'
#
#  Revision 1.15  2002/12/05 13:55:21  joko
#  + now utilizing 'object2hash' instead of 'var_deref'
#  + played around with having fresh-objects - no progress....
#
#  Revision 1.14  2002/12/05 09:40:30  jonen
#  + added option->{destroy} at getObject for unloading all instance
#
#  Revision 1.13  2002/12/05 07:59:04  joko
#  + now using Tie::SecureHash as a base for the COREHANDLE
#  + former public COREHANDLE becomes private _COREHANDLE now
#  + sub getCOREHANDLE
#
#  Revision 1.12  2002/12/04 11:34:49  joko
#  - $schema_tangram doesn't have to be in class?
#
#  Revision 1.11  2002/12/04 08:54:08  jonen
#  + untested bugfix: undef($object) after transform to hash at getObjectAsHash
#
#  Revision 1.10  2002/12/03 15:53:23  joko
#  + small bugfix regarding object hierarchy
#
#  Revision 1.9  2002/12/03 05:29:40  joko
#  + sub getObject
#  + sub getObjectAsHash
#
#  Revision 1.8  2002/12/01 22:25:51  joko
#  + now utilizing metadata from storage locator when connecting to DBI in "raw"-mode
#
#  Revision 1.7  2002/12/01 04:46:19  joko
#  + sub eraseAll
#
#  Revision 1.6  2002/11/29 05:02:30  joko
#  - sub getNewPerlObjectByPkgName (moved to libp.pm)
#  + sub getMetaInfo
#  - sub existsChildNode (moved to Abstract.pm)
#  + sub getListUnfiltered
#  + sub getListFiltered
#  + sub createCursor
#  + sub createSet
#  + sub sendQuery
#
#  Revision 1.5  2002/11/17 06:35:18  joko
#  + locator metadata can now be reached via ->{locator}
#  - getChildNodes is now wrapped via COREHANDLE
#
#  Revision 1.4  2002/10/25 11:44:44  joko
#  + sub _initSchema
#  + sub existsChildNode
#  + sub testIntegrity
#  + sub rebuildDbAndSchema
#
#  Revision 1.3  2002/10/17 03:56:55  joko
#  + bugfix: trapped eval error
#
#  Revision 1.2  2002/10/17 00:10:05  joko
#  + removed dependency from tsobj.pm, schema is now independent
#  + sub getNewPerlObjectByPkgName
#  + sub deploySchema
#  + sub retreatSchema
#
#  Revision 1.1  2002/10/10 03:44:07  cvsjoko
#  + new
#
############################################


package Data::Storage::Handler::Tangram;

use strict;
use warnings;

use base ("Data::Storage::Handler");
use base ("Data::Storage::Handler::Abstract");

use Tangram;
use Data::Dumper;
use libp qw( getNewPerlObjectByPkgName );
use Data::Storage::Result::Tangram;
use Data::Compare::Struct qw( isEmpty );
use Data::Transform::Deep qw( object2hash );
use Data::Transform::Encode qw( var2utf8 );


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


# this holds the complete instantiated schema from tangram
my $schema_tangram;

sub getMetaInfo {
  my $self = shift;
  $logger->debug( __PACKAGE__ . "->getMetaInfo()"  );
  return {
    'disconnectMethod' => 'disconnect',
  };
}

sub _initSchema {
  my $self = shift;
  $logger->debug( __PACKAGE__ . "->_initSchema()" );
  #if (!$schema_tangram) {
    my $obj = getNewPerlObjectByPkgName($self->{locator}->{schema}, { EXPORT_OBJECTS => $self->{locator}->{classnames}, want_transactions => $self->{locator}->{want_transactions} } );
    $schema_tangram = $obj->getSchema();
  #}
  if (!$schema_tangram) {
    $logger->error( __PACKAGE__ . "->_initSchema: No Schema available for $self->{schema}" );
    return 0;
  }
  #$self->_patchSchema();
  return 1;
}

sub _patchSchema {
  my $self = shift;
  foreach (keys %{$schema_tangram->{classes}}) {
    next if $schema_tangram->{classes}->{$_}->{abstract};
    #next if ($_ ne 'TsBankAccount');
    #$_ ne 'AbstractAccount' && 
    print "class: $_", "\n";
#print Dumper($schema_tangram->{classes}->{$_});
    # create new string property named 'guid'
    my $tstring = Tangram::String->new();
    $tstring->{name} = $tstring->{col} = 'guid';
    # inject property into schema
    #$schema_tangram->{classes}->{$_}->{root}->{SPECS}->[0]->{fields}->{string}->{$tstring->{name}} = $tstring;
    print Dumper($schema_tangram->{classes}->{$_}->{root}->{SPECS}->[0]->{fields});
  }
}

sub connect {

    my $self = shift;
    
    my $dsn = shift;
    $dsn ||= $self->{locator}->{dbi}->{dsn};
    
    $logger->debug( __PACKAGE__ . "->connect( dsn $dsn )" );
    
    #my $storage = Tangram::Relational->connect( $schema, $dsn );
    #my $storage = Tangram::mysql->connect( $schema, $dsn );
    #$storage = Tangram::Relational->connect( Project->schema, $dsn );
    
#    if (!testDsn($dsn)) {
#      croak("Database at \"$dsn\" is not available");
#      return;
#    }

    return unless $self->_initSchema();

    # create the main tangram storage object
    #$self->{COREHANDLE} = Tangram::Relational->connect( $schema, $dsn );
    $self->{_COREHANDLE} = Tangram::Relational->connect( $schema_tangram, $dsn );

#print "connect", "\n";
#my $core = $self->{_COREHANDLE};
#print Dumper($core);
  
    # some attempts for configuring the wrapped underlying dbi.....
    #$self->{STORAGEHANDLE_UNDERLYING} = $self->getUnderlyingStorage();
    #$self->{STORAGEHANDLE_UNDERLYING}->_configureCOREHANDLE();
    #$self->_configureUnderlyingStorage;
    
    # ..... encapsulation wins!
    $self->configureCOREHANDLE();

  $self->{locator}->{status}->{connected} = 1;

  return 1;

}

sub getChildNodes {

  my $self = shift;
  my @nodes;

  $logger->debug( __PACKAGE__ . "->getChildNodes()" );

  # create new DBI - Data::Storage - object from already connected DBI::db - handle inside the current COREHANDLE
  #my $loc = new Data::Storage::Locator( type => "DBI", dbi => { db => $self->{COREHANDLE}->{db} });
  #my $loc = new Data::Storage::Locator( type => "DBI", COREHANDLE => $self->{COREHANDLE}->{db} );
  
  # todo: should we retrieve information from the schema here
  # rather than poorly getting table names from underlying dbi?
  my $storage = $self->_getSubLayerHandle();
  @nodes = @{$storage->getChildNodes()};
  #$storage->_configureCOREHANDLE();
#print "getchildnodes\n";
#print Dumper($self);
  #if (my $result = $self->sendCommand( 'SHOW TABLES;' ) ) {
  
  # TODO: REVIEW
  #$storage->disconnect();
  
  $self->{meta}->{childnodes} = \@nodes;
  
  return \@nodes;

}


sub testIntegrity {

  my $self = shift;

  $logger->debug( __PACKAGE__ . "->testIntegrity()" );

  # 1st test: are there tables?
  if (!$self->getChildNodes()) {
    $logger->warning( __PACKAGE__ . "->testIntegrity no childnodes exist" );
    return;
  }

  # 2nd test: is there a table named "Tangram"?
  if (!$self->existsChildNode("Tangram")) {
    $logger->warning( __PACKAGE__ . "->testIntegrity childnode \"Tangram\" doesn't exist" );
    return;
  }

  $self->{locator}->{status}->{integrity} = 1;
  return 1;

}


sub _getSubLayerHandle {
  
  my $self = shift;
  
  $logger->debug( __PACKAGE__ . "->_getSubLayerHandle()" );

  #print Dumper($self);

  # hack, make more generic!
  if (!$self->{dataStorageLayer}) {
    $logger->debug( __PACKAGE__ . "->_getSubLayerHandle() creating new dataStorageLayer" );
    #my $loc = Data::Storage::Locator->new( type => "DBI", dbi => $self->{dbi}, COREHANDLE => $self->{COREHANDLE}->{db} );
    my $loc = Data::Storage::Locator->new( { type => "DBI", dbi => $self->{locator}->{dbi} } );
    $self->{dataStorageLayer} = Data::Storage->new( $loc, { protected => 1 } );
    #$self->{STORAGE_UNDER_THE_HOOD}->{STORAGEHANDLE}->_configureCOREHANDLE();
    #$self->{STORAGE_UNDER_THE_HOOD}->_configureCOREHANDLE();
  }
  
  #print Dumper($self->{STORAGE_UNDER_THE_HOOD});
  
  return $self->{dataStorageLayer};
  
}

sub _configureUnderlyingStorage {
  
  my $self = shift;

  $logger->debug( __PACKAGE__ . "->_configureUnderlyingStorage" );

  $self->_configureCOREHANDLE_DBI();
  return;
  
  foreach my $key (keys %{$self->{dbi}}) {
    my $val = $self->{dbi}->{$key};
    print "entry: $key; $val", "\n";
    $self->{_COREHANDLE}->{db}->{$key} = $val;
  }
  #print Dumper($self->{COREHANDLE}->{db});
}


sub configureCOREHANDLE {

  my $self = shift;

  $logger->debug( __PACKAGE__ . "->configureCOREHANDLE" );

  #my $subLayer = $self->_getSubLayerHandle();

  # apply configured modifications
    if (exists $self->{dbi}->{trace_level} && exists $self->{dbi}->{trace_file}) {
      $self->{_COREHANDLE}->{db}->trace($self->{dbi}->{trace_level}, $self->{dbi}->{trace_file});
    }
    if (exists $self->{dbi}->{RaiseError}) {
      $self->{_COREHANDLE}->{db}->{RaiseError} = $self->{dbi}->{RaiseError};
    }
    if (exists $self->{dbi}->{PrintError}) {
      $self->{_COREHANDLE}->{db}->{PrintError} = $self->{dbi}->{PrintError};
    }
    if (exists $self->{dbi}->{HandleError}) {
      $self->{_COREHANDLE}->{db}->{HandleError} = $self->{dbi}->{HandleError};
    }

}

sub deploySchema {
  my $self = shift;
  my $args = shift;
  
  my $dsn = $self->{locator}->{dbi}->{dsn};

  $logger->debug( __PACKAGE__ . "->deploySchema( dsn $dsn )" );

  my $ok;
  if ( my $dbh = DBI->connect($dsn, '', '', $self->{locator}->{dbi} ) ) {
    return unless $self->_initSchema();
    $ok = Tangram::Relational->deploy($schema_tangram, $dbh );
    $dbh->disconnect();
  }
  return $ok;
}

sub retreatSchema {

  my $self = shift;
  my $dsn = $self->{locator}->{dbi}->{dsn};

  $logger->debug( __PACKAGE__ . "->retreatSchema( dsn $dsn )" );

  my $ok;
  if ( my $dbh = DBI->connect($dsn, '', '', $self->{locator}->{dbi} ) ) {

    return unless $self->_initSchema();
    
    #use Data::Dumper; print Dumper($self);
    $self->{dataStorageLayer}->removeLogDispatchHandler("Tangram11");
    
    $ok = Tangram::Relational->retreat($schema_tangram, $dbh );

    # answer "$ok=2" means "maybe" for now - we have to patch this to a constant here because...
    # - ... Tangram::Relational->retreat doesn't seem to return a valid status
    # - possible improvement:
    #   - test this by checking for count of tables in database
    #   - problem with this: there may be some left not having been included to the schema
    #   - maybe better: use "->getChildNodes"?
    $ok = 2;

    $dbh->disconnect();

  }
  return $ok;
}

sub rebuildDb {
  my $self = shift;
  $logger->info( __PACKAGE__ . "->rebuildDb()" );
  my @results;

  # sum up results (bool (0/1)) in array
  push @results, $self->retreatSchema();
  push @results, $self->{dataStorageLayer}->dropDb();
  push @results, $self->{dataStorageLayer}->createDb();
  push @results, $self->deploySchema();

  # scan array for "bad ones"
  my $res = 1;
  map {
    $res = 0 if (!$_);
  } @results;
  
  return $res;
}

sub getListUnfiltered {
  my $self = shift;
  my $nodename = shift;
  my @results;
  $logger->debug( __PACKAGE__ . "->getListUnfiltered( nodename => '" . $nodename . "' )" );
  # get set of objects from odbms by object name
  my $object_set = $self->{_COREHANDLE}->remote($nodename);
  @results = $self->{_COREHANDLE}->select($object_set);
  return \@results;
}

sub getListFiltered {
  my $self = shift;

  # redirect to unfiltered mode
  #return $self->getListUnfiltered(@_);

  my $nodename = shift;
  my $filters = shift;
  my @results;
  $logger->debug( __PACKAGE__ . "->getListFiltered( nodename => '" . $nodename . "' )" );

  #print Dumper($filters);
  
  my @tfilters;
  
  foreach my $filter (@$filters) {
  
    # get filter - TODO: for each filter
    #my $filter = $filters->[0];
  
    # build filter
    my $lexpr = $filter->{key};
    #my $op = $filter->{op};
    my $op = '=';
    my $rexpr = $filter->{val};
    my $tight = 100;
    
  #  my $tfilter = Tangram::Filter->new(
  #    expr => "t1.$lexpr $op '$rexpr'",
  #    tight => $tight,
  #    objects => $objects,
  #  );
  
    # HACK: build eval-string (sorry) to get filtered list - please give advice here
    push @tfilters, '$remote->{' . $filter->{key} . '}' . " $filter->{op} '$filter->{val}'";

  }

  my $tfilter = join(' & ', @tfilters);

  # get set of objects from odbms by object name
  my $remote = $self->{_COREHANDLE}->remote($nodename);
  
  # was:
  #@results = $self->{COREHANDLE}->select($object_set, $tfilter);

  # is:
  # HACK: build eval-string (sorry) to get filtered list - please give advice here
  my $evalstring = 'return $self->{_COREHANDLE}->select($remote, ' . $tfilter . ');';
  
  # get filtered list/set
  @results = eval($evalstring);
  die $@ if $@;
  
  return \@results;
}

sub createCursor {
  my $self = shift;
  my $node = shift;
  my $cmdHandle = $self->{_COREHANDLE}->cursor($node);
  my $result = Data::Storage::Result::Tangram->new( RESULTHANDLE => $cmdHandle );
  return $result;
}

sub createSet {
  my $self = shift;
#print "-" x 80, "\n";
#print Dumper(@_);
  my @objects = @_;
  my $rh = Set::Object->new();
  foreach (@objects) {
    if (!isEmpty($_)) {
#print Dumper($_);
      $rh->insert($_);
    }
  }
  #print Dumper($rh->members());
  my $result = Data::Storage::Result::Tangram->new( RESULTHANDLE => $rh );
  return $result;
}

sub sendQuery {
  my $self = shift;
  my $query = shift;
  #my $sql = "SELECT cs FROM $self->{metainfo}->{$descent}->{node} WHERE $self->{metainfo}->{$descent}->{IdentProvider}->{arg}='$self->{entry}->{source}->{ident}';";
  #my $result = $self->{metainfo}->{$descent}->{storage}->sendCommand($sql);

  #print Dumper($query);

  # HACK: special case: querying by id does not translate into a common tangram query
  # just load the object by given id(ent)
  if ($query->{criterias}->[0]->{key} eq 'id' && $query->{criterias}->[0]->{op} eq 'eq') {
    #print "LOAD!!!", "\n";
    #exit;
    #return Set::Object->new( $self->{COREHANDLE}->load($query->{criterias}->[0]->{val}) );
    my $ident = $query->{criterias}->[0]->{val};
#print "load obj", "\n";
    #return $self->createSet() if $ident == 5;
    $self->{_COREHANDLE}->unload($ident);
    my $object = $self->{_COREHANDLE}->load($ident);
#print "get id", "\n";
    my $oid = $self->{_COREHANDLE}->id($object);
#print Dumper($object);
#print "oid: $oid", "\n";
    return $self->createSet($object);
    #return $self->createSet( $self->{COREHANDLE}->load('300090018') );
  }

  die("This should not be reached for now - redirect to \$self->getListFiltered() here!");

  # TODO: do a common tangram query here

  my @crits;
  foreach (@{$query->{criterias}}) {
    my $op = '';
    $op = '=' if lc $_->{op} eq 'eq';
    push @crits, "$_->{key}$op'$_->{val}'";
  }
  my $subnodes = {};
  map { $subnodes->{$_}++ } @{$query->{subnodes}};
  # HACK: this is hardcoded ;(    expand possibilities!
  #my $crit = join(' AND ', @crits);
  #my $sql = hash2Sql($query->{node}, $subnodes, 'SELECT', $crit);
  #return $self->sendCommand($sql);
  #my $h = $self->{COREHANDLE}->remote($query->{node});
  #my $res = $self->{COREHANDLE}->select($h, $h->{);
  return $self->createCursor($query->{node});
}

sub eraseAll {
  my $self = shift;
  my $classname = shift;
  my $remote = $self->{_COREHANDLE}->remote($classname);
  my @objs = $self->{_COREHANDLE}->select($remote);
  $self->{_COREHANDLE}->erase(@objs);
}

sub createDb {
  my $self = shift;
  my $storage = $self->_getSubLayerHandle();
  return $storage->createDb();
}

sub getObject {
  my $self = shift;
  my $oid = shift;
  my $options = shift;

  # TODO: create a deep_unload method (currently _all_ objects are unloaded)
  # unload($oid) will only unload object, not deep object hashes
  $self->{_COREHANDLE}->unload() if ($options->{destroy});

  # TODO: review this
  #if (!$self->{COREHANDLE}) { return; }

  # TODO: review this
  my $object = eval('$self->{_COREHANDLE}->load($oid);');
  print $@, "\n" if $@;

  return $object if $object;
}

sub getObjectByGuid {
  my $self = shift;
  my $guid = shift;
  my $options = shift;
  
  # Guid and Classname is needed
  if(!$guid || !$options->{classname}) {
   $logger->error( __PACKAGE__ . "->getObjectByGuid: No 'guid' OR no Classname in options hash was given but needed!" );
    return;
  }
  
  # TODO: create a deep_unload method (currently _all_ objects are unloaded)
  # unload($oid) will only unload object, not deep object hashes
  $self->{_COREHANDLE}->unload() if ($options->{destroy});

  # search for object with given Classname and Guid
  my $obj_tmp = $self->{_COREHANDLE}->remote($options->{classname});
  my @result = $self->{_COREHANDLE}->select($obj_tmp, $obj_tmp->{guid} eq $guid);
  
  # we searched for global unique identifer of some object,
  # so I think we can trust there would be only one result
  if($result[0]) {
    return $result[0];
  } else {
    $logger->error( __PACKAGE__ . "->getObjectByGuid: No Object with Classname $options->{classname} and GUID $guid found!" );
    return;
  }
  
}

sub getObjectAsHash {
  my $self = shift;
  my $oid = shift;
  my $options = shift;  
  my $obj;
  
  if($options->{guid}) {
    $obj = $self->getObjectByGuid($oid, $options);
  } else {
    $obj = $self->getObject($oid, $options);
  }
  
  # build options (a callback to unload autovivified objects) for 'expand'
  # TODO: use $logger to write to debug here!
  my $cb; # = sub {};
=pod
  if ($options->{destroy}) {
    $options->{cb}->{destroy} = sub {
      print "================ DESTROY", "\n";
      my $object = shift;
      #print Dumper($object);
      $self->{_COREHANDLE}->unload($object);
      #undef($object);
    };
  }
=cut

  my $hash = object2hash($obj, $options);
  #$options->{cb}->{destroy}->($obj);
  #$self->{_COREHANDLE}->unload($obj);
  
  # convert values in hash to utf8 to be ready for (e.g.) encapsulation in XML
  # now done in object2hash
  #var2utf8($hash) if ($options->{utf8});
  
  # old (wrong) attempts to get rid of used instances, if requested
    #$obj->clear_refs;
    #$self->{COREHANDLE}->unload($obj) if($options->{destroy});
    #$obj->DESTROY;
    #undef($obj) if($options->{destroy});
  
  return $hash;
}

sub getSchema {
  return $schema_tangram;
}

sub getCOREHANDLE {
  my $self = shift;
  return $self->{_COREHANDLE};
}

1;
1	joko	1.6	############################################
2	cvsjoko	1.1	#
3	joko	1.23	# $Id: Tangram.pm,v 1.22 2002/12/18 22:28:16 jonen Exp $
4	joko	1.2	#
5			# $Log: Tangram.pm,v $
6	joko	1.23	# Revision 1.22 2002/12/18 22:28:16 jonen
7			# + added extended logging at 'getObjectByGuid()'
8			#
9	jonen	1.22	# Revision 1.21 2002/12/16 22:20:49 jonen
10			# + fixed bug at 'getObjectByGuid()'
11			#
12	jonen	1.21	# Revision 1.20 2002/12/16 20:49:17 jonen
13			# + added sub 'getObjectByGuid()'
14			# + added functionality to use 'getObjectByGuid' at 'getObjectAsHash()'
15			#
16	jonen	1.20	# Revision 1.19 2002/12/16 06:46:09 joko
17			# + attempt to introduce a generic '_patchSchema' - cancelled!
18			#
19	joko	1.19	# Revision 1.18 2002/12/13 21:48:07 joko
20			# + fix to 'sub sendQuery'
21			#
22	joko	1.18	# Revision 1.17 2002/12/12 02:51:09 joko
23			# + cosmetics
24			#
25	joko	1.17	# Revision 1.16 2002/12/11 06:54:10 joko
26			# + fix: encapsulated object-loading inside an 'eval'
27			#
28	joko	1.16	# Revision 1.15 2002/12/05 13:55:21 joko
29			# + now utilizing 'object2hash' instead of 'var_deref'
30			# + played around with having fresh-objects - no progress....
31			#
32	joko	1.15	# Revision 1.14 2002/12/05 09:40:30 jonen
33			# + added option->{destroy} at getObject for unloading all instance
34			#
35	jonen	1.14	# Revision 1.13 2002/12/05 07:59:04 joko
36			# + now using Tie::SecureHash as a base for the COREHANDLE
37			# + former public COREHANDLE becomes private _COREHANDLE now
38			# + sub getCOREHANDLE
39			#
40	joko	1.13	# Revision 1.12 2002/12/04 11:34:49 joko
41			# - $schema_tangram doesn't have to be in class?
42			#
43	joko	1.12	# Revision 1.11 2002/12/04 08:54:08 jonen
44			# + untested bugfix: undef($object) after transform to hash at getObjectAsHash
45			#
46	jonen	1.11	# Revision 1.10 2002/12/03 15:53:23 joko
47			# + small bugfix regarding object hierarchy
48			#
49	joko	1.10	# Revision 1.9 2002/12/03 05:29:40 joko
50			# + sub getObject
51			# + sub getObjectAsHash
52			#
53	joko	1.9	# Revision 1.8 2002/12/01 22:25:51 joko
54			# + now utilizing metadata from storage locator when connecting to DBI in "raw"-mode
55			#
56	joko	1.8	# Revision 1.7 2002/12/01 04:46:19 joko
57			# + sub eraseAll
58			#
59	joko	1.7	# Revision 1.6 2002/11/29 05:02:30 joko
60			# - sub getNewPerlObjectByPkgName (moved to libp.pm)
61			# + sub getMetaInfo
62			# - sub existsChildNode (moved to Abstract.pm)
63			# + sub getListUnfiltered
64			# + sub getListFiltered
65			# + sub createCursor
66			# + sub createSet
67			# + sub sendQuery
68			#
69	joko	1.6	# Revision 1.5 2002/11/17 06:35:18 joko
70			# + locator metadata can now be reached via ->{locator}
71			# - getChildNodes is now wrapped via COREHANDLE
72			#
73	joko	1.5	# Revision 1.4 2002/10/25 11:44:44 joko
74			# + sub _initSchema
75			# + sub existsChildNode
76			# + sub testIntegrity
77			# + sub rebuildDbAndSchema
78			#
79	joko	1.4	# Revision 1.3 2002/10/17 03:56:55 joko
80			# + bugfix: trapped eval error
81			#
82	joko	1.3	# Revision 1.2 2002/10/17 00:10:05 joko
83			# + removed dependency from tsobj.pm, schema is now independent
84			# + sub getNewPerlObjectByPkgName
85			# + sub deploySchema
86			# + sub retreatSchema
87			#
88	joko	1.2	# Revision 1.1 2002/10/10 03:44:07 cvsjoko
89			# + new
90	cvsjoko	1.1	#
91	joko	1.6	############################################
92
93	cvsjoko	1.1
94			package Data::Storage::Handler::Tangram;
95
96			use strict;
97			use warnings;
98
99	joko	1.13	use base ("Data::Storage::Handler");
100	cvsjoko	1.1	use base ("Data::Storage::Handler::Abstract");
101
102			use Tangram;
103			use Data::Dumper;
104	joko	1.6	use libp qw( getNewPerlObjectByPkgName );
105			use Data::Storage::Result::Tangram;
106			use Data::Compare::Struct qw( isEmpty );
107	joko	1.15	use Data::Transform::Deep qw( object2hash );
108	joko	1.9	use Data::Transform::Encode qw( var2utf8 );
109
110	cvsjoko	1.1
111			# get logger instance
112			my $logger = Log::Dispatch::Config->instance;
113
114
115	joko	1.12	# this holds the complete instantiated schema from tangram
116			my $schema_tangram;
117
118	joko	1.6	sub getMetaInfo {
119			my $self = shift;
120			$logger->debug( __PACKAGE__ . "->getMetaInfo()" );
121			return {
122			'disconnectMethod' => 'disconnect',
123			};
124	joko	1.2	}
125
126	joko	1.4	sub _initSchema {
127			my $self = shift;
128			$logger->debug( __PACKAGE__ . "->_initSchema()" );
129	joko	1.12	#if (!$schema_tangram) {
130	joko	1.5	my $obj = getNewPerlObjectByPkgName($self->{locator}->{schema}, { EXPORT_OBJECTS => $self->{locator}->{classnames}, want_transactions => $self->{locator}->{want_transactions} } );
131	joko	1.12	$schema_tangram = $obj->getSchema();
132	joko	1.4	#}
133	joko	1.12	if (!$schema_tangram) {
134	joko	1.4	$logger->error( __PACKAGE__ . "->_initSchema: No Schema available for $self->{schema}" );
135			return 0;
136			}
137	joko	1.19	#$self->_patchSchema();
138	joko	1.4	return 1;
139	joko	1.19	}
140
141			sub _patchSchema {
142			my $self = shift;
143			foreach (keys %{$schema_tangram->{classes}}) {
144			next if $schema_tangram->{classes}->{$_}->{abstract};
145			#next if ($_ ne 'TsBankAccount');
146			#$_ ne 'AbstractAccount' &&
147			print "class: $_", "\n";
148			#print Dumper($schema_tangram->{classes}->{$_});
149			# create new string property named 'guid'
150			my $tstring = Tangram::String->new();
151			$tstring->{name} = $tstring->{col} = 'guid';
152			# inject property into schema
153			#$schema_tangram->{classes}->{$_}->{root}->{SPECS}->[0]->{fields}->{string}->{$tstring->{name}} = $tstring;
154			print Dumper($schema_tangram->{classes}->{$_}->{root}->{SPECS}->[0]->{fields});
155			}
156	joko	1.4	}
157
158	cvsjoko	1.1	sub connect {
159
160			my $self = shift;
161
162			my $dsn = shift;
163	joko	1.5	$dsn \|\|= $self->{locator}->{dbi}->{dsn};
164	cvsjoko	1.1
165	joko	1.2	$logger->debug( __PACKAGE__ . "->connect( dsn $dsn )" );
166	cvsjoko	1.1
167			#my $storage = Tangram::Relational->connect( $schema, $dsn );
168			#my $storage = Tangram::mysql->connect( $schema, $dsn );
169			#$storage = Tangram::Relational->connect( Project->schema, $dsn );
170
171			# if (!testDsn($dsn)) {
172			# croak("Database at \"$dsn\" is not available");
173			# return;
174			# }
175
176	joko	1.4	return unless $self->_initSchema();
177
178	joko	1.6	# create the main tangram storage object
179	joko	1.2	#$self->{COREHANDLE} = Tangram::Relational->connect( $schema, $dsn );
180	joko	1.13	$self->{_COREHANDLE} = Tangram::Relational->connect( $schema_tangram, $dsn );
181
182			#print "connect", "\n";
183			#my $core = $self->{_COREHANDLE};
184			#print Dumper($core);
185	cvsjoko	1.1
186	joko	1.6	# some attempts for configuring the wrapped underlying dbi.....
187	cvsjoko	1.1	#$self->{STORAGEHANDLE_UNDERLYING} = $self->getUnderlyingStorage();
188			#$self->{STORAGEHANDLE_UNDERLYING}->_configureCOREHANDLE();
189			#$self->_configureUnderlyingStorage;
190	joko	1.6
191			# ..... encapsulation wins!
192	cvsjoko	1.1	$self->configureCOREHANDLE();
193
194	joko	1.5	$self->{locator}->{status}->{connected} = 1;
195
196	joko	1.4	return 1;
197
198	cvsjoko	1.1	}
199
200			sub getChildNodes {
201
202			my $self = shift;
203			my @nodes;
204
205	joko	1.4	$logger->debug( __PACKAGE__ . "->getChildNodes()" );
206
207	cvsjoko	1.1	# create new DBI - Data::Storage - object from already connected DBI::db - handle inside the current COREHANDLE
208			#my $loc = new Data::Storage::Locator( type => "DBI", dbi => { db => $self->{COREHANDLE}->{db} });
209			#my $loc = new Data::Storage::Locator( type => "DBI", COREHANDLE => $self->{COREHANDLE}->{db} );
210	joko	1.6
211			# todo: should we retrieve information from the schema here
212			# rather than poorly getting table names from underlying dbi?
213	cvsjoko	1.1	my $storage = $self->_getSubLayerHandle();
214	joko	1.5	@nodes = @{$storage->getChildNodes()};
215	cvsjoko	1.1	#$storage->_configureCOREHANDLE();
216	joko	1.5	#print "getchildnodes\n";
217			#print Dumper($self);
218	cvsjoko	1.1	#if (my $result = $self->sendCommand( 'SHOW TABLES;' ) ) {
219
220	joko	1.8	# TODO: REVIEW
221			#$storage->disconnect();
222	cvsjoko	1.1
223	joko	1.4	$self->{meta}->{childnodes} = \@nodes;
224
225	cvsjoko	1.1	return \@nodes;
226
227			}
228
229
230	joko	1.4	sub testIntegrity {
231
232			my $self = shift;
233
234			$logger->debug( __PACKAGE__ . "->testIntegrity()" );
235
236			# 1st test: are there tables?
237			if (!$self->getChildNodes()) {
238			$logger->warning( __PACKAGE__ . "->testIntegrity no childnodes exist" );
239			return;
240			}
241
242			# 2nd test: is there a table named "Tangram"?
243			if (!$self->existsChildNode("Tangram")) {
244			$logger->warning( __PACKAGE__ . "->testIntegrity childnode \"Tangram\" doesn't exist" );
245			return;
246			}
247
248	joko	1.5	$self->{locator}->{status}->{integrity} = 1;
249	joko	1.4	return 1;
250
251			}
252
253
254	cvsjoko	1.1	sub _getSubLayerHandle {
255
256			my $self = shift;
257
258	joko	1.4	$logger->debug( __PACKAGE__ . "->_getSubLayerHandle()" );
259
260	cvsjoko	1.1	#print Dumper($self);
261	joko	1.5
262	cvsjoko	1.1	# hack, make more generic!
263	joko	1.4	if (!$self->{dataStorageLayer}) {
264			$logger->debug( __PACKAGE__ . "->_getSubLayerHandle() creating new dataStorageLayer" );
265			#my $loc = Data::Storage::Locator->new( type => "DBI", dbi => $self->{dbi}, COREHANDLE => $self->{COREHANDLE}->{db} );
266	joko	1.5	my $loc = Data::Storage::Locator->new( { type => "DBI", dbi => $self->{locator}->{dbi} } );
267	joko	1.4	$self->{dataStorageLayer} = Data::Storage->new( $loc, { protected => 1 } );
268	cvsjoko	1.1	#$self->{STORAGE_UNDER_THE_HOOD}->{STORAGEHANDLE}->_configureCOREHANDLE();
269			#$self->{STORAGE_UNDER_THE_HOOD}->_configureCOREHANDLE();
270			}
271
272			#print Dumper($self->{STORAGE_UNDER_THE_HOOD});
273
274	joko	1.4	return $self->{dataStorageLayer};
275	cvsjoko	1.1
276			}
277
278			sub _configureUnderlyingStorage {
279
280			my $self = shift;
281	joko	1.4
282			$logger->debug( __PACKAGE__ . "->_configureUnderlyingStorage" );
283
284	cvsjoko	1.1	$self->_configureCOREHANDLE_DBI();
285			return;
286
287			foreach my $key (keys %{$self->{dbi}}) {
288			my $val = $self->{dbi}->{$key};
289			print "entry: $key; $val", "\n";
290	joko	1.13	$self->{_COREHANDLE}->{db}->{$key} = $val;
291	cvsjoko	1.1	}
292			#print Dumper($self->{COREHANDLE}->{db});
293			}
294
295
296			sub configureCOREHANDLE {
297
298			my $self = shift;
299
300	joko	1.4	$logger->debug( __PACKAGE__ . "->configureCOREHANDLE" );
301	cvsjoko	1.1
302			#my $subLayer = $self->_getSubLayerHandle();
303
304			# apply configured modifications
305			if (exists $self->{dbi}->{trace_level} && exists $self->{dbi}->{trace_file}) {
306	joko	1.13	$self->{_COREHANDLE}->{db}->trace($self->{dbi}->{trace_level}, $self->{dbi}->{trace_file});
307	cvsjoko	1.1	}
308			if (exists $self->{dbi}->{RaiseError}) {
309	joko	1.13	$self->{_COREHANDLE}->{db}->{RaiseError} = $self->{dbi}->{RaiseError};
310	cvsjoko	1.1	}
311			if (exists $self->{dbi}->{PrintError}) {
312	joko	1.13	$self->{_COREHANDLE}->{db}->{PrintError} = $self->{dbi}->{PrintError};
313	cvsjoko	1.1	}
314			if (exists $self->{dbi}->{HandleError}) {
315	joko	1.13	$self->{_COREHANDLE}->{db}->{HandleError} = $self->{dbi}->{HandleError};
316	cvsjoko	1.1	}
317
318	joko	1.2	}
319
320			sub deploySchema {
321			my $self = shift;
322	joko	1.5	my $args = shift;
323
324			my $dsn = $self->{locator}->{dbi}->{dsn};
325	joko	1.4
326			$logger->debug( __PACKAGE__ . "->deploySchema( dsn $dsn )" );
327
328	joko	1.2	my $ok;
329	joko	1.8	if ( my $dbh = DBI->connect($dsn, '', '', $self->{locator}->{dbi} ) ) {
330	joko	1.4	return unless $self->_initSchema();
331	joko	1.12	$ok = Tangram::Relational->deploy($schema_tangram, $dbh );
332	joko	1.2	$dbh->disconnect();
333			}
334			return $ok;
335			}
336
337			sub retreatSchema {
338	joko	1.4
339	joko	1.2	my $self = shift;
340	joko	1.5	my $dsn = $self->{locator}->{dbi}->{dsn};
341	joko	1.4
342			$logger->debug( __PACKAGE__ . "->retreatSchema( dsn $dsn )" );
343
344	joko	1.2	my $ok;
345	joko	1.8	if ( my $dbh = DBI->connect($dsn, '', '', $self->{locator}->{dbi} ) ) {
346	joko	1.4
347			return unless $self->_initSchema();
348
349			#use Data::Dumper; print Dumper($self);
350			$self->{dataStorageLayer}->removeLogDispatchHandler("Tangram11");
351
352	joko	1.12	$ok = Tangram::Relational->retreat($schema_tangram, $dbh );
353	joko	1.8
354			# answer "$ok=2" means "maybe" for now - we have to patch this to a constant here because...
355			# - ... Tangram::Relational->retreat doesn't seem to return a valid status
356			# - possible improvement:
357			# - test this by checking for count of tables in database
358			# - problem with this: there may be some left not having been included to the schema
359			# - maybe better: use "->getChildNodes"?
360			$ok = 2;
361
362	joko	1.2	$dbh->disconnect();
363	joko	1.8
364	joko	1.2	}
365			return $ok;
366	joko	1.4	}
367
368	joko	1.23	sub rebuildDb {
369	joko	1.4	my $self = shift;
370	joko	1.23	$logger->info( __PACKAGE__ . "->rebuildDb()" );
371	joko	1.4	my @results;
372
373			# sum up results (bool (0/1)) in array
374			push @results, $self->retreatSchema();
375			push @results, $self->{dataStorageLayer}->dropDb();
376			push @results, $self->{dataStorageLayer}->createDb();
377			push @results, $self->deploySchema();
378
379			# scan array for "bad ones"
380			my $res = 1;
381			map {
382			$res = 0 if (!$_);
383			} @results;
384
385			return $res;
386	joko	1.6	}
387
388			sub getListUnfiltered {
389			my $self = shift;
390			my $nodename = shift;
391			my @results;
392			$logger->debug( __PACKAGE__ . "->getListUnfiltered( nodename => '" . $nodename . "' )" );
393			# get set of objects from odbms by object name
394	joko	1.13	my $object_set = $self->{_COREHANDLE}->remote($nodename);
395			@results = $self->{_COREHANDLE}->select($object_set);
396	joko	1.6	return \@results;
397			}
398
399			sub getListFiltered {
400			my $self = shift;
401
402			# redirect to unfiltered mode
403			#return $self->getListUnfiltered(@_);
404
405			my $nodename = shift;
406			my $filters = shift;
407			my @results;
408			$logger->debug( __PACKAGE__ . "->getListFiltered( nodename => '" . $nodename . "' )" );
409
410			#print Dumper($filters);
411
412			my @tfilters;
413
414			foreach my $filter (@$filters) {
415
416			# get filter - TODO: for each filter
417			#my $filter = $filters->[0];
418
419			# build filter
420			my $lexpr = $filter->{key};
421			#my $op = $filter->{op};
422			my $op = '=';
423			my $rexpr = $filter->{val};
424			my $tight = 100;
425
426			# my $tfilter = Tangram::Filter->new(
427			# expr => "t1.$lexpr $op '$rexpr'",
428			# tight => $tight,
429			# objects => $objects,
430			# );
431
432			# HACK: build eval-string (sorry) to get filtered list - please give advice here
433			push @tfilters, '$remote->{' . $filter->{key} . '}' . " $filter->{op} '$filter->{val}'";
434
435			}
436
437			my $tfilter = join(' & ', @tfilters);
438
439			# get set of objects from odbms by object name
440	joko	1.13	my $remote = $self->{_COREHANDLE}->remote($nodename);
441	joko	1.6
442			# was:
443			#@results = $self->{COREHANDLE}->select($object_set, $tfilter);
444
445			# is:
446			# HACK: build eval-string (sorry) to get filtered list - please give advice here
447	joko	1.13	my $evalstring = 'return $self->{_COREHANDLE}->select($remote, ' . $tfilter . ');';
448	joko	1.6
449			# get filtered list/set
450			@results = eval($evalstring);
451			die $@ if $@;
452
453			return \@results;
454			}
455
456			sub createCursor {
457			my $self = shift;
458			my $node = shift;
459	joko	1.13	my $cmdHandle = $self->{_COREHANDLE}->cursor($node);
460	joko	1.6	my $result = Data::Storage::Result::Tangram->new( RESULTHANDLE => $cmdHandle );
461			return $result;
462			}
463
464			sub createSet {
465			my $self = shift;
466	joko	1.18	#print "-" x 80, "\n";
467			#print Dumper(@_);
468	joko	1.6	my @objects = @_;
469			my $rh = Set::Object->new();
470			foreach (@objects) {
471	joko	1.18	if (!isEmpty($_)) {
472			#print Dumper($_);
473			$rh->insert($_);
474			}
475	joko	1.6	}
476			#print Dumper($rh->members());
477			my $result = Data::Storage::Result::Tangram->new( RESULTHANDLE => $rh );
478			return $result;
479			}
480
481			sub sendQuery {
482			my $self = shift;
483			my $query = shift;
484			#my $sql = "SELECT cs FROM $self->{metainfo}->{$descent}->{node} WHERE $self->{metainfo}->{$descent}->{IdentProvider}->{arg}='$self->{entry}->{source}->{ident}';";
485			#my $result = $self->{metainfo}->{$descent}->{storage}->sendCommand($sql);
486
487			#print Dumper($query);
488
489			# HACK: special case: querying by id does not translate into a common tangram query
490			# just load the object by given id(ent)
491			if ($query->{criterias}->[0]->{key} eq 'id' && $query->{criterias}->[0]->{op} eq 'eq') {
492			#print "LOAD!!!", "\n";
493			#exit;
494			#return Set::Object->new( $self->{COREHANDLE}->load($query->{criterias}->[0]->{val}) );
495			my $ident = $query->{criterias}->[0]->{val};
496			#print "load obj", "\n";
497			#return $self->createSet() if $ident == 5;
498	joko	1.18	$self->{_COREHANDLE}->unload($ident);
499	joko	1.13	my $object = $self->{_COREHANDLE}->load($ident);
500	joko	1.6	#print "get id", "\n";
501	joko	1.13	my $oid = $self->{_COREHANDLE}->id($object);
502	joko	1.18	#print Dumper($object);
503			#print "oid: $oid", "\n";
504	joko	1.6	return $self->createSet($object);
505			#return $self->createSet( $self->{COREHANDLE}->load('300090018') );
506			}
507
508			die("This should not be reached for now - redirect to \$self->getListFiltered() here!");
509
510			# TODO: do a common tangram query here
511
512			my @crits;
513			foreach (@{$query->{criterias}}) {
514			my $op = '';
515			$op = '=' if lc $_->{op} eq 'eq';
516			push @crits, "$_->{key}$op'$_->{val}'";
517			}
518			my $subnodes = {};
519			map { $subnodes->{$_}++ } @{$query->{subnodes}};
520			# HACK: this is hardcoded ;( expand possibilities!
521			#my $crit = join(' AND ', @crits);
522			#my $sql = hash2Sql($query->{node}, $subnodes, 'SELECT', $crit);
523			#return $self->sendCommand($sql);
524			#my $h = $self->{COREHANDLE}->remote($query->{node});
525			#my $res = $self->{COREHANDLE}->select($h, $h->{);
526			return $self->createCursor($query->{node});
527	joko	1.7	}
528
529			sub eraseAll {
530			my $self = shift;
531			my $classname = shift;
532	joko	1.13	my $remote = $self->{_COREHANDLE}->remote($classname);
533			my @objs = $self->{_COREHANDLE}->select($remote);
534			$self->{_COREHANDLE}->erase(@objs);
535	joko	1.8	}
536
537			sub createDb {
538			my $self = shift;
539			my $storage = $self->_getSubLayerHandle();
540			return $storage->createDb();
541	joko	1.9	}
542
543			sub getObject {
544			my $self = shift;
545			my $oid = shift;
546	jonen	1.14	my $options = shift;
547	joko	1.16
548			# TODO: create a deep_unload method (currently _all_ objects are unloaded)
549	jonen	1.14	# unload($oid) will only unload object, not deep object hashes
550	joko	1.17	$self->{_COREHANDLE}->unload() if ($options->{destroy});
551	joko	1.16
552	joko	1.9	# TODO: review this
553			#if (!$self->{COREHANDLE}) { return; }
554	joko	1.16
555			# TODO: review this
556			my $object = eval('$self->{_COREHANDLE}->load($oid);');
557			print $@, "\n" if $@;
558
559			return $object if $object;
560	joko	1.9	}
561
562	jonen	1.20	sub getObjectByGuid {
563			my $self = shift;
564			my $guid = shift;
565			my $options = shift;
566
567			# Guid and Classname is needed
568			if(!$guid \|\| !$options->{classname}) {
569	jonen	1.22	$logger->error( __PACKAGE__ . "->getObjectByGuid: No 'guid' OR no Classname in options hash was given but needed!" );
570	jonen	1.20	return;
571			}
572
573			# TODO: create a deep_unload method (currently _all_ objects are unloaded)
574			# unload($oid) will only unload object, not deep object hashes
575			$self->{_COREHANDLE}->unload() if ($options->{destroy});
576
577			# search for object with given Classname and Guid
578	jonen	1.21	my $obj_tmp = $self->{_COREHANDLE}->remote($options->{classname});
579	jonen	1.20	my @result = $self->{_COREHANDLE}->select($obj_tmp, $obj_tmp->{guid} eq $guid);
580
581			# we searched for global unique identifer of some object,
582	jonen	1.22	# so I think we can trust there would be only one result
583	jonen	1.20	if($result[0]) {
584			return $result[0];
585			} else {
586	jonen	1.22	$logger->error( __PACKAGE__ . "->getObjectByGuid: No Object with Classname $options->{classname} and GUID $guid found!" );
587			return;
588	jonen	1.20	}
589
590			}
591
592	joko	1.9	sub getObjectAsHash {
593			my $self = shift;
594			my $oid = shift;
595	jonen	1.20	my $options = shift;
596			my $obj;
597
598			if($options->{guid}) {
599			$obj = $self->getObjectByGuid($oid, $options);
600			} else {
601			$obj = $self->getObject($oid, $options);
602			}
603	joko	1.15
604			# build options (a callback to unload autovivified objects) for 'expand'
605			# TODO: use $logger to write to debug here!
606			my $cb; # = sub {};
607			=pod
608			if ($options->{destroy}) {
609			$options->{cb}->{destroy} = sub {
610			print "================ DESTROY", "\n";
611			my $object = shift;
612			#print Dumper($object);
613			$self->{_COREHANDLE}->unload($object);
614			#undef($object);
615			};
616			}
617			=cut
618
619			my $hash = object2hash($obj, $options);
620			#$options->{cb}->{destroy}->($obj);
621			#$self->{_COREHANDLE}->unload($obj);
622
623			# convert values in hash to utf8 to be ready for (e.g.) encapsulation in XML
624			# now done in object2hash
625			#var2utf8($hash) if ($options->{utf8});
626
627			# old (wrong) attempts to get rid of used instances, if requested
628			#$obj->clear_refs;
629			#$self->{COREHANDLE}->unload($obj) if($options->{destroy});
630			#$obj->DESTROY;
631			#undef($obj) if($options->{destroy});
632
633			return $hash;
634	joko	1.12	}
635
636			sub getSchema {
637			return $schema_tangram;
638	joko	1.13	}
639
640			sub getCOREHANDLE {
641			my $self = shift;
642			return $self->{_COREHANDLE};
643	cvsjoko	1.1	}
644
645			1;
MailToCvsAdmin">MailToCvsAdmin	ViewVC Help
Powered by ViewVC 1.1.26