Class SpinWrappedDataset

Provides SPIN capabilities for a Dataset over any SPIN-unaware IUpdateableStorage (including the InMemoryManager). TODO decide how to handle the default unnamed graph case TODO design a concurrency management policy

Inheritance

System.Object

SpinWrappedDataset

Implements

ISparqlDataset

Inherited Members

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: VDS.RDF.Query.Spin

Assembly: dotNetRDF.Query.Spin.dll

Syntax

public class SpinWrappedDataset : ISparqlDataset

Constructors

SpinWrappedDataset(Uri, IUpdateableStorage)

Inititalize a SpinWrapperDataset upon a storage engine using a RDF SparqlDataset definition.

Declaration

public SpinWrappedDataset(Uri datasetUri, IUpdateableStorage storage)

Parameters

Type	Name	Description
System.Uri	datasetUri
IUpdateableStorage	storage

SpinWrappedDataset(Uri, IUpdateableStorage, IEnumerable<Uri>)

Inititalize a SPIN model upon a storage engine using a RDF SparqlDataset definition composed of the specified graphs.

Declaration

public SpinWrappedDataset(Uri datasetUri, IUpdateableStorage storage, IEnumerable<Uri> graphUris)

Parameters

Type	Name	Description
System.Uri	datasetUri
IUpdateableStorage	storage
System.Collections.Generic.IEnumerable<System.Uri>	graphUris

Fields

CommandCalls

The SPARQL update command calls made by this wrapper

Declaration

public List<string> CommandCalls

Field Value

Type	Description
System.Collections.Generic.List<System.String>

Properties

ActiveGraphUris

Gets the enumeration of the Graph URIs that currently make up the active graph.

Declaration

public IEnumerable<Uri> ActiveGraphUris { get; }

Property Value

Type	Description
System.Collections.Generic.IEnumerable<System.Uri>

DefaultGraphUris

Gets the enumeration of the Graph URIs that currently make up the default graph.

Declaration

public IEnumerable<Uri> DefaultGraphUris { get; }

Property Value

Type	Description
System.Collections.Generic.IEnumerable<System.Uri>

Graphs

Gets all the Graphs in the Dataset.

Declaration

public IEnumerable<IGraph> Graphs { get; }

Property Value

Type	Description
System.Collections.Generic.IEnumerable<IGraph>

GraphUris

Gets all the URIs of Graphs in the Dataset.

Declaration

public IEnumerable<Uri> GraphUris { get; }

Property Value

Type	Description
System.Collections.Generic.IEnumerable<System.Uri>

HasTriples

Gets whether the Dataset has any Triples.

Declaration

public bool HasTriples { get; }

Property Value

Type	Description
System.Boolean

Item[Uri]

Gets the Graph with the given URI from the Dataset.

Declaration

public IGraph this[Uri graphUri] { get; }

Parameters

Type	Name	Description
System.Uri	graphUri	Graph URI.

Property Value

Type	Description
IGraph

Remarks

This property need only return a read-only view of the Graph, code which wishes to modify Graphs should use the GetModifiableGraph(Uri) method to guarantee a Graph they can modify and will be persisted to the underlying storage.

Namespaces

Gets the Dataset namespace prefixes map if supported.

Declaration

public INamespaceMapper Namespaces { get; }

Property Value

Type	Description
INamespaceMapper

SourceUri

Returns the original dataset Uri

Declaration

public Uri SourceUri { get; }

Property Value

Type	Description
System.Uri

Triples

Gets all the Triples in the Dataset.

Declaration

public IEnumerable<Triple> Triples { get; }

Property Value

Type	Description
System.Collections.Generic.IEnumerable<Triple>

Remarks

Note: The Triples returned from the method should be limited to those in the current Active Graph if present, otherwise those in the current Default Graph if present and finally the entire Dataset.

UpdatesMonitor

Gets/sets a graph to monitor global changes to the dataset. Responsibility for the management of this graph is left to the caller. Changes will be notified only at the end of the update process to avoid inducing too much I/O with each partial result.

Declaration

public IGraph UpdatesMonitor { get; set; }

Property Value

Type	Description
IGraph

Uri

Returns the current dataset Uri. If the dataset has been updated use SourceUri to get the orignal dataset Uri

Declaration

public Uri Uri { get; }

Property Value

Type	Description
System.Uri

UsesUnionDefaultGraph

Gets whether the Default Graph is treated as being the union of all Graphs in the dataset when no Default Graph is otherwise set.

Declaration

public bool UsesUnionDefaultGraph { get; }

Property Value

Type	Description
System.Boolean

Methods

AddGraph(IGraph)

Adds a graph in the dataset and submits it to SPIN processing. If the graph already exists in the dataset, this will lead its replacement by the new graph.

Declaration

public bool AddGraph(IGraph g)

Parameters

Type	Name	Description
IGraph	g

Returns

Type	Description
System.Boolean

ContainsTriple(Triple)

Gets whether the Dataset contains a specific Triple.

Declaration

public bool ContainsTriple(Triple t)

Parameters

Type	Name	Description
Triple	t	Triple.

Returns

Type	Description
System.Boolean

Discard()

Ensures that any changes to the Dataset (if any) are discarded.

Declaration

public void Discard()

Remarks

Primarily intended for use in implementations which support transactions though other implementations may wish to use this to ensure that changes to the dataset are persisted properly.

ExecuteQuery(String)

Executes a SPARQL query on the dataset

Declaration

public object ExecuteQuery(string sparqlQuery)

Parameters

Type	Name	Description
System.String	sparqlQuery

Returns

Type	Description
System.Object

ExecuteUpdate()

Executes any pending SPARQL Update command from changes made to the dataset trough the API

Declaration

public void ExecuteUpdate()

ExecuteUpdate(String)

Executes the SPARQL Update command on the dataset

Declaration

public void ExecuteUpdate(string sparqlUpdateCommandSet)

Parameters

Type	Name	Description
System.String	sparqlUpdateCommandSet

Flush()

Flushes changes to the dataset TODO handle dataset changes as updates instread of overwriting it to make it workable in a concurrent environment.

Declaration

public void Flush()

GetModifiableGraph(Uri)

Declaration

public IGraph GetModifiableGraph(Uri graphUri)

Parameters

Type	Name	Description
System.Uri	graphUri

Returns

Type	Description
IGraph

GetTriplesWithObject(INode)

Gets all the Triples in the Dataset with the given Object.

Declaration

public IEnumerable<Triple> GetTriplesWithObject(INode obj)

Parameters

Type	Name	Description
INode	obj	Object.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>

Remarks

Note: The Triples returned from the method should be limited to those in the current Active Graph if present, otherwise those in the current Default Graph if present and finally the entire Dataset.

GetTriplesWithPredicate(INode)

Gets all the Triples in the Dataset with the given Predicate.

Declaration

public IEnumerable<Triple> GetTriplesWithPredicate(INode pred)

Parameters

Type	Name	Description
INode	pred	Predicate.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>

Remarks

Note: The Triples returned from the method should be limited to those in the current Active Graph if present, otherwise those in the current Default Graph if present and finally the entire Dataset.

GetTriplesWithPredicateObject(INode, INode)

Gets all the Triples in the Dataset with the given Predicate and Object.

Declaration

public IEnumerable<Triple> GetTriplesWithPredicateObject(INode pred, INode obj)

Parameters

Type	Name	Description
INode	pred	Predicate.
INode	obj	Object.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>

Remarks

Note: The Triples returned from the method should be limited to those in the current Active Graph if present, otherwise those in the current Default Graph if present and finally the entire Dataset.

GetTriplesWithSubject(INode)

Gets all the Triples in the Dataset with the given Subject.

Declaration

public IEnumerable<Triple> GetTriplesWithSubject(INode subj)

Parameters

Type	Name	Description
INode	subj	Subject.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>

Remarks

Note: The Triples returned from the method should be limited to those in the current Active Graph if present, otherwise those in the current Default Graph if present and finally the entire Dataset.

GetTriplesWithSubjectObject(INode, INode)

Gets all the Triples in the Dataset with the given Subject and Object.

Declaration

public IEnumerable<Triple> GetTriplesWithSubjectObject(INode subj, INode obj)

Parameters

Type	Name	Description
INode	subj	Subject.
INode	obj	Object.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>

Remarks

Note: The Triples returned from the method should be limited to those in the current Active Graph if present, otherwise those in the current Default Graph if present and finally the entire Dataset.

GetTriplesWithSubjectPredicate(INode, INode)

Gets all the Triples in the Dataset with the given Subject and Predicate.

Declaration

public IEnumerable<Triple> GetTriplesWithSubjectPredicate(INode subj, INode pred)

Parameters

Type	Name	Description
INode	subj	Subject.
INode	pred	Predicate.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>

Remarks

Note: The Triples returned from the method should be limited to those in the current Active Graph if present, otherwise those in the current Default Graph if present and finally the entire Dataset.

HasGraph(Uri)

Gets whether a Graph with the given URI is the Dataset

Declaration

public bool HasGraph(Uri graphUri)

Parameters

Type	Name	Description
System.Uri	graphUri

Returns

Type	Description
System.Boolean

ImportGraph(Uri)

Declaration

public void ImportGraph(Uri graphUri)

Parameters

Type	Name	Description
System.Uri	graphUri

ImportGraph(IGraph)

Imports a graph into the dataset and registers it as a SPIN.LibraryOntology for further SPIN processing.

Declaration

public void ImportGraph(IGraph graph)

Parameters

Type	Name	Description
IGraph	graph

OnDatasetDescriptionChanged(Object, GraphEventArgs)

Event handler to monitor the current Dataset

Declaration

protected void OnDatasetDescriptionChanged(object sender, GraphEventArgs args)

Parameters

Type	Name	Description
System.Object	sender
GraphEventArgs	args

RemoveGraph(Uri)

Removes a graph from the Dataset. The underlying graph and it's entailments are not deleted from the store, however all pending changes on the graph are cancelled

Declaration

public bool RemoveGraph(Uri graphUri)

Parameters

Type	Name	Description
System.Uri	graphUri

Returns

Type	Description
System.Boolean

ResetActiveGraph()

Resets the Active Graph to the previous Active Graph.

Declaration

public void ResetActiveGraph()

ResetDefaultGraph()

Resets the Default Graph to the previous Default Graph.

Declaration

public void ResetDefaultGraph()

SetActiveGraph(IEnumerable<Uri>)

Sets the Active Graph to be the merge of the Graphs with the given URIs.

Declaration

public void SetActiveGraph(IEnumerable<Uri> graphUris)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Uri>	graphUris	Graph URIs.

SetActiveGraph(Uri)

Sets the Active Graph to be the Graph with the given URI.

Declaration

public void SetActiveGraph(Uri graphUri)

Parameters

Type	Name	Description
System.Uri	graphUri	Graph URI.

SetDefaultGraph(IEnumerable<Uri>)

Sets the Default Graph to be the merge of the Graphs with the given URIs.

Declaration

public void SetDefaultGraph(IEnumerable<Uri> graphUris)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Uri>	graphUris	Graph URIs.

SetDefaultGraph(Uri)

Sets the Default Graph to be the Graph with the given URI.

Declaration

public void SetDefaultGraph(Uri graphUri)

Parameters

Type	Name	Description
System.Uri	graphUri	Graph URI.

Implements

ISparqlDataset

Extension Methods

Extensions.AsEnumerable<T>(T)