com.epimorphics.rdfutil

Class ModelWrapper

java.lang.Object

com.epimorphics.rdfutil.ModelWrapper

public class ModelWrapper
extends Object

Wrapped version of a model from a dataset. The wrapper provides uniform use of transaction/locking for safe access plus automatic prefix expansion to simplify use from scripting languages.

Author:

Dave Reynolds

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	DEFAULT_LANGUAGE
protected DatasetWrapper	dsw
protected String	language
protected com.hp.hpl.jena.rdf.model.Model	model

Constructor Summary

Constructors

Constructor and Description
ModelWrapper(DatasetWrapper dataset) Create a model wrapper around the default model of the dataset
ModelWrapper(DatasetWrapper dataset, com.hp.hpl.jena.rdf.model.Model model)
ModelWrapper(DatasetWrapper dataset, String modelname) Create a model wrapper around a named model of the dataset
ModelWrapper(com.hp.hpl.jena.rdf.model.Model model) Create a model wrapper round a simple model, creating a wrapped dataset to hold it.

Method Summary

Methods

Modifier and Type	Method and Description
String	expandPrefix(String prefix)
String	expandQuery(String query)
com.hp.hpl.jena.query.Dataset	getDataset()
DatasetWrapper	getDatasetWrapper()
String	getLanguage() Return a language code (2-letter ISO639 code) which can be used to guide choice of lexical form in e.g.
com.hp.hpl.jena.rdf.model.Model	getModel()
RDFNodeWrapper	getNode(Object spec) Return a wrapped node from this Model.
com.hp.hpl.jena.shared.PrefixMapping	getPrefixes() Return a merged prefix mapping that includes and prefixes defined for this model plus any global ones which have been registered with the dataset wapper
com.hp.hpl.jena.rdf.model.Resource	getResource(Object spec) Return a resource (not wrapped) from this Model.
List<RDFNodeWrapper>	listSubjects() Return a list of at most N subjects in this model
List<RDFNodeWrapper>	listSubjects(int N) Return a list of at most N subjects in this model
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	setLanguage(String language) Set a language code (2-letter ISO639 code) which will be used to guide choice of lexical form in e.g.
String	shortForm(String uri)
void	unlock() Unlock the dataset
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

dsw

protected DatasetWrapper dsw

model

protected com.hp.hpl.jena.rdf.model.Model model

language

protected String language

DEFAULT_LANGUAGE

protected static final String DEFAULT_LANGUAGE

See Also:

Constant Field Values

Constructor Detail

ModelWrapper

public ModelWrapper(DatasetWrapper dataset,
            com.hp.hpl.jena.rdf.model.Model model)

ModelWrapper

public ModelWrapper(DatasetWrapper dataset)

Create a model wrapper around the default model of the dataset

ModelWrapper

public ModelWrapper(DatasetWrapper dataset,
            String modelname)

Create a model wrapper around a named model of the dataset

ModelWrapper

public ModelWrapper(com.hp.hpl.jena.rdf.model.Model model)

Create a model wrapper round a simple model, creating a wrapped dataset to hold it. Uses the global default modal instance.

Method Detail

setLanguage

public void setLanguage(String language)

Set a language code (2-letter ISO639 code) which will be used to guide choice of lexical form in e.g. node.getName()

getLanguage

public String getLanguage()

Return a language code (2-letter ISO639 code) which can be used to guide choice of lexical form in e.g. node.getName()

getModel

public com.hp.hpl.jena.rdf.model.Model getModel()

getDatasetWrapper

public DatasetWrapper getDatasetWrapper()

getDataset

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

shortForm

public String shortForm(String uri)

expandPrefix

public String expandPrefix(String prefix)

getNode

public RDFNodeWrapper getNode(Object spec)

Return a wrapped node from this Model.

Parameters:

spec - can be a curie or URI for a resource, or an existing RDFNode or RDFNodeWrapper - possibly from some other model

getResource

public com.hp.hpl.jena.rdf.model.Resource getResource(Object spec)

Return a resource (not wrapped) from this Model.

Parameters:

spec - can be a curie or URI for a resource, or an existing RDFNode or RDFNodeWrapper - possibly from some other model

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

listSubjects

public List<RDFNodeWrapper> listSubjects(int N)

Return a list of at most N subjects in this model

listSubjects

public List<RDFNodeWrapper> listSubjects()

Return a list of at most N subjects in this model

getPrefixes

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

Return a merged prefix mapping that includes and prefixes defined for this model plus any global ones which have been registered with the dataset wapper

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 from model and the wrapped dataset

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 from model and the wrapped dataset

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 from model and the wrapped dataset

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 from model and the wrapped dataset

wrapResultSet

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

expandQuery

public String expandQuery(String query)