it.uniroma2.art.owlart.models

Interface RDFModel

All Superinterfaces:

ARTNodeFactory, BaseRDFTripleModel, PrefixMapping, RDFSerializer, SPARQLQueryModel, TripleQueryModel

All Known Subinterfaces:

DirectReasoning, OWLModel, RDFSModel, SKOSModel, SKOSXLModel

All Known Implementing Classes:

OWLModelImpl, RDFModelImpl, RDFSModelImpl, SKOSModelImpl, SKOSXLModelImpl

public interface RDFModel
extends BaseRDFTripleModel, SPARQLQueryModel

Interface for basic RDF models
Also, contains extensions to the TripleQueryModel which allows for more flexible management of query parameters

Author:

Armando Stellato

Method Summary

Methods

Modifier and Type	Method and Description
void	addInstance(String uri, ARTResource cls, ARTResource... graphs) adds a resource with uri=uri to the specified graphs The resource is automatically typized with class cls
void	addProperty(String propertyURI, ARTURIResource superProperty, ARTResource... graphs) adds a resource with uri=propertyURI as an rdf:Property The new property is defined as subproperty of suprtProperty (unless this last is null)
void	addType(ARTResource res, ARTResource cls, ARTResource... graphs) adds a type to resource res
void	deleteProperty(ARTURIResource property, ARTResource... graphs) deletes a property
void	deleteResource(ARTResource resource, ARTResource... graphs) remove resource and all information about it from graphs graphs
boolean	existsResource(ARTResource res, ARTResource... graphs)
boolean	hasType(ARTResource res, ARTResource type, boolean inferred, ARTResource... graphs) checks if resource type is a type for resource res
void	instantiatePropertyWithPlainLiteral(ARTResource subject, ARTURIResource predicate, String value, ARTResource... graphs) creates a triple for the given subject, predicate and value by using a plain literal with no language tag as the object
void	instantiatePropertyWithPlainLiteral(ARTResource subject, ARTURIResource predicate, String value, String lang, ARTResource... graphs) creates a triple for the given subject, predicate and value by using a plain literal with a language tag as the object
void	instantiatePropertyWithResource(ARTResource subject, ARTURIResource predicate, ARTResource object, ARTResource... graphs) creates a triple for the given subject, predicate and object just a mere rewriting of addTriple with the object constrained to be a Resource
void	instantiatePropertyWithTypedLiteral(ARTResource subject, ARTURIResource property, String value, ARTURIResource datatype, ARTResource... graphs) creates a triple for the given subject, predicate and object, which is described by its label (value) and (datatype)
boolean	isLocallyDefined(ARTResource res, ARTResource... graphs) Checks whether there exists an explicit triple in any of the provided graphs the subject of which is the provided resource res.
boolean	isProperty(ARTResource prop, ARTResource... graphs) checks that resource prop is a property If available, reasoning is activated by default, so all kind of properties should be properly checked by this method
ARTResourceIterator	listInstances(ARTResource type, boolean inferred, ARTResource... graphs) retrieves all instances of class type
ARTURIResourceIterator	listNamedInstances(ARTResource... graphs)
ARTURIResourceIterator	listProperties(ARTResource... graphs) list all properties declared in graphs graphs If available, reasoning is activated by default, so all kind of properties should be returned by this method
ARTResourceIterator	listTypes(ARTResource res, boolean inferred, ARTResource... graphs) retrieves all classes which are types for resource res
void	removeType(ARTResource res, ARTResource cls, ARTResource... graphs) removes the rdf:type relationship between res and cls
void	renameProperty(ARTURIResource res, String newLocalName, ARTResource... graphs) renames a property (shortcut for renameResource(ARTURIResource, String, ARTResource...), as a property has no restriction on where it can appear inside a triple)
void	renameResource(ARTURIResource res, String newURI, ARTResource... graphs) renames a resource
ARTBNode	retrieveBNode(String ID, ARTResource... graphs) Contract for this method is: If there exist a triple in the specified graphs graphs where a blank node with id= ID is mentioned, then return that blank node, otherwise return null
ARTURIResource	retrieveURIResource(String uri, ARTResource... graphs) Contract for this method is: If there exist a triple in the specified graphs graphs where a resource with uri= uri is mentioned, then return that resource, otherwise return null

Methods inherited from interface it.uniroma2.art.owlart.models.BaseRDFTripleModel

addRDF, addRDF, addStatement, addTriple, clearRDF, close, deleteStatement, deleteTriple, getBaseURI, getDefaultNamespace, hasStatement, hasTriple, listNamedGraphs, listNamespaces, listPredicatesOfSubjObjPair, listStatements, listSubjectsOfPredObjPair, listValuesOfSubjPredPair, setBaseURI, setDefaultNamespace, writeRDF, writeRDF

Methods inherited from interface it.uniroma2.art.owlart.models.PrefixMapping

expandQName, getNamespacePrefixMapping, getNSForPrefix, getPrefixForNS, getQName, removeNsPrefixMapping, setNsPrefix

Methods inherited from interface it.uniroma2.art.owlart.model.ARTNodeFactory

createBNode, createBNode, createLiteral, createLiteral, createLiteral, createStatement, createURIResource

Methods inherited from interface it.uniroma2.art.owlart.io.RDFSerializer

writeRDF, writeRDF

Methods inherited from interface it.uniroma2.art.owlart.models.SPARQLQueryModel

createBooleanQuery, createBooleanQuery, createBooleanQuery, createGraphQuery, createGraphQuery, createGraphQuery, createQuery, createQuery, createQuery, createTupleQuery, createTupleQuery, createTupleQuery, createUpdateQuery, createUpdateQuery, createUpdateQuery

Methods inherited from interface it.uniroma2.art.owlart.models.TripleQueryModel

createBooleanQuery, createGraphQuery, createQuery, createTupleQuery, createUpdate

Method Detail

addInstance

void addInstance(String uri,
               ARTResource cls,
               ARTResource... graphs)
                 throws ModelUpdateException

adds a resource with uri=uri to the specified graphs
The resource is automatically typized with class cls

Parameters:

uri -

cls -

graphs -

Throws:

ModelUpdateException

addProperty

void addProperty(String propertyURI,
               ARTURIResource superProperty,
               ARTResource... graphs)
                 throws ModelUpdateException

adds a resource with uri=propertyURI as an rdf:Property
The new property is defined as subproperty of suprtProperty (unless this last is null)

Parameters:

propertyURI -

superProperty -

graphs -

Throws:

ModelUpdateException

addType

void addType(ARTResource res,
           ARTResource cls,
           ARTResource... graphs)
             throws ModelUpdateException

adds a type to resource res

Parameters:

res -

cls -

graphs -

Throws:

ModelUpdateException

instantiatePropertyWithPlainLiteral

void instantiatePropertyWithPlainLiteral(ARTResource subject,
                                       ARTURIResource predicate,
                                       String value,
                                       ARTResource... graphs)
                                         throws ModelUpdateException

creates a triple for the given subject, predicate and value
by using a plain literal with no language tag as the object

Parameters:

subject -

predicate -

value -

graphs -

Throws:

ModelUpdateException

instantiatePropertyWithPlainLiteral

void instantiatePropertyWithPlainLiteral(ARTResource subject,
                                       ARTURIResource predicate,
                                       String value,
                                       String lang,
                                       ARTResource... graphs)
                                         throws ModelUpdateException

creates a triple for the given subject, predicate and value
by using a plain literal with a language tag as the object

Parameters:

subject -

predicate -

value -

graphs -

Throws:

ModelUpdateException

instantiatePropertyWithTypedLiteral

void instantiatePropertyWithTypedLiteral(ARTResource subject,
                                       ARTURIResource property,
                                       String value,
                                       ARTURIResource datatype,
                                       ARTResource... graphs)
                                         throws ModelUpdateException

creates a triple for the given subject, predicate and object, which is described by its label (value) and (datatype)

Parameters:

subject -

property -

value -

lang -

Throws:

ModelUpdateException

instantiatePropertyWithResource

void instantiatePropertyWithResource(ARTResource subject,
                                   ARTURIResource predicate,
                                   ARTResource object,
                                   ARTResource... graphs)
                                     throws ModelUpdateException

creates a triple for the given subject, predicate and object
just a mere rewriting of addTriple with the object constrained to be a Resource

Parameters:

subject -

predicate -

object -

graphs -

Throws:

ModelUpdateException

listProperties

ARTURIResourceIterator listProperties(ARTResource... graphs)
                                      throws ModelAccessException

list all properties declared in graphs graphs
If available, reasoning is activated by default, so all kind of properties should be returned by this method

Parameters:

graphs -

Returns:

Throws:

ModelAccessException

retrieveURIResource

ARTURIResource retrieveURIResource(String uri,
                                 ARTResource... graphs)
                                   throws ModelAccessException

Contract for this method is:
If there exist a triple in the specified graphs graphs where a resource with uri= uri is mentioned, then return that resource, otherwise return null

Parameters:

uri -

graphs -

Returns:

Throws:

ModelAccessException

isLocallyDefined

boolean isLocallyDefined(ARTResource res,
                       ARTResource... graphs)
                         throws ModelAccessException

Checks whether there exists an explicit triple in any of the provided graphs the subject of which is the provided resource res.

Parameters:

res -

graphs -

Returns:

Throws:

ModelAccessException

existsResource

boolean existsResource(ARTResource res,
                     ARTResource... graphs)
                       throws ModelAccessException

Parameters:

res -

graphs -

Returns:

Throws:

ModelAccessException

retrieveBNode

ARTBNode retrieveBNode(String ID,
                     ARTResource... graphs)
                       throws ModelAccessException

Contract for this method is:
If there exist a triple in the specified graphs graphs where a blank node with id= ID is mentioned, then return that blank node, otherwise return null

Parameters:

uri -

graphs -

Returns:

Throws:

ModelAccessException

listTypes

ARTResourceIterator listTypes(ARTResource res,
                            boolean inferred,
                            ARTResource... graphs)
                              throws ModelAccessException

retrieves all classes which are types for resource res

Parameters:

res -

inferred -

graphs -

Returns:

Throws:

ModelAccessException

listInstances

ARTResourceIterator listInstances(ARTResource type,
                                boolean inferred,
                                ARTResource... graphs)
                                  throws ModelAccessException

retrieves all instances of class type

Parameters:

type -

inferred -

graphs -

Returns:

Throws:

ModelAccessException

listNamedInstances

ARTURIResourceIterator listNamedInstances(ARTResource... graphs)
                                          throws ModelAccessException

Throws:

ModelAccessException

hasType

boolean hasType(ARTResource res,
              ARTResource type,
              boolean inferred,
              ARTResource... graphs)
                throws ModelAccessException

checks if resource type is a type for resource res

Parameters:

res -

type -

inferred -

graphs -

Returns:

Throws:

ModelAccessException

removeType

void removeType(ARTResource res,
              ARTResource cls,
              ARTResource... graphs)
                throws ModelUpdateException

removes the rdf:type relationship between res and cls

Parameters:

res -

cls -

graphs -

Throws:

ModelUpdateException

isProperty

boolean isProperty(ARTResource prop,
                 ARTResource... graphs)
                   throws ModelAccessException

checks that resource prop is a property
If available, reasoning is activated by default, so all kind of properties should be properly checked by this method

Parameters:

prop -

graphs -

Returns:

Throws:

ModelAccessException

deleteResource

void deleteResource(ARTResource resource,
                  ARTResource... graphs)
                    throws ModelUpdateException

remove resource and all information about it from graphs graphs

Parameters:

resource -

graphs -

Throws:

ModelUpdateException

deleteProperty

void deleteProperty(ARTURIResource property,
                  ARTResource... graphs)
                    throws ModelUpdateException

deletes a property

Parameters:

individual -

graphs -

Throws:

ModelUpdateException

renameResource

void renameResource(ARTURIResource res,
                  String newURI,
                  ARTResource... graphs)
                    throws ModelUpdateException

renames a resource

Parameters:

res -

newURI -

Throws:

ModelUpdateException

renameProperty

void renameProperty(ARTURIResource res,
                  String newLocalName,
                  ARTResource... graphs)
                    throws ModelUpdateException

renames a property (shortcut for renameResource(ARTURIResource, String, ARTResource...), as a property has no restriction on where it can appear inside a triple)

Parameters:

res -

newLocalName -

Throws:

ModelUpdateException