it.unibz.inf.ontop.protege.core

Class OBDAModel

java.lang.Object

it.unibz.inf.ontop.protege.core.OBDAModel

public class OBDAModel
extends Object

For the moment, this class always use the same factories built according to INITIAL Quest preferences. Late modified preferences are not taken into account. An OBDA model contains mapping information. An OBDA model is a container for the database and mapping declarations needed to define a Virtual ABox or Virtual RDF graph. That is, this is a manager for a collection of JDBC databases (when SQL is the native query language) and their corresponding mappings. It is used as input to any Quest instance (either OWLAPI or Sesame).

OBDAModels are also used indirectly by the Protege plugin and many other utilities including the mapping materializer (e.g. to generate ABox assertions or RDF triples from a .obda file and a database).

Constructor Summary

Constructors

Constructor and Description

OBDAModel(SQLPPMappingFactory ppMappingFactory, org.semanticweb.owlapi.formats.PrefixDocumentFormat owlPrefixManager, AtomFactory atomFactory, TermFactory termFactory, TypeFactory typeFactory, TargetAtomFactory targetAtomFactory, SubstitutionFactory substitutionFactory, org.apache.commons.rdf.api.RDF rdfFactory, TargetQueryParserFactory targetQueryParserFactory, SQLPPSourceQueryFactory sourceQueryFactory)

Method Summary

Modifier and Type	Method and Description
void	addMappingsListener(OBDAMappingListener mlistener)
void	addPrefix(String prefix, String uri)
void	addSourceListener(OBDAModelListener listener)
void	addTriplesMap(SQLPPTriplesMap triplesMap, boolean disableFiringMappingInsertedEvent)
void	addTriplesMap(URI sourceID, SQLPPTriplesMap triplesMap, boolean disableFiringMappingInsertedEvent) Deprecated.
int	changePredicateIri(org.apache.commons.rdf.api.IRI removedPredicateIri, org.apache.commons.rdf.api.IRI newPredicatIri)
TargetQueryParser	createTargetQueryParser()
TargetQueryParser	createTargetQueryParser(com.google.common.collect.ImmutableMap<String,String> prefixMap)
void	deletePredicateIRI(org.apache.commons.rdf.api.IRI removedPredicateIRI)
void	fireSourceParametersUpdated() TODO: make it private
SQLPPMapping	generatePPMapping()
AtomFactory	getAtomFactory()
MutableOntologyVocabulary	getCurrentVocabulary()
OBDADataSource	getDatasource()
com.google.common.collect.ImmutableList<SQLPPTriplesMap>	getMapping(URI sourceUri)
MutablePrefixManager	getMutablePrefixManager()
org.apache.commons.rdf.api.RDF	getRdfFactory()
SQLPPSourceQueryFactory	getSourceQueryFactory()
com.google.common.collect.ImmutableList<OBDADataSource>	getSources()
TargetAtomFactory	getTargetAtomFactory()
TermFactory	getTermFactory()
SQLPPTriplesMap	getTriplesMap(String mappingId)
TypeFactory	getTypeFactory()
int	indexOf(String mappingId)
void	parseMapping(Reader mappingReader, Properties properties)
void	removeTriplesMap(URI dataSourceURI, String mappingId)
void	reset(org.semanticweb.owlapi.formats.PrefixDocumentFormat owlPrefixMapper)
void	updateMappingId(String formerMappingId, String newMappingId)
void	updateMappingsSourceQuery(String triplesMapId, SQLPPSourceQuery sourceQuery)
void	updateTargetQueryMapping(String id, com.google.common.collect.ImmutableList<TargetAtom> targetQuery)

Methods inherited from class java.lang.Object

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

Constructor Detail

OBDAModel

public OBDAModel(SQLPPMappingFactory ppMappingFactory,
                 org.semanticweb.owlapi.formats.PrefixDocumentFormat owlPrefixManager,
                 AtomFactory atomFactory,
                 TermFactory termFactory,
                 TypeFactory typeFactory,
                 TargetAtomFactory targetAtomFactory,
                 SubstitutionFactory substitutionFactory,
                 org.apache.commons.rdf.api.RDF rdfFactory,
                 TargetQueryParserFactory targetQueryParserFactory,
                 SQLPPSourceQueryFactory sourceQueryFactory)

Method Detail

generatePPMapping

public SQLPPMapping generatePPMapping()

parseMapping

public void parseMapping(Reader mappingReader,
                         Properties properties)
                  throws DuplicateMappingException,
                         InvalidMappingException,
                         MappingIOException

Throws:

DuplicateMappingException

InvalidMappingException

MappingIOException

getMutablePrefixManager

public MutablePrefixManager getMutablePrefixManager()

getMapping

public com.google.common.collect.ImmutableList<SQLPPTriplesMap> getMapping(URI sourceUri)

getSources

public com.google.common.collect.ImmutableList<OBDADataSource> getSources()

getTriplesMap

public SQLPPTriplesMap getTriplesMap(String mappingId)

addPrefix

public void addPrefix(String prefix,
                      String uri)

changePredicateIri

public int changePredicateIri(org.apache.commons.rdf.api.IRI removedPredicateIri,
                              org.apache.commons.rdf.api.IRI newPredicatIri)

deletePredicateIRI

public void deletePredicateIRI(org.apache.commons.rdf.api.IRI removedPredicateIRI)

addSourceListener

public void addSourceListener(OBDAModelListener listener)

addMappingsListener

public void addMappingsListener(OBDAMappingListener mlistener)

fireSourceParametersUpdated

public void fireSourceParametersUpdated()

TODO: make it private

reset

public void reset(org.semanticweb.owlapi.formats.PrefixDocumentFormat owlPrefixMapper)

addTriplesMap

@Deprecated
public void addTriplesMap(URI sourceID,
                                      SQLPPTriplesMap triplesMap,
                                      boolean disableFiringMappingInsertedEvent)
                               throws DuplicateMappingException

Deprecated.

Throws:

DuplicateMappingException

addTriplesMap

public void addTriplesMap(SQLPPTriplesMap triplesMap,
                          boolean disableFiringMappingInsertedEvent)
                   throws DuplicateMappingException

Throws:

DuplicateMappingException

removeTriplesMap

public void removeTriplesMap(URI dataSourceURI,
                             String mappingId)

updateMappingsSourceQuery

public void updateMappingsSourceQuery(String triplesMapId,
                                      SQLPPSourceQuery sourceQuery)

updateTargetQueryMapping

public void updateTargetQueryMapping(String id,
                                     com.google.common.collect.ImmutableList<TargetAtom> targetQuery)

updateMappingId

public void updateMappingId(String formerMappingId,
                            String newMappingId)
                     throws DuplicateMappingException

Throws:

DuplicateMappingException

indexOf

public int indexOf(String mappingId)

getDatasource

public OBDADataSource getDatasource()

getCurrentVocabulary

public MutableOntologyVocabulary getCurrentVocabulary()

getAtomFactory

public AtomFactory getAtomFactory()

getTermFactory

public TermFactory getTermFactory()

getTypeFactory

public TypeFactory getTypeFactory()

getTargetAtomFactory

public TargetAtomFactory getTargetAtomFactory()

getRdfFactory

public org.apache.commons.rdf.api.RDF getRdfFactory()

getSourceQueryFactory

public SQLPPSourceQueryFactory getSourceQueryFactory()

createTargetQueryParser

public TargetQueryParser createTargetQueryParser()

createTargetQueryParser

public TargetQueryParser createTargetQueryParser(com.google.common.collect.ImmutableMap<String,String> prefixMap)