Topic maps, abstract class for maps with stream based input/output drivers
# this class will never be directly used for instantiation # see the description in TM and individual low-level drivers (AsTMa, ...)
This class is a subclass of \s-1TM\s0, 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, ....).
The constructor of implementations should expect a hash as parameter containing the field(s) from \s-1TM\s0 and one or more of the following:
If given, then the instance will be read from this url whenever synced in.
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.
If given, then the instance will be read directly from this text provided inline when synced.
If several fields (\*(C`file\*(C', \*(C`url\*(C', \*(C`inline\*(C') 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');
\s-1TM\s0
Copyright 200[2-6], Robert Barta <[email protected]>, 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