Interface IStorageProvider

Interface for storage providers which provide the read/write functionality to some arbitrary storage layer.
Inherited Members
System.IDisposable.Dispose()
Namespace: VDS.RDF.Storage
Assembly: dotNetRDF.dll
Syntax
public interface IStorageProvider : IStorageCapabilities, IDisposable
Remarks
Designed to allow for arbitrary Triple Stores to be plugged into the library as required by the end user.

Properties

| Improve this Doc View Source

ParentServer

Gets the Parent Server on which this store is hosted (if any).
Declaration
IStorageServer ParentServer { get; }
Property Value
Type Description
IStorageServer
Remarks

For storage backends which support multiple stores this is useful because it provides a way to access all the stores on that backend. For stores which are standalone they should simply return null.

Methods

| Improve this Doc View Source

DeleteGraph(String)

Deletes a Graph from the Store.
Declaration
void DeleteGraph(string graphUri)
Parameters
Type Name Description
System.String graphUri URI of the Graph to be deleted.
Remarks

Note: Not all Stores are capable of Deleting a Graph so it is acceptable for such a Store to throw a System.NotSupportedException or an RdfStorageException if the Store cannot provide this functionality.

Exceptions
Type Condition
System.NotSupportedException May be thrown if the underlying Store is not capable of doing Deleting a Graph.
RdfStorageException May be thrown if the underlying Store is not capable of Deleting a Graph or an error occurs while performing the delete.
| Improve this Doc View Source

DeleteGraph(Uri)

Deletes a Graph from the Store.
Declaration
void DeleteGraph(Uri graphUri)
Parameters
Type Name Description
System.Uri graphUri URI of the Graph to be deleted.
Remarks

Note: Not all Stores are capable of Deleting a Graph so it is acceptable for such a Store to throw a System.NotSupportedException or an RdfStorageException if the Store cannot provide this functionality.

Exceptions
Type Condition
System.NotSupportedException May be thrown if the underlying Store is not capable of doing Deleting a Graph.
RdfStorageException May be thrown if the underlying Store is not capable of Deleting a Graph or an error occurs while performing the delete.
| Improve this Doc View Source

ListGraphs()

Gets a List of Graph URIs for the graphs in the store.
Declaration
IEnumerable<Uri> ListGraphs()
Returns
Type Description
System.Collections.Generic.IEnumerable<System.Uri>
Remarks

Implementations should implement this method only if they need to provide a custom way of listing Graphs. If the Store for which you are providing a manager can efficiently return the Graphs using a SELECT DISTINCT ?g WHERE { GRAPH ?g { ?s ?p ?o } } query then there should be no need to implement this function.

| Improve this Doc View Source

LoadGraph(IGraph, String)

Loads a Graph from the Store.
Declaration
void LoadGraph(IGraph g, string graphUri)
Parameters
Type Name Description
IGraph g Graph to load into.
System.String graphUri URI of the Graph to load.
Remarks

If the Graph being loaded into is Empty then it's Base Uri should become the Uri of the Graph being loaded, otherwise it should be merged into the existing non-empty Graph whose Base Uri should be unaffected.

Behaviour of this method with regards to non-existent Graphs is up to the implementor, an empty Graph may be returned or an error thrown. Implementors should state in the XML comments for their implementation what behaviour is implemented.

| Improve this Doc View Source

LoadGraph(IGraph, Uri)

Loads a Graph from the Store.
Declaration
void LoadGraph(IGraph g, Uri graphUri)
Parameters
Type Name Description
IGraph g Graph to load into.
System.Uri graphUri Uri of the Graph to load.
Remarks

If the Graph being loaded into is Empty then it's Base Uri should become the Uri of the Graph being loaded, otherwise it should be merged into the existing non-empty Graph whose Base Uri should be unaffected.

Behaviour of this method with regards to non-existent Graphs is up to the implementor, an empty Graph may be returned or an error thrown. Implementors should state in the XML comments for their implementation what behaviour is implemented.

| Improve this Doc View Source

LoadGraph(IRdfHandler, String)

Loads a Graph from the Store using the RDF Handler.
Declaration
void LoadGraph(IRdfHandler handler, string graphUri)
Parameters
Type Name Description
IRdfHandler handler RDF Handler.
System.String graphUri URI of the Graph to load.
Remarks

Behaviour of this method with regards to non-existent Graphs is up to the implementor, an empty Graph may be returned or an error thrown. Implementors should state in the XML comments for their implementation what behaviour is implemented.

| Improve this Doc View Source

LoadGraph(IRdfHandler, Uri)

Loads a Graph from the Store using the RDF Handler.
Declaration
void LoadGraph(IRdfHandler handler, Uri graphUri)
Parameters
Type Name Description
IRdfHandler handler RDF Handler.
System.Uri graphUri URI of the Graph to load.
Remarks

Behaviour of this method with regards to non-existent Graphs is up to the implementor, an empty Graph may be returned or an error thrown. Implementors should state in the XML comments for their implementation what behaviour is implemented.

| Improve this Doc View Source

SaveGraph(IGraph)

Saves a Graph to the Store.
Declaration
void SaveGraph(IGraph g)
Parameters
Type Name Description
IGraph g Graph to Save.
Remarks
Uri of the Graph should be taken from the BaseUri property

Behaviour of this method with regards to whether it overwrites/updates/merges with existing Graphs of the same Uri is up to the implementor and may be dependent on the underlying store. Implementors should state in the XML comments for their implementations what behaviour is implemented.
| Improve this Doc View Source

UpdateGraph(String, IEnumerable<Triple>, IEnumerable<Triple>)

Updates a Graph in the Store.
Declaration
void UpdateGraph(string graphUri, IEnumerable<Triple> additions, IEnumerable<Triple> removals)
Parameters
Type Name Description
System.String graphUri Uri of the Graph to update.
System.Collections.Generic.IEnumerable<Triple> additions Triples to add to the Graph.
System.Collections.Generic.IEnumerable<Triple> removals Triples to remove from the Graph.
Remarks

Note: Not all Stores are capable of supporting update at the individual Triple level and as such it is acceptable for such a Store to throw a System.NotSupportedException or an RdfStorageException if the Store cannot provide this functionality.

Behaviour of this method with regards to non-existent Graph is up to the implementor, it may create a new empty Graph and apply the updates to that or it may throw an error. Implementors should state in the XML comments for their implementation what behaviour is implemented.

Implementers MUST allow for either the additions or removals argument to be null.

Exceptions
Type Condition
System.NotSupportedException May be thrown if the underlying Store is not capable of doing Updates at the Triple level.
RdfStorageException May be thrown if the underlying Store is not capable of doing Updates at the Triple level or if some error occurs while attempting the Update.
| Improve this Doc View Source

UpdateGraph(Uri, IEnumerable<Triple>, IEnumerable<Triple>)

Updates a Graph in the Store.
Declaration
void UpdateGraph(Uri graphUri, IEnumerable<Triple> additions, IEnumerable<Triple> removals)
Parameters
Type Name Description
System.Uri graphUri Uri of the Graph to update.
System.Collections.Generic.IEnumerable<Triple> additions Triples to add to the Graph.
System.Collections.Generic.IEnumerable<Triple> removals Triples to remove from the Graph.
Remarks

Note: Not all Stores are capable of supporting update at the individual Triple level and as such it is acceptable for such a Store to throw a System.NotSupportedException if the Store cannot provide this functionality.

Behaviour of this method with regards to non-existent Graph is up to the implementor, it may create a new empty Graph and apply the updates to that or it may throw an error. Implementors should state in the XML comments for their implementation what behaviour is implemented.

Implementers MUST allow for either the additions or removals argument to be null.

Exceptions
Type Condition
System.NotSupportedException May be thrown if the underlying Store is not capable of doing Updates at the Triple level.
RdfStorageException May be thrown if the underlying Store is not capable of doing Updates at the Triple level or if some error occurs while attempting the Update.

Extension Methods