Class BaseAsyncSafeConnector

Abstract Base Class for IStorageProvider implementations for which it is safe to do the IAsyncStorageProvider implementation simply by farming out calls to the synchronous methods onto background threads (i.e. non-HTTP based connectors).

Inheritance

System.Object

BaseAsyncSafeConnector

DatasetFileManager

InMemoryManager

Implements

IStorageProvider

IAsyncStorageProvider

IStorageCapabilities

System.IDisposable

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: VDS.RDF.Storage

Assembly: dotNetRdf.dll

Syntax

public abstract class BaseAsyncSafeConnector : IStorageProvider, IAsyncStorageProvider, IStorageCapabilities, IDisposable

Properties

AsyncParentServer

Gets the parent server (if any).

Declaration

public virtual IAsyncStorageServer AsyncParentServer { get; }

Property Value

Type	Description
IAsyncStorageServer

DeleteSupported

Gets whether the Store supports Graph deletion via the DeleteGraph() method.

Declaration

public abstract bool DeleteSupported { get; }

Property Value

Type	Description
System.Boolean

IOBehaviour

Gets the IO Behaviour of the Store.

Declaration

public abstract IOBehaviour IOBehaviour { get; }

Property Value

Type	Description
IOBehaviour

IsReadOnly

Gets whether the Store is read only.

Declaration

public abstract bool IsReadOnly { get; }

Property Value

Type	Description
System.Boolean

IsReady

Indicates whether the Store is ready to accept requests.

Declaration

public abstract bool IsReady { get; }

Property Value

Type	Description
System.Boolean

ListGraphsSupported

Gets whether the Store supports listing graphs via the ListGraphs() method.

Declaration

public abstract bool ListGraphsSupported { get; }

Property Value

Type	Description
System.Boolean

ParentServer

Gets the parent server (if any).

Declaration

public virtual IStorageServer ParentServer { get; }

Property Value

Type	Description
IStorageServer

UpdateSupported

Gets whether the Store supports Triple level updates via the UpdateGraph() method.

Declaration

public abstract bool UpdateSupported { get; }

Property Value

Type	Description
System.Boolean

UriFactory

Get or set the URI factory for the connector to use.

Declaration

public virtual IUriFactory UriFactory { get; set; }

Property Value

Type	Description
IUriFactory

Methods

DeleteGraph(string, AsyncStorageCallback, object)

Deletes a Graph from the Store.

Declaration

public void DeleteGraph(string graphUri, AsyncStorageCallback callback, object state)

Parameters

Type	Name	Description
string	graphUri	URI of the Graph to delete.
AsyncStorageCallback	callback	Callback.
System.Object	state	State to pass to the callback.

DeleteGraph(string)

Deletes a Graph from the Store.

Declaration

public abstract void DeleteGraph(string graphUri)

Parameters

Type	Name	Description
string	graphUri	URI of the Graph to delete.

DeleteGraph(Uri, AsyncStorageCallback, object)

Deletes a Graph from the Store.

Declaration

public void DeleteGraph(Uri graphUri, AsyncStorageCallback callback, object state)

Parameters

Type	Name	Description
System.Uri	graphUri	URI of the Graph to delete.
AsyncStorageCallback	callback	Callback.
System.Object	state	State to pass to the callback.

DeleteGraph(Uri)

Deletes a Graph from the Store.

Declaration

public abstract void DeleteGraph(Uri graphUri)

Parameters

Type	Name	Description
System.Uri	graphUri	URI of the Graph to delete.

DeleteGraphAsync(string, CancellationToken)

Deletes a graph from the store asynchronously.

Declaration

public Task DeleteGraphAsync(string graphName, CancellationToken cancellationToken)

Parameters

Type	Name	Description
string	graphName	Name of the graph to delete.
System.Threading.CancellationToken	cancellationToken

Returns

Type	Description
System.Threading.Tasks.Task

Dispose()

Disposes of the Store.

Declaration

public abstract void Dispose()

ListGraphNames()

Gets an enumeration of the names of the graphs in the store.

Declaration

public abstract IEnumerable<string> ListGraphNames()

Returns

Type	Description
System.Collections.Generic.IEnumerable<T><string>

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.

ListGraphs()

Lists the Graphs in the Store.

Declaration

[Obsolete("Replaced by ListGraphNames")]
public abstract IEnumerable<Uri> ListGraphs()

Returns

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

ListGraphs(AsyncStorageCallback, object)

Lists the Graphs in the Store asynchronously.

Declaration

[Obsolete("Replaced with ListGraphsAsync(CancellationToken)")]
public void ListGraphs(AsyncStorageCallback callback, object state)

Parameters

Type	Name	Description
AsyncStorageCallback	callback	Callback.
System.Object	state	State to pass to the callback.

ListGraphsAsync(CancellationToken)

Lists the names of the graphs in the store asynchronously.

Declaration

public Task<IEnumerable<string>> ListGraphsAsync(CancellationToken cancellationToken)

Parameters

Type	Name	Description
System.Threading.CancellationToken	cancellationToken

Returns

Type	Description
System.Threading.Tasks.Task<TResult><System.Collections.Generic.IEnumerable<T><string>>

LoadGraph(IGraph, string, AsyncStorageCallback, object)

Loads a Graph from the Store asynchronously.

Declaration

public void LoadGraph(IGraph g, string graphUri, AsyncStorageCallback callback, object state)

Parameters

Type	Name	Description
IGraph	g	Graph to load into.
string	graphUri	URI of the Graph to load.
AsyncStorageCallback	callback	Callback.
System.Object	state	State to pass to the callback.

LoadGraph(IGraph, string)

Loads a Graph from the Store.

Declaration

public abstract void LoadGraph(IGraph g, string graphUri)

Parameters

Type	Name	Description
IGraph	g	Graph to load into.
string	graphUri	URI of the Graph to load.

LoadGraph(IGraph, Uri, AsyncStorageCallback, object)

Loads a Graph from the Store asynchronously.

Declaration

public void LoadGraph(IGraph g, Uri graphUri, AsyncStorageCallback callback, object state)

Parameters

Type	Name	Description
IGraph	g	Graph to load into.
System.Uri	graphUri	URI of the Graph to load.
AsyncStorageCallback	callback	Callback.
System.Object	state	State to pass to the callback.

LoadGraph(IGraph, Uri)

Loads a Graph from the Store.

Declaration

public abstract 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.

LoadGraph(IRdfHandler, string, AsyncStorageCallback, object)

Loads a Graph from the Store asynchronously.

Declaration

public void LoadGraph(IRdfHandler handler, string graphUri, AsyncStorageCallback callback, object state)

Parameters

Type	Name	Description
IRdfHandler	handler	Handler to load with.
string	graphUri	URI of the Graph to load.
AsyncStorageCallback	callback	Callback.
System.Object	state	State to pass to the callback.

LoadGraph(IRdfHandler, string)

Loads a Graph from the Store.

Declaration

public abstract void LoadGraph(IRdfHandler handler, string graphUri)

Parameters

Type	Name	Description
IRdfHandler	handler	Handler to load with.
string	graphUri	URI of the Graph to load.

LoadGraph(IRdfHandler, Uri, AsyncStorageCallback, object)

Loads a Graph from the Store asynchronously.

Declaration

public void LoadGraph(IRdfHandler handler, Uri graphUri, AsyncStorageCallback callback, object state)

Parameters

Type	Name	Description
IRdfHandler	handler	Handler to load with.
System.Uri	graphUri	URI of the Graph to load.
AsyncStorageCallback	callback	Callback.
System.Object	state	State to pass to the callback.

LoadGraph(IRdfHandler, Uri)

Loads a Graph from the Store.

Declaration

public abstract void LoadGraph(IRdfHandler handler, Uri graphUri)

Parameters

Type	Name	Description
IRdfHandler	handler	Handler to load with.
System.Uri	graphUri	URI of the Graph to load.

LoadGraphAsync(IGraph, string, CancellationToken)

Loads a graph from the store asynchronously.

Declaration

public Task LoadGraphAsync(IGraph g, string graphUri, CancellationToken cancellationToken)

Parameters

Type	Name	Description
IGraph	g	The target graph to load into.
string	graphUri
System.Threading.CancellationToken	cancellationToken

Returns

Type	Description
System.Threading.Tasks.Task

LoadGraphAsync(IRdfHandler, string, CancellationToken)

Loads a graph from the store asynchronously.

Declaration

public Task LoadGraphAsync(IRdfHandler handler, string graphUri, CancellationToken cancellationToken)

Parameters

Type	Name	Description
IRdfHandler	handler	The handler to receive the loaded triples.
string	graphUri
System.Threading.CancellationToken	cancellationToken

Returns

Type	Description
System.Threading.Tasks.Task

SaveGraph(IGraph, AsyncStorageCallback, object)

Saves a Graph to the Store asynchronously.

Declaration

public void SaveGraph(IGraph g, AsyncStorageCallback callback, object state)

Parameters

Type	Name	Description
IGraph	g	Graph to save.
AsyncStorageCallback	callback	Callback.
System.Object	state	State to pass to the callback.

SaveGraph(IGraph)

Saves a Graph to the Store.

Declaration

public abstract void SaveGraph(IGraph g)

Parameters

Type	Name	Description
IGraph	g	Graph to save.

SaveGraphAsync(IGraph, CancellationToken)

Saves a Graph to the Store asynchronously.

Declaration

public Task SaveGraphAsync(IGraph g, CancellationToken cancellationToken)

Parameters

Type	Name	Description
IGraph	g	Graph to save.
System.Threading.CancellationToken	cancellationToken

Returns

Type	Description
System.Threading.Tasks.Task

UpdateGraph(string, IEnumerable<Triple>, IEnumerable<Triple>, AsyncStorageCallback, object)

Updates a Graph in the Store asynchronously.

Declaration

public void UpdateGraph(string graphUri, IEnumerable<Triple> additions, IEnumerable<Triple> removals, AsyncStorageCallback callback, object state)

Parameters

Type	Name	Description
string	graphUri	URI of the Graph to update.
System.Collections.Generic.IEnumerable<T><Triple>	additions	Triples to be added.
System.Collections.Generic.IEnumerable<T><Triple>	removals	Triples to be removed.
AsyncStorageCallback	callback	Callback.
System.Object	state	State to pass to the callback.

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

Updates a Graph in the Store.

Declaration

public abstract void UpdateGraph(string graphUri, IEnumerable<Triple> additions, IEnumerable<Triple> removals)

Parameters

Type	Name	Description
string	graphUri	URI of the Graph to update.
System.Collections.Generic.IEnumerable<T><Triple>	additions	Triples to be added.
System.Collections.Generic.IEnumerable<T><Triple>	removals	Triples to be removed.

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

Updates a Graph in the Store asynchronously.

Declaration

public void UpdateGraph(Uri graphUri, IEnumerable<Triple> additions, IEnumerable<Triple> removals, AsyncStorageCallback callback, object state)

Parameters

Type	Name	Description
System.Uri	graphUri	URI of the Graph to update.
System.Collections.Generic.IEnumerable<T><Triple>	additions	Triples to be added.
System.Collections.Generic.IEnumerable<T><Triple>	removals	Triples to be removed.
AsyncStorageCallback	callback	Callback.
System.Object	state	State to pass to the callback.

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

Updates a Graph in the Store.

Declaration

public abstract 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<T><Triple>	additions	Triples to be added.
System.Collections.Generic.IEnumerable<T><Triple>	removals	Triples to be removed.

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

Updates a Graph in the Store.

Declaration

public abstract void UpdateGraph(IRefNode graphName, IEnumerable<Triple> additions, IEnumerable<Triple> removals)

Parameters

Type	Name	Description
IRefNode	graphName	Name of the Graph to update.
System.Collections.Generic.IEnumerable<T><Triple>	additions	Triples to be added.
System.Collections.Generic.IEnumerable<T><Triple>	removals	Triples to be removed.

UpdateGraphAsync(string, IEnumerable<Triple>, IEnumerable<Triple>, CancellationToken)

Updates a graph in the store asynchronously.

Declaration

public Task UpdateGraphAsync(string graphName, IEnumerable<Triple> additions, IEnumerable<Triple> removals, CancellationToken cancellationToken)

Parameters

Type	Name	Description
string	graphName	Name of the graph to update.
System.Collections.Generic.IEnumerable<T><Triple>	additions	Triples to be added.
System.Collections.Generic.IEnumerable<T><Triple>	removals	Triples to be removed.
System.Threading.CancellationToken	cancellationToken

Returns

Type	Description
System.Threading.Tasks.Task

Implements

IStorageProvider

IAsyncStorageProvider

IStorageCapabilities

System.IDisposable

Extension Methods

Extensions.ToSafeString(object)

Extensions.AsEnumerable<T>(T)