NAME

RDFStore::Model - An implementation of the Model RDF API using tied hashes and implementing free-text search on literals

SYNOPSIS

	use RDFStore::NodeFactory;
	my $factory= new RDFStore::NodeFactory();
	my $statement = $factory->createStatement(
                        	$factory->createResource('http://perl.org'),
                        	$factory->createResource('http://iscool.org/schema/1.0/','label'),
                        	$factory->createLiteral('Cool Web site')
                                );
	my $statement1 = $factory->createStatement(
				$factory->createResource("http://www.altavista.com"),
				$factory->createResource("http://pen.jrc.it/schema/1.0/','author'),
				$factory->createLiteral("Who? :-)")
				);

	my $statement2 = $factory->createStatement(
				$factory->createUniqueResource(),
				$factory->createUniqueResource(),
				$factory->createLiteral("")
				);

	use RDFStore::Model;
	my $model = new RDFStore::Model( Name => 'store', FreeText => 1 );

	$model->add($statement);
	$model->add($statement1);
	$model->add($statement2);
	my $model1 = $model->duplicate();

	print $model1->getDigest->equals( $model1->getDigest );
	print $model1->getDigest->hashCode;

	my $found = $model->find($statement2->subject,undef,undef);
	my $found1 = $model->find(undef,undef,undef,undef,'Cool'); #free-text search on literals :)

	#get Statements
	foreach ( @{$found->elements} ) {
        	print $_->getLabel(),"\n";
	};

	#or faster
	my $fetch;
	foreach ( @{$found->elements} ) {
		my $fetch=$_;  #avoid too many fetches from RDFStore::Model::Statements
        	print $fetch->getLabel(),"\n";
	};

	#or
	my($statements)=$found1->elements;
	for ( 0..$#{$statements} ) {
                print $statements->[$_]->getLabel(),"\n";
        };

	#get RDFNodes
	foreach ( keys %{$found->elements}) {
        	print $found->elements->{$_}->getLabel(),"\n";
	};

	# set operations
        my $set = new RDFStore::Model( Name => 'setmodel' );

        $set=$set->interset($other_model);
        $set=$set->unite($other_model);
        $set=$set->subtract($other_model);

DESCRIPTION

An RDFStore::Model implementation using RDFStore(3) to store triplets.

CONSTRUCTORS

The following methods construct/tie RDFStore::Model storages and objects:

$model = new RDFStore::Model( %whateveryoulikeit );

Create an new RDFStore::Model object and tie up the RDFStore(3). The %whateveryoulikeit hash contains a set of configuration options about how and where store actual data.

Possible additional options are the following:

Name

This is a label used to identify a Persistent storage by name. It might correspond to a physical file system directory containing the indexes DBs. By default if no Name option is given the storage is assumed to be in-memory (e.g. RDFStore::Storage::find method return result sets as in-memory models by default unless specified differently). For local persistent storages a directory named liek this option is created in the current working directory with mode 0666)

Sync

Sync the RDFStore::Model with the underling Data::MagciTie GDS after each add() or remove().

FreeText

Enable free text searching on literals over a model (see find)

SEE ALSO

Digest(3) RDFStore(3) RDFStore::Digest::Digestable(3) RDFStore::Digest(3) RDFStore::RDFNode(3) RDFStore::Resource(3)

AUTHOR

Alberto Reggiori <areggiori@webweaving.org>