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

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

NAME

       TM::Materialized::JTM - Topic Maps, trait for JSON Topic Map instances.

SYNOPSIS

	 use TM::Materialized::JTM;
	 my $tm=TM::Materialized::JTM(file=>"somefile.jtm");
	 $tm->sync_in;
	 ...
	 # map was modified, now save the changes
	 $tm->sync_out;

DESCRIPTION

       This package provides map parsing and creating functionality for JTM (JSON Topic Map) instances.  The JSON Topic Map format is defined
       here: <http://www.cerny-online.com/jtm/1.0/>.

INTERFACE

   Methods
       Constructor
	   $tm = TM::Materialized::JTM->new (...);

	   The constructor expects a hash as described in TM::Materialized::Stream, with one additional key/value parameter:

	   o   format (choices: "json", "yaml")

	       This option controls whether the JTM data is treated as being in JSON format or in YAML (which is a superset of JSON). This applies
	       to both reading and writing of map data.

	       The default value is "json".

       format
	   $tm->format('json');

	   $curformat=$tm->format;

	   This method gets or sets the format parameter for future operations. Possible choices: "json", "yaml".

SEE ALSO

       TM::Serializable::JTM

AUTHOR INFORMATION

       Copyright 2010, Alexander Zangerl, 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							    2010-07-18						TM::Materialized::JTM(3pm)

TM::ResourceAble::MLDBM(3pm)				User Contributed Perl Documentation			      TM::ResourceAble::MLDBM(3pm)

NAME

       TM::ResourceAble::MLDBM - Topic Maps, DBM Storage (synchronous)

SYNOPSIS

	   use TM::ResourceAble::MLDBM;
	  {
	   my $tm = new TM::ResourceAble::MLDBM (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::ResourceAble::MLDBM (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.

       This implementation technique is not so memory-efficient as I had thought. Whenever an assertion or a toplet is referenced, the whole block
       of toplets, resp. assertions, is loaded from the DB database.  For small maps this is really fast, but it can become a drag for larger
       maps. See TM::ResourceAble::BDB for a more efficient solution.

       NOTE: Be careful to use this together with TM::Index::*. The indices will be held as part of the map, and so will be stored along side. If
       you heavily use the map, this can result in many swapin/swapouts.  Better to look at TM::IndexAble for that matter.

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							    2010-07-18					      TM::ResourceAble::MLDBM(3pm)