/ 
ObjStore-1.59
River stage zero No dependents
/ ObjStore::ServerDB

NAME

ObjStore::ServerDB - Generic Real-Time Database Server Framework

SYNOPSIS

osperlserver host:/full/path/to/db+=MyClass

DESCRIPTION

An active database is an framework for tightly integrated collaboration. While implementation abstraction is preserved without hinderance, objects can easy interact in a variety of ways:

  • ABSTRACTION / COLLABORATION

    The hash at the top of the database holds the set of cooperating objects that implement all database functionality. This hash is always accessable via $any-database_of->hash>. Furthermore, keys are populated such that they reflect the @ISA tree of object instances.

  • CLIENT / SERVER

    Other processes can read the database asyncronously with MVCC transactions invoke remote method invokations (RMIs) on individual objects. See ObjStore::notify.

  • EVENT MANAGEMENT

    The Event API is fully integrated (see ObjStore::Process). Moreover, low priority jobs can be (persistently) queued for processing with a variety of scheduling options (see ObjStore::Job).

BOOTSTRAPPING

The $db-hash->do_boot_class> method creates arbitrary classes and populates the top-level hash. There are quite a few ways to invoke it:

  • COMMAND-LINE

    osperlserver host:/full/path/to/db+=MyClass

  • RMI

    $db->hash->boot_class('MyClass');

  • INHERITANCE

    package MyDB::Top;
require 'ObjStore::ServerDB';
use base 'ObjStore::ServerDB::Top';
sub boot {
   my ($o) = @_;
   $o->boot_class('MyClass');
}

osperlserver host:/full/path/to/db=MyDB