Class SparqlUpdateEvaluationContext

Evaluation Context for SPARQL Updates evaluated by the libraries Leviathan SPARQL Engine.

Inheritance

object

SparqlUpdateEvaluationContext

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: VDS.RDF.Update

Assembly: dotNetRdf.dll

Syntax

public class SparqlUpdateEvaluationContext

Constructors

SparqlUpdateEvaluationContext(ISparqlDataset, ISparqlQueryAlgebraProcessor<BaseMultiset, SparqlEvaluationContext>, LeviathanUpdateOptions)

Creates a new SPARQL Update Evaluation Context.

Declaration

public SparqlUpdateEvaluationContext(ISparqlDataset data, ISparqlQueryAlgebraProcessor<BaseMultiset, SparqlEvaluationContext> processor, LeviathanUpdateOptions options)

Parameters

Type	Name	Description
ISparqlDataset	data	SPARQL Dataset.
ISparqlQueryAlgebraProcessor<BaseMultiset, SparqlEvaluationContext>	processor	Query Processor for WHERE clauses.
LeviathanUpdateOptions	options	Update (and query) processor options.

SparqlUpdateEvaluationContext(ISparqlDataset, LeviathanUpdateOptions)

Creates a new SPARQL Update Evaluation Context.

Declaration

public SparqlUpdateEvaluationContext(ISparqlDataset data, LeviathanUpdateOptions options)

Parameters

Type	Name	Description
ISparqlDataset	data	SPARQL Dataset.
LeviathanUpdateOptions	options	Update (and query) processor options.

SparqlUpdateEvaluationContext(SparqlUpdateCommandSet, ISparqlDataset, ISparqlQueryAlgebraProcessor<BaseMultiset, SparqlEvaluationContext>, LeviathanUpdateOptions)

Creates a new SPARQL Update Evaluation Context.

Declaration

public SparqlUpdateEvaluationContext(SparqlUpdateCommandSet commands, ISparqlDataset data, ISparqlQueryAlgebraProcessor<BaseMultiset, SparqlEvaluationContext> processor, LeviathanUpdateOptions options)

Parameters

Type	Name	Description
SparqlUpdateCommandSet	commands	Command Set.
ISparqlDataset	data	SPARQL Dataset.
ISparqlQueryAlgebraProcessor<BaseMultiset, SparqlEvaluationContext>	processor	Query Processor for WHERE clauses.
LeviathanUpdateOptions	options	Update (and query) processor options.

SparqlUpdateEvaluationContext(SparqlUpdateCommandSet, ISparqlDataset, LeviathanUpdateOptions)

Creates a new SPARQL Update Evaluation Context.

Declaration

public SparqlUpdateEvaluationContext(SparqlUpdateCommandSet commands, ISparqlDataset data, LeviathanUpdateOptions options)

Parameters

Type	Name	Description
SparqlUpdateCommandSet	commands	Command Set.
ISparqlDataset	data	SPARQL Dataset.
LeviathanUpdateOptions	options	Update (and query) processor options.

Properties

Commands

Gets the Command Set (if any) that this context pertains to.

Declaration

public SparqlUpdateCommandSet Commands { get; }

Property Value

Type	Description
SparqlUpdateCommandSet

Data

Dataset upon which the Updates are applied.

Declaration

public ISparqlDataset Data { get; }

Property Value

Type	Description
ISparqlDataset

Options

Get the processor options for this context.

Declaration

public LeviathanUpdateOptions Options { get; }

Property Value

Type	Description
LeviathanUpdateOptions

QueryProcessor

Gets the Query Processor used to process the WHERE clauses of DELETE or INSERT commands.

Declaration

public ISparqlQueryAlgebraProcessor<BaseMultiset, SparqlEvaluationContext> QueryProcessor { get; }

Property Value

Type	Description
ISparqlQueryAlgebraProcessor<BaseMultiset, SparqlEvaluationContext>

RemainingTimeout

Gets the Remaining Timeout i.e. the Timeout taking into account time already elapsed.

Declaration

public long RemainingTimeout { get; }

Property Value

Type	Description
long

Remarks

If there is no timeout then this is always zero, if there is a timeout this is always >= 1 since any operation that wants to respect the timeout must have a non-zero timeout to actually timeout properly.

UpdateTime

Retrieves the Time in milliseconds the update took to evaluate.

Declaration

public long UpdateTime { get; }

Property Value

Type	Description
long

UpdateTimeTicks

Retrieves the Time in ticks the updates took to evaluate.

Declaration

public long UpdateTimeTicks { get; }

Property Value

Type	Description
long

UpdateTimeout

Gets the Update Timeout used for the Command Set.

Declaration

public long UpdateTimeout { get; }

Property Value

Type	Description
long

Remarks

This is taken either from the Timeout property of the SparqlUpdateCommandSet to which this evaluation context pertains, or from the processor-defined option UpdateExecutionTimeout. To set the Timeout to be used set whichever of those is appropriate prior to evaluating the updates. If there is a Command Set present then it's timeout takes precedence unless it is set to zero (no timeout) in which case the processor-defined timeout setting is applied. You cannot set the Update Timeout to be higher than the processor-defined timeout unless the processor-defined timeout is set to zero (i.e. no global timeout).

Methods

CheckTimeout()

Checks whether Execution should Time out.

Declaration

public void CheckTimeout()

Exceptions

Type	Condition
SparqlUpdateTimeoutException	Thrown if the Update has exceeded the Execution Timeout.

EndExecution()

Ends the Execution Timer.

Declaration

public void EndExecution()

StartExecution()

Starts the Execution Timer.

Declaration

public void StartExecution()

Extension Methods

Extensions.ToSafeString(object)

Extensions.AsEnumerable<T>(T)