com.epimorphics.rdfutil

Class DatasetWrapper

java.lang.Object

com.epimorphics.rdfutil.DatasetWrapper

public class DatasetWrapper
extends Object

Wrap up a dataset to support script-friendly access. See ModelWrapper and RDFNodeWrapper for the more interesting functionality.

Author:

Dave Reynolds

Field Summary

Fields

Modifier and Type	Field and Description
protected com.hp.hpl.jena.query.Dataset	dataset
protected boolean	inWrite
protected com.hp.hpl.jena.shared.PrefixMapping	prefixes
static String	TDB_UNION_GRAPH_NAME
protected boolean	unionDefault

Constructor Summary

Constructors

Constructor and Description
DatasetWrapper(com.hp.hpl.jena.query.Dataset dataset)
DatasetWrapper(com.hp.hpl.jena.query.Dataset dataset, boolean unionDefault)
DatasetWrapper(com.hp.hpl.jena.query.Dataset dataset, boolean unionDefault, com.hp.hpl.jena.shared.PrefixMapping prefixes)

Method Summary

Methods

Modifier and Type	Method and Description
void	abort() Unlock the dataset, aborting the transaction.
protected String	expandQuery(String query)
com.hp.hpl.jena.query.Dataset	getDataset()
ModelWrapper	getDefaultModelW() Get the default graph as a Jena Model
ModelWrapper	getNamedModelW(String uri) Get a graph by name as a Jena Model
com.hp.hpl.jena.shared.PrefixMapping	getPrefixes()
boolean	getUnionDefault()
void	lock() Lock the dataset for reading
void	lockWrite() Lock the dataset for write
boolean	queryAsk(String query) Thread/transaction safe ask query.
ModelWrapper	queryConstruct(String query) Thread/transaction safe construct query.
com.hp.hpl.jena.query.ResultSetRewindable	querySelect(String query) Thread/transaction safe select query.
List<Map<String,RDFNodeWrapper>>	querySelectW(String query) Thread/transaction safe select query returning wrapped bindings.
void	setPrefixes(com.hp.hpl.jena.shared.PrefixMapping prefixes) Provide a prefix mapping for short names that will augment any per-model prefixes when used from the wrapper APIs.
void	setUnionDefault(boolean unionDefault) If the unionDefault flag is set to try then getDefaultModel will attempt to use the union model from the dataset and SPARQL queries will be issued with unionDefaultGraph set to true.
void	unlock() Unlock the dataset
protected List<Map<String,RDFNodeWrapper>>	wrapResultSet(com.hp.hpl.jena.query.ResultSet rs)

Methods inherited from class java.lang.Object

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

Field Detail

TDB_UNION_GRAPH_NAME

public static final String TDB_UNION_GRAPH_NAME

See Also:

Constant Field Values

dataset

protected com.hp.hpl.jena.query.Dataset dataset

inWrite

protected boolean inWrite

unionDefault

protected boolean unionDefault

prefixes

protected com.hp.hpl.jena.shared.PrefixMapping prefixes

Constructor Detail

DatasetWrapper

public DatasetWrapper(com.hp.hpl.jena.query.Dataset dataset,
              boolean unionDefault,
              com.hp.hpl.jena.shared.PrefixMapping prefixes)

DatasetWrapper

public DatasetWrapper(com.hp.hpl.jena.query.Dataset dataset,
              boolean unionDefault)

DatasetWrapper

public DatasetWrapper(com.hp.hpl.jena.query.Dataset dataset)

Method Detail

setUnionDefault

public void setUnionDefault(boolean unionDefault)

If the unionDefault flag is set to try then getDefaultModel will attempt to use the union model from the dataset and SPARQL queries will be issued with unionDefaultGraph set to true. Only meaningful for TDB-backed datasets.

getUnionDefault

public boolean getUnionDefault()

setPrefixes

public void setPrefixes(com.hp.hpl.jena.shared.PrefixMapping prefixes)

Provide a prefix mapping for short names that will augment any per-model prefixes when used from the wrapper APIs. Useful for simplify sparql queries and node link following.

getPrefixes

public com.hp.hpl.jena.shared.PrefixMapping getPrefixes()

getDefaultModelW

public ModelWrapper getDefaultModelW()

Get the default graph as a Jena Model

getNamedModelW

public ModelWrapper getNamedModelW(String uri)

Get a graph by name as a Jena Model

getDataset

public com.hp.hpl.jena.query.Dataset getDataset()

lock

public void lock()

Lock the dataset for reading

lockWrite

public void lockWrite()

Lock the dataset for write

unlock

public void unlock()

Unlock the dataset

abort

public void abort()

Unlock the dataset, aborting the transaction. Only useful if the dataset is transactional

querySelect

public com.hp.hpl.jena.query.ResultSetRewindable querySelect(String query)

Thread/transaction safe select query.

Parameters:

query - query string to which query prefixes will be added if available

Returns:

memory copy of the result set

queryAsk

public boolean queryAsk(String query)

Thread/transaction safe ask query.

Parameters:

query - query string to which query prefixes will be added if available

Returns:

result of aks

queryConstruct

public ModelWrapper queryConstruct(String query)

Thread/transaction safe construct query.

Parameters:

query - query string to which query prefixes will be added if available

Returns:

constructed in-memory model

querySelectW

public List<Map<String,RDFNodeWrapper>> querySelectW(String query)

Thread/transaction safe select query returning wrapped bindings.

Parameters:

query - query string to which query prefixes will be added if available

wrapResultSet

protected List<Map<String,RDFNodeWrapper>> wrapResultSet(com.hp.hpl.jena.query.ResultSet rs)

expandQuery

protected String expandQuery(String query)