org.openanzo.client
Class StoredDatasetserviceDatasetProxy

java.lang.Object
  org.openanzo.client.StoredDatasetserviceDatasetProxy

All Implemented Interfaces:

IContainer, IDataset

public class StoredDatasetserviceDatasetProxy
extends java.lang.Object
implements IDataset

StoredDatasetserviceDatasetProxy is a dataset whose definition is stored in a NamedGraph. If the definition of the dataset within the NameGraph changes, the dataset is updated to reflect the changed definition. If new graphs are added to the dataset definition, those graphs will be retrieved and added to the dataset.

Author:

Matthew Roy ( mroy@cambridgesemantics.com )

Constructor Summary

StoredDatasetserviceDatasetProxy(ClosableDatasetServiceDataset parentDataset, INamedGraph datasetGraph)
Create a new StoredDatasetserviceDatasetProxy for the given dataset, with the dataset's definition stored in the datasetGraph

Method Summary

void	add(java.util.Iterator<org.openrdf.model.Statement> statements) Add a set of statements from container
void	add(org.openrdf.model.Resource subj, org.openrdf.model.URI pred, org.openrdf.model.Value obj, org.openrdf.model.Resource namedGraphUri) Add a new statement with given subj,pred,obj,context
void	add(org.openrdf.model.Statement... statements) Add one or more statements to container
void	addDefaultGraphUri(org.openrdf.model.URI uri) Add the URI of an INamedGraph to include within this dataset's default model
void	addDefaultNamedGraph(org.openrdf.model.URI uri, INamedGraph namedGraph) Add an INamedGraph with its URI to this dataset's default model
void	addNamedGraph(org.openrdf.model.URI uri, INamedGraph namedGraph) Add an INamedGraph with its URI to this dataset
void	addNamedGraphUri(org.openrdf.model.URI uri) Add the URI of an INamedGraph to include within this dataset
void	clear() Delete all statements in container
void	clear(org.openrdf.model.Resource... context) Delete all statements in container for given contexts
void	close() Disconnect container from its source and close the container Note: Once a container is closed, it is based on the source of the container's data whether or not subsequent calls to connect will return the same data
void	connect() Connect container to its source
boolean	contains(org.openrdf.model.Resource subj, org.openrdf.model.URI prop, org.openrdf.model.Value obj, org.openrdf.model.Resource... namedGraphUri) Return true if the container contains atleast 1 statement that matches the pattern of subj,prop,obj,context
boolean	contains(org.openrdf.model.Statement statement) Return true if the container contains atleast 1 statement that matches the statement provided
boolean	containsDefaultNamedGraph(org.openrdf.model.URI uri) Return if this dataset contains a INamedGraph with the given URI in the dataset's default model
boolean	containsNamedGraph(org.openrdf.model.URI uri) Return if this dataset contains a INamedGraph with the given URI
void	delete(java.util.Iterator<org.openrdf.model.Statement> statements) Delete a set of statements from container
void	delete(org.openrdf.model.Resource subj, org.openrdf.model.URI pred, org.openrdf.model.Value obj, org.openrdf.model.Resource namedGraphUri) Delete a statement from container
void	delete(org.openrdf.model.Statement... statements) Delete a set of statements from container
QueryResult	executeQuery(java.util.Set<org.openrdf.model.URI> defaultNamedGraphsIn, java.util.Set<org.openrdf.model.URI> namedGraphsIn, java.lang.String query) Execute a SPARQL query against the data within this container
QueryResult	executeQuery(java.lang.String query) Execute a SPARQL query against the data within this dataset, using the dataset's DefaultGraph and NameGraph sets
info.aduna.collections.iterators.CloseableIterator<org.openrdf.model.Statement>	find(org.openrdf.model.Resource subj, org.openrdf.model.URI prop, org.openrdf.model.Value obj, org.openrdf.model.Resource... namedGraphUri) Return an iterator over all statements that match the pattern of subj,prop,obj
info.aduna.collections.iterators.CloseableIterator<org.openrdf.model.Statement>	findAll(org.openrdf.model.Resource subj, org.openrdf.model.URI prop, org.openrdf.model.Value obj, org.openrdf.model.Resource... namedGraphUris) Return an iterator of all statements that match the pattern of subj,prop,obj Difference between find, and findall, is that with findAll, if contexts are provided, they are used to sort results, but not limit results, ie the results contains all statements that match the subj,prop,obj, with matching statements within the given contexts earlier in the iterator than statements not in the provided contexts.
java.util.Collection<org.openrdf.model.URI>	getContexts() Get the set of Context URIs that are container within this Container
int	getDefaulNamedGraphsSize() Return number of INamedGraphs within this dataset's default set
INamedGraph	getDefaultNamedGraph(org.openrdf.model.URI uri) Get the INamedGraph for the given URI if it is within this dataset's default model
java.lang.Iterable<org.openrdf.model.URI>	getDefaultNamedGraphs() Return an Iterable<URI> of the URIs for the INamedGraphs within this dataset's default model
INamedGraphEventManager	getEventManager() Return INamedGraphEventManager for this container
INamedGraph	getNamedGraph(org.openrdf.model.URI uri) Get the INamedGraph for the given URI if it is within this dataset
java.lang.Iterable<org.openrdf.model.URI>	getNamedGraphs() Return an Iterable<URI> of the URIs for the INamedGraphs within this dataset
int	getNamedGraphsSize() Return number of INamedGraphs within this dataset
info.aduna.collections.iterators.CloseableIterator<org.openrdf.model.Statement>	getStatements() Get an iterator over all statements within this container
ITransactionManager	getTransactionManager() Return ITransactionManager for this container
org.openrdf.model.URI	getURI() Get URI of IContainer
boolean	isClosed() Return if container is closed
boolean	isConnected() Return if the container is connected to its source
boolean	isEmpty() Return if container is empty
boolean	isEmpty(org.openrdf.model.Resource... context) Return if container is empty for given contexts
void	removeDefaultGraphUri(org.openrdf.model.URI uri) Remove the URI of an INamedGraph to include within this dataset's default model
void	removeNamedGraphUri(org.openrdf.model.URI uri) Remove the URI of an INamedGraph to include within this dataset
void	setEventManager(INamedGraphEventManager eventManager) Set INamedGraphEventManager for this container
void	setTransactionManager(ITransactionManager transactionManager) Set ITransactionManager for this container
int	size() Return number of statements in container
int	size(org.openrdf.model.Resource... context) Return number of statements in container

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StoredDatasetserviceDatasetProxy

public StoredDatasetserviceDatasetProxy(ClosableDatasetServiceDataset parentDataset,
                                        INamedGraph datasetGraph)

Create a new StoredDatasetserviceDatasetProxy for the given dataset, with the dataset's definition stored in the datasetGraph

Parameters:

parentDataset - dataset to wrap

datasetGraph - graph where definition is stored

Method Detail

connect

public void connect()

Description copied from interface: IContainer

Connect container to its source

Specified by:

connect in interface IContainer

isConnected

public boolean isConnected()

Description copied from interface: IContainer

Return if the container is connected to its source

Specified by:

isConnected in interface IContainer

Returns:

if the container is connected to its source

isEmpty

public boolean isEmpty()

Description copied from interface: IContainer

Return if container is empty

Specified by:

isEmpty in interface IContainer

Returns:

true if container is empty

isEmpty

public boolean isEmpty(org.openrdf.model.Resource... context)

Description copied from interface: IContainer

Return if container is empty for given contexts

Specified by:

isEmpty in interface IContainer

Parameters:

context - Contexts of statements to count

Returns:

true if container is empty

add

public void add(org.openrdf.model.Resource subj,
                org.openrdf.model.URI pred,
                org.openrdf.model.Value obj,
                org.openrdf.model.Resource namedGraphUri)

Description copied from interface: IContainer

Add a new statement with given subj,pred,obj,context

Specified by:

add in interface IContainer

Parameters:

subj - Subject of statement

pred - Predicate of statement

obj - Object of statement

namedGraphUri - Context of statement

add

public void add(org.openrdf.model.Statement... statements)

Description copied from interface: IContainer

Add one or more statements to container

Specified by:

add in interface IContainer

Parameters:

statements - statements to add to container

addDefaultGraphUri

public void addDefaultGraphUri(org.openrdf.model.URI uri)

Description copied from interface: IDataset

Add the URI of an INamedGraph to include within this dataset's default model

Specified by:

addDefaultGraphUri in interface IDataset

Parameters:

uri - URI of namedgraph to add to this dataset's default model

removeDefaultGraphUri

public void removeDefaultGraphUri(org.openrdf.model.URI uri)

Description copied from interface: IDataset

Remove the URI of an INamedGraph to include within this dataset's default model

Specified by:

removeDefaultGraphUri in interface IDataset

Parameters:

uri - URI of namedgraph to add to this dataset's default model

removeNamedGraphUri

public void removeNamedGraphUri(org.openrdf.model.URI uri)

Description copied from interface: IDataset

Remove the URI of an INamedGraph to include within this dataset

Specified by:

removeNamedGraphUri in interface IDataset

Parameters:

uri - URI of namedgraph to add to this dataset

addDefaultNamedGraph

public void addDefaultNamedGraph(org.openrdf.model.URI uri,
                                 INamedGraph namedGraph)

Description copied from interface: IDataset

Add an INamedGraph with its URI to this dataset's default model

Specified by:

addDefaultNamedGraph in interface IDataset

Parameters:

uri - URI of INamedGraph

namedGraph - INamedGraph to add to this dataset's default model

addNamedGraph

public void addNamedGraph(org.openrdf.model.URI uri,
                          INamedGraph namedGraph)

Description copied from interface: IDataset

Add an INamedGraph with its URI to this dataset

Specified by:

addNamedGraph in interface IDataset

Parameters:

uri - URI of INamedGraph

namedGraph - INamedGraph to add

addNamedGraphUri

public void addNamedGraphUri(org.openrdf.model.URI uri)

Description copied from interface: IDataset

Add the URI of an INamedGraph to include within this dataset

Specified by:

addNamedGraphUri in interface IDataset

Parameters:

uri - URI of namedgraph to add to this dataset

clear

public void clear()

Description copied from interface: IContainer

Delete all statements in container

Specified by:

clear in interface IContainer

close

public void close()

Description copied from interface: IContainer

Disconnect container from its source and close the container Note: Once a container is closed, it is based on the source of the container's data whether or not subsequent calls to connect will return the same data

Specified by:

close in interface IContainer

contains

public boolean contains(org.openrdf.model.Resource subj,
                        org.openrdf.model.URI prop,
                        org.openrdf.model.Value obj,
                        org.openrdf.model.Resource... namedGraphUri)

Description copied from interface: IContainer

Return true if the container contains atleast 1 statement that matches the pattern of subj,prop,obj,context

Specified by:

contains in interface IContainer

Parameters:

subj - Subject resource to match, or wildcard if null

prop - Predicate uri to match, or wildcard if null

obj - Object value to match, or wildcard if null

namedGraphUri - Context values to match, or wildcard if null

Returns:

true if the container contains atleast 1 statement that matches the pattern of subj,prop,obj

contains

public boolean contains(org.openrdf.model.Statement statement)

Description copied from interface: IContainer

Return true if the container contains atleast 1 statement that matches the statement provided

Specified by:

contains in interface IContainer

Parameters:

statement - Statement to check for existence in container

Returns:

true if the container contains atleast 1 statement that matches the statement provided

containsDefaultNamedGraph

public boolean containsDefaultNamedGraph(org.openrdf.model.URI uri)

Description copied from interface: IDataset

Return if this dataset contains a INamedGraph with the given URI in the dataset's default model

Specified by:

containsDefaultNamedGraph in interface IDataset

Parameters:

uri - URI of INamedGraph

Returns:

true if this dataset contains a INamedGraph with the given URI in the dataset's default model

containsNamedGraph

public boolean containsNamedGraph(org.openrdf.model.URI uri)

Description copied from interface: IDataset

Return if this dataset contains a INamedGraph with the given URI

Specified by:

containsNamedGraph in interface IDataset

Parameters:

uri - URI of INamedGraph

Returns:

true if this dataset contains a INamedGraph with the given URI

delete

public void delete(org.openrdf.model.Resource subj,
                   org.openrdf.model.URI pred,
                   org.openrdf.model.Value obj,
                   org.openrdf.model.Resource namedGraphUri)

Description copied from interface: IContainer

Delete a statement from container

Specified by:

delete in interface IContainer

Parameters:

subj - Subject resource to match, or wildcard if null

pred - Predicate uri to match, or wildcard if null

obj - Object value to match, or wildcard if null

namedGraphUri - Context values to match, or wildcard if null

delete

public void delete(org.openrdf.model.Statement... statements)

Description copied from interface: IContainer

Delete a set of statements from container

Specified by:

delete in interface IContainer

Parameters:

statements - statements to delete from container

delete

public void delete(java.util.Iterator<org.openrdf.model.Statement> statements)

Description copied from interface: IContainer

Delete a set of statements from container

Specified by:

delete in interface IContainer

Parameters:

statements - statements to delete from container

add

public void add(java.util.Iterator<org.openrdf.model.Statement> statements)

Description copied from interface: IContainer

Add a set of statements from container

Specified by:

add in interface IContainer

Parameters:

statements - statements to add to container

executeQuery

public QueryResult executeQuery(java.lang.String query)
                         throws AnzoException

Description copied from interface: IDataset

Execute a SPARQL query against the data within this dataset, using the dataset's DefaultGraph and NameGraph sets

Specified by:

executeQuery in interface IDataset

Parameters:

query - SPARQL query string

Returns:

Results of running query

Throws:

AnzoException

executeQuery

public QueryResult executeQuery(java.util.Set<org.openrdf.model.URI> defaultNamedGraphsIn,
                                java.util.Set<org.openrdf.model.URI> namedGraphsIn,
                                java.lang.String query)
                         throws AnzoException

Description copied from interface: IContainer

Execute a SPARQL query against the data within this container

Specified by:

executeQuery in interface IContainer

Parameters:

defaultNamedGraphsIn - Set<URI> of URIs for NamedGraphs that will make up the default graph for this query

namedGraphsIn - Set<URI> of URIs for NamedGraphs that will make up the NamedGraphs for this query

query - SPARQL query string

Returns:

Results of running query

Throws:

AnzoException

find

public info.aduna.collections.iterators.CloseableIterator<org.openrdf.model.Statement> find(org.openrdf.model.Resource subj,
                                                                                            org.openrdf.model.URI prop,
                                                                                            org.openrdf.model.Value obj,
                                                                                            org.openrdf.model.Resource... namedGraphUri)

Description copied from interface: IContainer

Return an iterator over all statements that match the pattern of subj,prop,obj

Specified by:

find in interface IContainer

Parameters:

subj - Subject resource to match, or wildcard if null

prop - Predicate uri to match, or wildcard if null

obj - Object value to match, or wildcard if null

namedGraphUri - Context values to match, or wildcard if null

Returns:

an iterator of all statements that match the pattern of subj,prop,obj,context

findAll

public info.aduna.collections.iterators.CloseableIterator<org.openrdf.model.Statement> findAll(org.openrdf.model.Resource subj,
                                                                                               org.openrdf.model.URI prop,
                                                                                               org.openrdf.model.Value obj,
                                                                                               org.openrdf.model.Resource... namedGraphUris)

Description copied from interface: IDataset

Return an iterator of all statements that match the pattern of subj,prop,obj Difference between find, and findall, is that with findAll, if contexts are provided, they are used to sort results, but not limit results, ie the results contains all statements that match the subj,prop,obj, with matching statements within the given contexts earlier in the iterator than statements not in the provided contexts.

Specified by:

findAll in interface IDataset

Parameters:

subj - Subject resource to match, or null for any

prop - Predicate uri to match, or null for any

obj - Object value to match, or null for any

namedGraphUris - Set of contexts to search first, before searching the rest of the dataset

Returns:

an iterator of all statements that match the pattern of subj,prop,obj

getURI

public org.openrdf.model.URI getURI()

Description copied from interface: IContainer

Get URI of IContainer

Specified by:

getURI in interface IContainer

Returns:

URI for this container

getDefaulNamedGraphsSize

public int getDefaulNamedGraphsSize()

Description copied from interface: IDataset

Return number of INamedGraphs within this dataset's default set

Specified by:

getDefaulNamedGraphsSize in interface IDataset

Returns:

number of INamedGraphs within this dataset's default set

getDefaultNamedGraph

public INamedGraph getDefaultNamedGraph(org.openrdf.model.URI uri)

Description copied from interface: IDataset

Get the INamedGraph for the given URI if it is within this dataset's default model

Specified by:

getDefaultNamedGraph in interface IDataset

Parameters:

uri - URI of INamedGraph

Returns:

the INamedGraph for the given URI if it is within this dataset's default model

getDefaultNamedGraphs

public java.lang.Iterable<org.openrdf.model.URI> getDefaultNamedGraphs()

Description copied from interface: IDataset

Return an Iterable<URI> of the URIs for the INamedGraphs within this dataset's default model

Specified by:

getDefaultNamedGraphs in interface IDataset

Returns:

an Iterable<URI> of the URIs for the INamedGraphs within this dataset's default model

getEventManager

public INamedGraphEventManager getEventManager()

Description copied from interface: IContainer

Return INamedGraphEventManager for this container

Specified by:

getEventManager in interface IContainer

Returns:

INamedGraphEventManager for this container

getNamedGraph

public INamedGraph getNamedGraph(org.openrdf.model.URI uri)

Description copied from interface: IDataset

Get the INamedGraph for the given URI if it is within this dataset

Specified by:

getNamedGraph in interface IDataset

Parameters:

uri - URI of INamedGraph

Returns:

the INamedGraph for the given URI if it is within this dataset

getNamedGraphs

public java.lang.Iterable<org.openrdf.model.URI> getNamedGraphs()

Description copied from interface: IDataset

Return an Iterable<URI> of the URIs for the INamedGraphs within this dataset

Specified by:

getNamedGraphs in interface IDataset

Returns:

an Iterable<URI> of the URIs for the INamedGraphs within this dataset

getNamedGraphsSize

public int getNamedGraphsSize()

Description copied from interface: IDataset

Return number of INamedGraphs within this dataset

Specified by:

getNamedGraphsSize in interface IDataset

Returns:

number of INamedGraphs within this dataset

getStatements

public info.aduna.collections.iterators.CloseableIterator<org.openrdf.model.Statement> getStatements()

Description copied from interface: IContainer

Get an iterator over all statements within this container

Specified by:

getStatements in interface IContainer

Returns:

CloseableIterator of all statements within this container

getTransactionManager

public ITransactionManager getTransactionManager()

Description copied from interface: IContainer

Return ITransactionManager for this container

Specified by:

getTransactionManager in interface IContainer

Returns:

ITransactionManager for this container

isClosed

public boolean isClosed()

Description copied from interface: IContainer

Return if container is closed

Specified by:

isClosed in interface IContainer

Returns:

true if container is closed

size

public int size()

Description copied from interface: IContainer

Return number of statements in container

Specified by:

size in interface IContainer

Returns:

number of statements in container

clear

public void clear(org.openrdf.model.Resource... context)

Description copied from interface: IContainer

Delete all statements in container for given contexts

Specified by:

clear in interface IContainer

Parameters:

context - Contexts to clear from container

size

public int size(org.openrdf.model.Resource... context)

Description copied from interface: IContainer

Return number of statements in container

Specified by:

size in interface IContainer

Parameters:

context - Contexts of statements to count

Returns:

number of statements in container for given contexts

setEventManager

public void setEventManager(INamedGraphEventManager eventManager)

Description copied from interface: IContainer

Set INamedGraphEventManager for this container

Specified by:

setEventManager in interface IContainer

Parameters:

eventManager - set the Containers eventManaget

setTransactionManager

public void setTransactionManager(ITransactionManager transactionManager)

Description copied from interface: IContainer

Set ITransactionManager for this container

Specified by:

setTransactionManager in interface IContainer

Parameters:

transactionManager - set ITransactionManager for this container

getContexts

public java.util.Collection<org.openrdf.model.URI> getContexts()

Description copied from interface: IContainer

Get the set of Context URIs that are container within this Container

Specified by:

getContexts in interface IContainer

Returns:

the set of Context URIs that are container within this Container