Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tm::materialized::stream(3pm) [debian man page]

TM::Materialized::Stream(3pm)				User Contributed Perl Documentation			     TM::Materialized::Stream(3pm)

NAME

       TM::Materialized::Stream - Topic Maps, abstract class for maps with stream based input/output drivers

SYNOPSIS

	 # this class will never be directly used for instantiation
	 # see the description in TM and individual low-level drivers (AsTMa, ...)

DESCRIPTION

       This class is a subclass of TM, so it implements map objects. It is abstract, though, as it only defined how a stream-based driver package
       should behave. It may thus be inherited by classes which implement external formats (TM::Materialized::AsTMa, TM::Materialized::XML, ....).

INTERFACE

   Constructor
       The constructor of implementations should expect a hash as parameter containing the field(s) from TM and one or more of the following:

       url:
	   If given, then the instance will be read from this url whenever synced in.

       file:
	   If given, then the data will be read/written from/to this file. This is just a convenience as it will be mapped to url.

       inline:
	   If given, then the instance will be read directly from this text provided inline when synced.

       If several fields ("file", "url", "inline") are specified, it is undefined which one will be taken.

       Examples (using AsTMa):

	  # opening from an AsTMa= file
	  $atm = new TM::Materialized::AsTMa (file   => 'here.atm');

	  # why need a file? files are evil, anyway
	  $atm = new TM::Materialized::AsTMa (inline => '# this is AsTMa');

SEE ALSO

       TM

AUTHOR INFORMATION

       Copyright 200[2-6], Robert Barta <drrho@cpan.org>, All rights reserved.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
       http://www.perl.com/perl/misc/Artistic.html

perl v5.10.1							    2008-04-10					     TM::Materialized::Stream(3pm)

Check Out this Related Man Page

TM::Materialized::MLDBM2(3pm)				User Contributed Perl Documentation			     TM::Materialized::MLDBM2(3pm)

NAME

       TM::Materialized::MLDBM2 - Topic Maps, DBM Storage (synchronous)

SYNOPSIS

	  NOTE: THIS PACKAGE IS NOW DEPRECATED
	  NOTE: USE TM::ResourceAble::MLDBM INSTEAD

	  use TM::Materialized::MLDBM2;
	  {
	   my $tm = new TM::Materialized::MLDBM2 (file => '/tmp/map.dbm');
	   # modify the map here.....

	   } # it goes out of scope here, and all changes are written back automagically

	  # later in the game
	  {
	   my $tm = new TM::Materialized::MLDBM2 (file => '/tmp/map.dbm');
	   # we are back in business, no sync necessary
	   }

DESCRIPTION

       This package just implements TM with a BerkeleyDB store. Unlike TM::Materialized::MLDBM this module does not need explicit synchronisation
       with the external resource (the DBM file here).	It ties content-wise with the DBM file at constructor time and unties at DESTROY time.

       The advantage of this storage form is that there is little memory usage. Only those fractions of the map are loaded which are actually
       needed. If one has very intense interactions with the map (as a query processor has), then this storage technique is not optimal.

INTERFACE

   Constructor
       The constructor expects a hash with the following keys:

       file (no default)
	   This contains the file name of the DBM file to tie to.

SEE ALSO

       TM, TM::Materialized::MLDBM

AUTHOR INFORMATION

       Copyright 200[68], Robert Barta <drrho@cpan.org>, All rights reserved.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
       http://www.perl.com/perl/misc/Artistic.html

perl v5.10.1							    2008-06-25					     TM::Materialized::MLDBM2(3pm)
Man Page