GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  RDF::TRINE::STORE (3)

.ds Aq ’

NAME

RDF::Trine::Store - RDF triplestore base class

CONTENTS

VERSION

This document describes RDF::Trine::Store version 1.014

DESCRIPTION

RDF::Trine::Store provides a base class and common API for implementations of triple/quadstores for use with the RDF::Trine framework. In general, it should be used only be people implementing new stores. For interacting with stores (e.g. to read, insert, and delete triples) the RDF::Trine::Model interface should be used (using the model as an intermediary between the client/user and the underlying store).

To be used by the RDF::Trine framework, store implementations must implement a set of required functionality:
o new
o get_statements
o get_contexts
o add_statement
o remove_statement
o count_statements
o supports
Implementations may also provide the following methods if a native implementation would be more efficient than the default provided by RDF::Trine::Store:
o get_pattern
o get_sparql
o remove_statements
o size
o nuke
o _begin_bulk_ops
o _end_bulk_ops

METHODS

new ( $data ) Returns a new RDF::Trine::Store object based on the supplied data value. This constructor delegates to one of the following methods depending on the value of $data:

* new_with_string if $data is not a reference

* new_with_config if $data is a HASH reference

* new_with_object if $data is a blessed object

new_with_string ( $config ) Returns a new RDF::Trine::Store object based on the supplied configuration string. The format of the string specifies the Store subclass to be instantiated as well as any required constructor arguments. These are separated by a semicolon. An example configuration string for the DBI store would be:



 DBI;mymodel;DBI:mysql:database=rdf;user;password



The format of the constructor arguments (everything after the first ’;’) is specific to the Store subclass.

new_with_config ( \%config ) Returns a new RDF::Trine::Store object based on the supplied configuration hashref. This requires the the Store subclass to be supplied with a storetype key, while other keys are required by the Store subclasses, please refer to each subclass for specific documentation.

An example invocation for the DBI store may be:



  my $store = RDF::Trine::Store->new_with_config({
                storetype => DBI,
                name      => mymodel,
                dsn       => DBI:mysql:database=rdf,
                username  => dahut,
                password  => Str0ngPa55w0RD
              });



new_with_object ( $object ) Returns a new RDF::Trine::Store object based on the supplied opaque $object. If the $object is recognized by an available backend as being sufficient to construct a store object, the store object will be returned. Otherwise undef will be returned.
nuke Permanently removes the store and its data.
class_by_name ( $name ) Returns the class of the storage implementation with the given name. For example, Memory would return RDF::Trine::Store::Memory.
temporary_store Returns a new temporary triplestore (using appropriate default values).
get_statements ($subject, $predicate, $object [, $context] ) Returns a stream object of all statements matching the specified subject, predicate and objects. Any of the arguments may be undef to match any value.
get_contexts Returns an RDF::Trine::Iterator over the RDF::Trine::Node objects comprising the set of contexts of the stored quads.
add_statement ( $statement [, $context] ) Adds the specified $statement to the underlying model.
remove_statement ( $statement [, $context]) Removes the specified $statement from the underlying model.
remove_statements ( $subject, $predicate, $object [, $context]) Removes the specified $statement from the underlying model.
count_statements ($subject, $predicate, $object) Returns a count of all the statements matching the specified subject, predicate and objects. Any of the arguments may be undef to match any value.
size Returns the number of statements in the store.
etag If the store has the capability and knowledge to support caching, returns a persistent token that will remain consistent as long as the store’s data doesn’t change. This token is acceptable for use as an HTTP ETag.
supports ( [ $feature ] ) If $feature is specified, returns true if the feature is supported by the store, false otherwise. If $feature is not specified, returns a list of supported features.

BUGS

Please report any bugs or feature requests to through the GitHub web interface at <https://github.com/kasei/perlrdf/issues>.

AUTHOR

Gregory Todd Williams <gwilliams@cpan.org>

COPYRIGHT

Copyright (c) 2006-2012 Gregory Todd Williams. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 RDF::TRINE::STORE (3) 2015-05-17

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.