|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
An enhanced view of a Jena model that is known to contain ontology
data, under a given ontology vocabulary
(such as OWL).
This class does not by itself compute the deductive extension of the graph
under the semantic rules of the language. Instead, we wrap an underlying
model with this ontology interface, that presents a convenience syntax for accessing
the language elements. Depending on the inference capability of the underlying model,
the OntModel will appear to contain more or less triples. For example, if
this class is used to wrap a plain memory or database model, only the
relationships asserted by the document will be reported through this
convenience API. Alternatively, if the OntModel wraps an OWL inferencing model,
the inferred triples from the extension will be reported as well. For
example, assume the following ontology fragment:
In a non-inferencing model, the
:A rdf:type owl:Class .
:B rdf:type owl:Class ; rdfs:subClassOf :A .
:widget rdf:type :B .
rdf:type
of the widget will be
reported as class :B
only. In a model that can process the OWL
semantics, the widget's types will include :B
, :A
,
and owl:Thing
.
Nested Class Summary |
Nested classes inherited from class com.hp.hpl.jena.shared.PrefixMapping |
com.hp.hpl.jena.shared.PrefixMapping.Factory, com.hp.hpl.jena.shared.PrefixMapping.IllegalPrefixException, com.hp.hpl.jena.shared.PrefixMapping.JenaLockedException |
Field Summary |
Fields inherited from interface com.hp.hpl.jena.shared.PrefixMapping |
Standard |
Fields inherited from interface com.hp.hpl.jena.rdf.model.ModelLock |
READ, WRITE |
Method Summary | |
void |
addLoadedImport(java.lang.String uri)
Record that this model has now imported the document with the given URI, so that it will not be re-imported in the future. |
void |
addSubModel(Model model)
Add the given model as one of the sub-models of the enclosed ontology union model. |
void |
addSubModel(Model model,
boolean rebind)
Add the given model as one of the sub-models of the enclosed ontology union model. |
AllDifferent |
createAllDifferent()
Answer a new, anonymous node representing the fact that a given set of classes are all pair-wise distinct. |
AllDifferent |
createAllDifferent(RDFList differentMembers)
Answer a new, anonymous node representing the fact that a given set of classes are all pair-wise distinct. |
AllValuesFromRestriction |
createAllValuesFromRestriction(java.lang.String uri,
Property prop,
Resource cls)
Answer a class description defined as the class of those individuals for which all values of the given property belong to the given class |
AnnotationProperty |
createAnnotationProperty(java.lang.String uri)
Answer a resource that represents an annotation property in this model. |
CardinalityRestriction |
createCardinalityRestriction(java.lang.String uri,
Property prop,
int cardinality)
Answer a class description defined as the class of those individuals that have exactly the given number of values for the given property. |
OntClass |
createClass()
Answer a resource that represents an anonymous class description in this model. |
OntClass |
createClass(java.lang.String uri)
Answer a resource that represents a class description node in this model. |
ComplementClass |
createComplementClass(java.lang.String uri,
Resource cls)
Answer a resource representing the class that is the complement of the given argument class |
DatatypeProperty |
createDatatypeProperty(java.lang.String uri)
Answer a resource that represents datatype property in this model, and that is not a functional property. |
DatatypeProperty |
createDatatypeProperty(java.lang.String uri,
boolean functional)
Answer a resource that represents datatype property in this model. |
EnumeratedClass |
createEnumeratedClass(java.lang.String uri,
RDFList members)
Answer a resource representing the class that is the enumeration of the given list of individuals |
HasValueRestriction |
createHasValueRestriction(java.lang.String uri,
Property prop,
RDFNode value)
Answer a class description defined as the class of those individuals that have the given resource as the value of the given property |
Individual |
createIndividual(Resource cls)
Answer a resource that represents an Indvidual node in this model. |
Individual |
createIndividual(java.lang.String uri,
Resource cls)
Answer a resource that represents an Individual node in this model. |
IntersectionClass |
createIntersectionClass(java.lang.String uri,
RDFList members)
Answer a resource representing the class that is the intersection of the given list of class descriptions. |
InverseFunctionalProperty |
createInverseFunctionalProperty(java.lang.String uri)
Answer a resource representing an inverse functional property |
InverseFunctionalProperty |
createInverseFunctionalProperty(java.lang.String uri,
boolean functional)
Answer a resource representing an inverse functional property, which is optionally also functional. |
MaxCardinalityRestriction |
createMaxCardinalityRestriction(java.lang.String uri,
Property prop,
int cardinality)
Answer a class description defined as the class of those individuals that have at most the given number of values for the given property. |
MinCardinalityRestriction |
createMinCardinalityRestriction(java.lang.String uri,
Property prop,
int cardinality)
Answer a class description defined as the class of those individuals that have at least the given number of values for the given property. |
ObjectProperty |
createObjectProperty(java.lang.String uri)
Answer a resource representing an object property in this model, and that is not a functional property. |
ObjectProperty |
createObjectProperty(java.lang.String uri,
boolean functional)
Answer a resource that represents an object property in this model. |
Ontology |
createOntology(java.lang.String uri)
Answer a resource that represents an ontology description node in this model. |
OntProperty |
createOntProperty(java.lang.String uri)
Answer a resource representing an generic property in this model. |
OntResource |
createOntResource(java.lang.Class javaClass,
Resource rdfType,
java.lang.String uri)
Answer a resource that represents a generic ontology node in this model. |
Restriction |
createRestriction(Property p)
Answer a resource that represents an anonymous property restriction in this model. |
Restriction |
createRestriction(java.lang.String uri,
Property p)
Answer a resource that represents a property restriction in this model. |
SomeValuesFromRestriction |
createSomeValuesFromRestriction(java.lang.String uri,
Property prop,
Resource cls)
Answer a class description defined as the class of those individuals that have at least one property with a value belonging to the given class |
SymmetricProperty |
createSymmetricProperty(java.lang.String uri)
Answer a resource representing a symmetric property |
SymmetricProperty |
createSymmetricProperty(java.lang.String uri,
boolean functional)
Answer a resource representing a symmetric property, which is optionally also functional. |
TransitiveProperty |
createTransitiveProperty(java.lang.String uri)
Answer a resource representing a transitive property |
TransitiveProperty |
createTransitiveProperty(java.lang.String uri,
boolean functional)
Answer a resource representing a transitive property, which is optionally also functional. |
UnionClass |
createUnionClass(java.lang.String uri,
RDFList members)
Answer a resource representing the class that is the union of the given list of class desctiptions |
AllValuesFromRestriction |
getAllValuesFromRestriction(java.lang.String uri)
Answer a class description defined as the class of those individuals for which all values of the given property belong to the given class. |
AnnotationProperty |
getAnnotationProperty(java.lang.String uri)
Answer a resource that represents an annotation property in this model. |
Model |
getBaseModel()
Answer the base model of this model. |
CardinalityRestriction |
getCardinalityRestriction(java.lang.String uri)
Answer a class description defined as the class of those individuals that have exactly the given number of values for the given property. |
ComplementClass |
getComplementClass(java.lang.String uri)
Answer a resource representing the class that is the complement of another class. |
DatatypeProperty |
getDatatypeProperty(java.lang.String uri)
Answer a resource that represents datatype property in this model. . |
OntDocumentManager |
getDocumentManager()
Answer a reference to the document manager that this model is using to manage ontology <-> mappings, and to load the imports closure. |
EnumeratedClass |
getEnumeratedClass(java.lang.String uri)
Answer a resource representing the class that is the enumeration of a list of individuals. |
HasValueRestriction |
getHasValueRestriction(java.lang.String uri)
Answer a class description defined as the class of those individuals that have the given resource as the value of the given property. |
Individual |
getIndividual(java.lang.String uri)
Answer a resource that represents an Individual node in this model. |
IntersectionClass |
getIntersectionClass(java.lang.String uri)
Answer a resource representing the class that is the intersection of a list of class descriptions. |
InverseFunctionalProperty |
getInverseFunctionalProperty(java.lang.String uri)
Answer a resource representing an inverse functional property. |
MaxCardinalityRestriction |
getMaxCardinalityRestriction(java.lang.String uri)
Answer a class description defined as the class of those individuals that have at most the given number of values for the given property. |
MinCardinalityRestriction |
getMinCardinalityRestriction(java.lang.String uri)
Answer a class description defined as the class of those individuals that have at least the given number of values for the given property. |
ModelMaker |
getModelMaker()
Answer the model maker associated with this model (used for constructing the constituent models of the imports closure). |
ObjectProperty |
getObjectProperty(java.lang.String uri)
Answer a resource representing an object property in this model. |
OntClass |
getOntClass(java.lang.String uri)
Answer a resource that represents a class description node in this model. |
Ontology |
getOntology(java.lang.String uri)
Answer a resource that represents an ontology description node in this model. |
OntProperty |
getOntProperty(java.lang.String uri)
Answer a resource representing an generic property in this model. |
Profile |
getProfile()
Answer the language profile (for example, OWL or DAML+OIL) that this model is working to. |
Restriction |
getRestriction(java.lang.String uri)
Answer a resource that represents a property restriction in this model. |
SomeValuesFromRestriction |
getSomeValuesFromRestriction(java.lang.String uri)
Answer a class description defined as the class of those individuals that have at least one property with a value belonging to the given class. |
OntModelSpec |
getSpecification()
Answer the ontology model specification that was used to construct this model |
java.util.List |
getSubGraphs()
Answer the sub-graphs of this model. |
SymmetricProperty |
getSymmetricProperty(java.lang.String uri)
Answer a resource representing a symmetric property. |
TransitiveProperty |
getTransitiveProperty(java.lang.String uri)
Answer a resource representing a transitive property. |
UnionClass |
getUnionClass(java.lang.String uri)
Answer a resource representing the class that is the union of a list of class desctiptions. |
boolean |
hasLoadedImport(java.lang.String uri)
Answer true if this model has had the given URI document imported into it. |
ExtendedIterator |
listAllDifferent()
Answer an iterator that ranges over the nodes that denote pair-wise disjointness between sets of classes. |
ExtendedIterator |
listAnnotationProperties()
Answer an iterator that ranges over the properties in this model that are declared to be annotation properties. |
ExtendedIterator |
listClasses()
Answer an iterator that ranges over all of the various forms of class description resource in this model. |
ExtendedIterator |
listComplementClasses()
Answer an iterator that ranges over the complement class-descriptions in this model, i.e. the class resources specified to have a property complementOf (or equivalent) and a list of values.
|
ExtendedIterator |
listDatatypeProperties()
Answer an iterator that ranges over the datatype property resources in this model, i.e. the resources with rdf:type DatatypeProperty or equivalent. |
ExtendedIterator |
listEnumeratedClasses()
Answer an iterator that ranges over the enumerated class class-descriptions in this model, i.e. the class resources specified to have a property oneOf (or equivalent) and a list of values.
|
java.util.List |
listImportedOntologyURIs()
Answer a list of the imported URI's in this ontology model. |
ExtendedIterator |
listIndividuals()
Answer an iterator that ranges over the individual resources in this model, i.e. the resources with rdf:type corresponding to a class defined
in the ontology.
|
ExtendedIterator |
listIntersectionClasses()
Answer an iterator that ranges over the intersection class-descriptions in this model, i.e. the class resources specified to have a property intersectionOf (or equivalent) and a list of values.
|
ExtendedIterator |
listNamedClasses()
Answer an iterator that ranges over the named class-descriptions in this model, i.e. resources with rdf:type
Class (or equivalent) and a node URI.
|
ExtendedIterator |
listObjectProperties()
Answer an iterator that ranges over the object property resources in this model, i.e. the resources with rdf:type ObjectProperty or equivalent. |
ExtendedIterator |
listOntologies()
Answer an iterator that ranges over the ontology resources in this model, i.e. the resources with rdf:type Ontology or equivalent. |
ExtendedIterator |
listOntProperties()
Answer an iterator that ranges over the property resources in this model, i.e. the resources with rdf:type Property or equivalent. |
ExtendedIterator |
listRestrictions()
Answer an iterator that ranges over the property restriction class-descriptions in this model, i.e. resources with rdf:type
Restriction (or equivalent).
|
ExtendedIterator |
listUnionClasses()
Answer an iterator that ranges over the union class-descriptions in this model, i.e. the class resources specified to have a property unionOf (or equivalent) and a list of values.
|
ExtendedIterator |
queryFor(BindingQueryPlan query,
java.util.List altQueries,
java.lang.Class asKey)
Answer the iterator over the resources from the graph that satisfy the given query, followed by the answers to the alternative queries (if specified). |
void |
setStrictMode(boolean strict)
Set the checking mode to strict or non-strict. |
boolean |
strictMode()
Answer true if this model is currently in strict checking mode. |
Model |
write(java.io.OutputStream out)
Write a serialization of this model as an XML document. |
Model |
write(java.io.OutputStream out,
java.lang.String lang)
Write a serialized represention of this model in a specified language. |
Model |
write(java.io.OutputStream out,
java.lang.String lang,
java.lang.String base)
Write a serialized represention of a model in a specified language. |
Model |
write(java.io.Writer writer)
Write the model as an XML document. |
Model |
write(java.io.Writer writer,
java.lang.String lang)
Write a serialized represention of a model in a specified language. |
Model |
write(java.io.Writer writer,
java.lang.String lang,
java.lang.String base)
Write a serialized represention of a model in a specified language. |
Model |
writeAll(java.io.OutputStream out,
java.lang.String lang,
java.lang.String base)
Write a serialized represention of all of the contents of the model, including inferred statements and statements imported from other documents. |
Model |
writeAll(java.io.Writer writer,
java.lang.String lang,
java.lang.String base)
Write a serialized represention of all of the contents of the model, including inferred statements and statements imported from other documents. |
Methods inherited from interface com.hp.hpl.jena.rdf.model.RDFReaderF |
getReader, getReader, setReaderClassName |
Methods inherited from interface com.hp.hpl.jena.rdf.model.RDFWriterF |
getWriter, getWriter, setWriterClassName |
Methods inherited from interface com.hp.hpl.jena.shared.PrefixMapping |
expandPrefix, getNsPrefixMap, getNsPrefixURI, getNsURIPrefix, lock, setNsPrefix, setNsPrefixes, setNsPrefixes, usePrefix |
Methods inherited from interface com.hp.hpl.jena.rdf.model.ModelLock |
enterCriticalSection, leaveCriticalSection |
Method Detail |
public ExtendedIterator listOntologies()
Answer an iterator that ranges over the ontology resources in this model, i.e.
the resources with rdf:type Ontology
or equivalent. These resources
typically contain metadata about the ontology document that contains them.
Specifically, the resources in this iterator will those whose type corresponds
to the value given in the ontology vocabulary associated with this model, see
Profile.ONTOLOGY()
.
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
public ExtendedIterator listOntProperties()
Answer an iterator that ranges over the property resources in this model, i.e.
the resources with rdf:type Property
or equivalent. An OntProperty
is equivalent to an rdfs:Property
in a normal RDF graph; this type is
provided as a common super-type for the more specific ObjectProperty
and
DatatypeProperty
property types.
Specifically, the resources in this iterator will those whose type corresponds to the value given in the ontology vocabulary associated with this model.
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
public ExtendedIterator listObjectProperties()
Answer an iterator that ranges over the object property resources in this model, i.e.
the resources with rdf:type ObjectProperty
or equivalent. An object
property is a property that is defined in the ontology language semantics as a
one whose range comprises individuals (rather than datatyped literals).
Specifically, the resources in this iterator will those whose type corresponds
to the value given in the ontology vocabulary associated with this model: see
Profile.OBJECT_PROPERTY()
.
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
public ExtendedIterator listDatatypeProperties()
Answer an iterator that ranges over the datatype property resources in this model, i.e.
the resources with rdf:type DatatypeProperty
or equivalent. An datatype
property is a property that is defined in the ontology language semantics as a
one whose range comprises datatyped literals (rather than individuals).
Specifically, the resources in this iterator will those whose type corresponds
to the value given in the ontology vocabulary associated with this model: see
Profile.DATATYPE_PROPERTY()
.
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
public ExtendedIterator listIndividuals()
Answer an iterator that ranges over the individual resources in this model, i.e.
the resources with rdf:type
corresponding to a class defined
in the ontology.
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
public ExtendedIterator listClasses()
Answer an iterator that ranges over all of the various forms of class description resource
in this model. Class descriptions include enumerated
classes, union
classes, complement
classes, intersection
classes, named
classes and property restrictions
.
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
public ExtendedIterator listEnumeratedClasses()
Answer an iterator that ranges over the enumerated class class-descriptions
in this model, i.e. the class resources specified to have a property
oneOf
(or equivalent) and a list of values.
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
Profile.ONE_OF()
public ExtendedIterator listUnionClasses()
Answer an iterator that ranges over the union class-descriptions
in this model, i.e. the class resources specified to have a property
unionOf
(or equivalent) and a list of values.
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
Profile.UNION_OF()
public ExtendedIterator listComplementClasses()
Answer an iterator that ranges over the complement class-descriptions
in this model, i.e. the class resources specified to have a property
complementOf
(or equivalent) and a list of values.
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
Profile.COMPLEMENT_OF()
public ExtendedIterator listIntersectionClasses()
Answer an iterator that ranges over the intersection class-descriptions
in this model, i.e. the class resources specified to have a property
intersectionOf
(or equivalent) and a list of values.
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
Profile.INTERSECTION_OF()
public ExtendedIterator listNamedClasses()
Answer an iterator that ranges over the named class-descriptions
in this model, i.e. resources with rdf:type
Class
(or equivalent) and a node URI.
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
public ExtendedIterator listRestrictions()
Answer an iterator that ranges over the property restriction class-descriptions
in this model, i.e. resources with rdf:type
Restriction
(or equivalent).
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
Profile.RESTRICTION()
public ExtendedIterator listAnnotationProperties()
Answer an iterator that ranges over the properties in this model that are declared to be annotation properties. Not all supported languages define annotation properties (the category of annotation properties is chiefly an OWL innovation).
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
Profile.getAnnotationProperties()
public ExtendedIterator listAllDifferent()
Answer an iterator that ranges over the nodes that denote pair-wise disjointness between sets of classes.
Note: the number of nodes returned by this iterator will vary according to the completeness of the deductive extension of the underlying graph. See class overview for more details.
public Ontology getOntology(java.lang.String uri)
Answer a resource that represents an ontology description node in this model. If a resource with the given uri exists in the model, and can be viewed as an Ontology, return the Ontology facet, otherwise return null.
uri
- The uri for the ontology node. Conventionally, this corresponds to the base URI
of the document itself.
public Individual getIndividual(java.lang.String uri)
Answer a resource that represents an Individual node in this model. If a resource with the given uri exists in the model, and can be viewed as an Individual, return the Individual facet, otherwise return null.
uri
- The URI for the requried individual
public OntProperty getOntProperty(java.lang.String uri)
Answer a resource representing an generic property in this model. If a property with the given uri exists in the model, return the OntProperty facet, otherwise return null.
uri
- The uri for the property.
public ObjectProperty getObjectProperty(java.lang.String uri)
Answer a resource representing an object property in this model. If a resource with the given uri exists in the model, and can be viewed as an ObjectProperty, return the ObjectProperty facet, otherwise return null.
uri
- The uri for the object property. May not be null.
public TransitiveProperty getTransitiveProperty(java.lang.String uri)
Answer a resource representing a transitive property. If a resource with the given uri exists in the model, and can be viewed as a TransitiveProperty, return the TransitiveProperty facet, otherwise return null.
uri
- The uri for the property. May not be null.
public SymmetricProperty getSymmetricProperty(java.lang.String uri)
Answer a resource representing a symmetric property. If a resource with the given uri exists in the model, and can be viewed as a SymmetricProperty, return the SymmetricProperty facet, otherwise return null.
uri
- The uri for the property. May not be null.
public InverseFunctionalProperty getInverseFunctionalProperty(java.lang.String uri)
Answer a resource representing an inverse functional property. If a resource with the given uri exists in the model, and can be viewed as a InverseFunctionalProperty, return the InverseFunctionalProperty facet, otherwise return null.
uri
- The uri for the property. May not be null.
public DatatypeProperty getDatatypeProperty(java.lang.String uri)
Answer a resource that represents datatype property in this model. . If a resource with the given uri exists in the model, and can be viewed as a DatatypeProperty, return the DatatypeProperty facet, otherwise return null.
uri
- The uri for the datatype property. May not be null.
public AnnotationProperty getAnnotationProperty(java.lang.String uri)
Answer a resource that represents an annotation property in this model. If a resource with the given uri exists in the model, and can be viewed as an AnnotationProperty, return the AnnotationProperty facet, otherwise return null.
uri
- The uri for the annotation property. May not be null.
public OntClass getOntClass(java.lang.String uri)
Answer a resource that represents a class description node in this model. If a resource with the given uri exists in the model, and can be viewed as an OntClass, return the OntClass facet, otherwise return null.
uri
- The uri for the class node, or null for an anonymous class.
public ComplementClass getComplementClass(java.lang.String uri)
Answer a resource representing the class that is the complement of another class. If a resource with the given uri exists in the model, and can be viewed as a ComplementClass, return the ComplementClass facet, otherwise return null.
uri
- The URI of the new complement class.
public EnumeratedClass getEnumeratedClass(java.lang.String uri)
Answer a resource representing the class that is the enumeration of a list of individuals. If a resource with the given uri exists in the model, and can be viewed as an EnumeratedClass, return the EnumeratedClass facet, otherwise return null.
uri
- The URI of the new enumeration class.
public UnionClass getUnionClass(java.lang.String uri)
Answer a resource representing the class that is the union of a list of class desctiptions. If a resource with the given uri exists in the model, and can be viewed as a UnionClass, return the UnionClass facet, otherwise return null.
uri
- The URI of the new union class.
public IntersectionClass getIntersectionClass(java.lang.String uri)
Answer a resource representing the class that is the intersection of a list of class descriptions. If a resource with the given uri exists in the model, and can be viewed as a IntersectionClass, return the IntersectionClass facet, otherwise return null.
uri
- The URI of the new intersection class.
public Restriction getRestriction(java.lang.String uri)
Answer a resource that represents a property restriction in this model. If a resource with the given uri exists in the model, and can be viewed as a Restriction, return the Restriction facet, otherwise return null.
uri
- The uri for the restriction node.
public HasValueRestriction getHasValueRestriction(java.lang.String uri)
Answer a class description defined as the class of those individuals that have the given resource as the value of the given property. If a resource with the given uri exists in the model, and can be viewed as a HasValueRestriction, return the HasValueRestriction facet, otherwise return null.
uri
- The URI for the restriction
public SomeValuesFromRestriction getSomeValuesFromRestriction(java.lang.String uri)
Answer a class description defined as the class of those individuals that have at least one property with a value belonging to the given class. If a resource with the given uri exists in the model, and can be viewed as a SomeValuesFromRestriction, return the SomeValuesFromRestriction facet, otherwise return null.
uri
- The URI for the restriction
public AllValuesFromRestriction getAllValuesFromRestriction(java.lang.String uri)
Answer a class description defined as the class of those individuals for which all values of the given property belong to the given class. If a resource with the given uri exists in the model, and can be viewed as an AllValuesFromResriction, return the AllValuesFromRestriction facet, otherwise return null.
uri
- The URI for the restriction
public CardinalityRestriction getCardinalityRestriction(java.lang.String uri)
Answer a class description defined as the class of those individuals that have exactly the given number of values for the given property. If a resource with the given uri exists in the model, and can be viewed as a CardinalityRestriction, return the CardinalityRestriction facet, otherwise return null.
uri
- The URI for the restriction
public MinCardinalityRestriction getMinCardinalityRestriction(java.lang.String uri)
Answer a class description defined as the class of those individuals that have at least the given number of values for the given property. If a resource with the given uri exists in the model, and can be viewed as a MinCardinalityRestriction, return the MinCardinalityRestriction facet, otherwise return null.
uri
- The URI for the restriction
public MaxCardinalityRestriction getMaxCardinalityRestriction(java.lang.String uri)
Answer a class description defined as the class of those individuals that have at most the given number of values for the given property. If a resource with the given uri exists in the model, and can be viewed as a MaxCardinalityRestriction, return the MaxCardinalityRestriction facet, otherwise return null.
uri
- The URI for the restriction
public Ontology createOntology(java.lang.String uri)
Answer a resource that represents an ontology description node in this model. If a resource with the given uri exists in the model, it will be re-used. If not, a new one is created in the updateable sub-model of the ontology model.
uri
- The uri for the ontology node. Conventionally, this corresponds to the base URI
of the document itself.
public Individual createIndividual(Resource cls)
Answer a resource that represents an Indvidual node in this model. A new anonymous resource will be created in the updateable sub-model of the ontology model.
cls
- Resource representing the ontology class to which the individual belongs
public Individual createIndividual(java.lang.String uri, Resource cls)
Answer a resource that represents an Individual node in this model. If a resource with the given uri exists in the model, it will be re-used. If not, a new one is created in the updateable sub-model of the ontology model.
cls
- Resource representing the ontology class to which the individual belongsuri
- The uri for the individual, or null for an anonymous individual.
public OntProperty createOntProperty(java.lang.String uri)
Answer a resource representing an generic property in this model. Effectively
this method is an alias for ModelCon.createProperty( String )
, except that
the return type is OntProperty
, which allow more convenient access to
a property's position in the property hierarchy, domain, range, etc.
uri
- The uri for the property. May not be null.
public ObjectProperty createObjectProperty(java.lang.String uri)
Answer a resource representing an object property in this model, and that is not a functional property.
uri
- The uri for the object property. May not be null.
createObjectProperty( String, boolean )
public ObjectProperty createObjectProperty(java.lang.String uri, boolean functional)
Answer a resource that represents an object property in this model. An object property is defined to have a range of individuals, rather than datatypes. If a resource with the given uri exists in the model, it will be re-used. If not, a new one is created in the updateable sub-model of the ontology model.
uri
- The uri for the object property. May not be null.functional
- If true, the resource will also be typed as a FunctionalProperty
,
that is, a property that has a unique range value for any given domain value.
public TransitiveProperty createTransitiveProperty(java.lang.String uri)
Answer a resource representing a transitive property
uri
- The uri for the property. May not be null.
createTransitiveProperty( String, boolean )
public TransitiveProperty createTransitiveProperty(java.lang.String uri, boolean functional)
Answer a resource representing a transitive property, which is optionally also functional. Note: although it is permitted in OWL full to have functional transitive properties, it makes the language undecideable. Functional transitive properties are not permitted in OWL Lite or OWL DL.
uri
- The uri for the property. May not be null.functional
- If true, the property is also functional
public SymmetricProperty createSymmetricProperty(java.lang.String uri)
Answer a resource representing a symmetric property
uri
- The uri for the property. May not be null.
createSymmetricProperty( String, boolean )
public SymmetricProperty createSymmetricProperty(java.lang.String uri, boolean functional)
Answer a resource representing a symmetric property, which is optionally also functional.
uri
- The uri for the property. May not be null.functional
- If true, the property is also functional
public InverseFunctionalProperty createInverseFunctionalProperty(java.lang.String uri)
Answer a resource representing an inverse functional property
uri
- The uri for the property. May not be null.
createInverseFunctionalProperty( String, boolean )
public InverseFunctionalProperty createInverseFunctionalProperty(java.lang.String uri, boolean functional)
Answer a resource representing an inverse functional property, which is optionally also functional.
uri
- The uri for the property. May not be null.functional
- If true, the property is also functional
public DatatypeProperty createDatatypeProperty(java.lang.String uri)
Answer a resource that represents datatype property in this model, and that is not a functional property.
uri
- The uri for the datatype property. May not be null.
createDatatypeProperty( String, boolean )
public DatatypeProperty createDatatypeProperty(java.lang.String uri, boolean functional)
Answer a resource that represents datatype property in this model. A datatype property is defined to have a range that is a concrete datatype, rather than an individual. If a resource with the given uri exists in the model, it will be re-used. If not, a new one is created in the updateable sub-model of the ontology model.
uri
- The uri for the datatype property. May not be null.functional
- If true, the resource will also be typed as a FunctionalProperty
,
that is, a property that has a unique range value for any given domain value.
public AnnotationProperty createAnnotationProperty(java.lang.String uri)
Answer a resource that represents an annotation property in this model. If a resource with the given uri exists in the model, it will be re-used. If not, a new one is created in the updateable sub-model of the ontology model.
uri
- The uri for the annotation property. May not be null.
public OntClass createClass()
Answer a resource that represents an anonymous class description in this model. A new
anonymous resource of rdf:type C
, where C is the class type from the
language profile.
public OntClass createClass(java.lang.String uri)
Answer a resource that represents a class description node in this model. If a resource with the given uri exists in the model, it will be re-used. If not, a new one is created in the updateable sub-model of the ontology model.
uri
- The uri for the class node, or null for an anonymous class.
public ComplementClass createComplementClass(java.lang.String uri, Resource cls)
Answer a resource representing the class that is the complement of the given argument class
uri
- The URI of the new complement class, or null for an anonymous class description.cls
- Resource denoting the class that the new class is a complement of
public EnumeratedClass createEnumeratedClass(java.lang.String uri, RDFList members)
Answer a resource representing the class that is the enumeration of the given list of individuals
uri
- The URI of the new enumeration class, or null for an anonymous class description.members
- An optional list of resources denoting the individuals in the enumeration, or null.
public UnionClass createUnionClass(java.lang.String uri, RDFList members)
Answer a resource representing the class that is the union of the given list of class desctiptions
uri
- The URI of the new union class, or null for an anonymous class description.members
- A list of resources denoting the classes that comprise the union
public IntersectionClass createIntersectionClass(java.lang.String uri, RDFList members)
Answer a resource representing the class that is the intersection of the given list of class descriptions.
uri
- The URI of the new intersection class, or null for an anonymous class description.members
- A list of resources denoting the classes that comprise the intersection
public Restriction createRestriction(Property p)
Answer a resource that represents an anonymous property restriction in this model. A new
anonymous resource of rdf:type R
, where R is the restriction type from the
language profile.
p
- The property that is restricted by this restriction, or null to omit from the restriction
public Restriction createRestriction(java.lang.String uri, Property p)
Answer a resource that represents a property restriction in this model. If a resource with the given uri exists in the model, it will be re-used. If not, a new one is created in the updateable sub-model of the ontology model.
uri
- The uri for the restriction node, or null for an anonymous restriction.p
- The property that is restricted by this restriction, or null to omit from the restriction
public HasValueRestriction createHasValueRestriction(java.lang.String uri, Property prop, RDFNode value)
Answer a class description defined as the class of those individuals that have the given resource as the value of the given property
uri
- The optional URI for the restriction, or null for an anonymous restriction (which
should be the normal case)prop
- The property the restriction applies tovalue
- The value of the property, as a resource or RDF literal
public SomeValuesFromRestriction createSomeValuesFromRestriction(java.lang.String uri, Property prop, Resource cls)
Answer a class description defined as the class of those individuals that have at least one property with a value belonging to the given class
uri
- The optional URI for the restriction, or null for an anonymous restriction (which
should be the normal case)prop
- The property the restriction applies tocls
- The class to which at least one value of the property belongs
public AllValuesFromRestriction createAllValuesFromRestriction(java.lang.String uri, Property prop, Resource cls)
Answer a class description defined as the class of those individuals for which all values of the given property belong to the given class
uri
- The optional URI for the restriction, or null for an anonymous restriction (which
should be the normal case)prop
- The property the restriction applies tocls
- The class to which any value of the property belongs
public CardinalityRestriction createCardinalityRestriction(java.lang.String uri, Property prop, int cardinality)
Answer a class description defined as the class of those individuals that have exactly the given number of values for the given property.
uri
- The optional URI for the restriction, or null for an anonymous restriction (which
should be the normal case)prop
- The property the restriction applies tocardinality
- The exact cardinality of the property
public MinCardinalityRestriction createMinCardinalityRestriction(java.lang.String uri, Property prop, int cardinality)
Answer a class description defined as the class of those individuals that have at least the given number of values for the given property.
uri
- The optional URI for the restriction, or null for an anonymous restriction (which
should be the normal case)prop
- The property the restriction applies tocardinality
- The minimum cardinality of the property
public MaxCardinalityRestriction createMaxCardinalityRestriction(java.lang.String uri, Property prop, int cardinality)
Answer a class description defined as the class of those individuals that have at most the given number of values for the given property.
uri
- The optional URI for the restriction, or null for an anonymous restriction (which
should be the normal case)prop
- The property the restriction applies tocardinality
- The maximum cardinality of the property
public AllDifferent createAllDifferent()
Answer a new, anonymous node representing the fact that a given set of classes are all
pair-wise distinct. AllDifferent
is a feature of OWL only, and is something
of an anomoly in that it exists only to give a place to anchor the distinctMembers
property, which is the actual expression of the fact.
public AllDifferent createAllDifferent(RDFList differentMembers)
Answer a new, anonymous node representing the fact that a given set of classes are all
pair-wise distinct. AllDifferent
is a feature of OWL only, and is something
of an anomoly in that it exists only to give a place to anchor the distinctMembers
property, which is the actual expression of the fact.
differentMembers
- A list of the class expressions that denote a set of mutually disjoint classes
public OntResource createOntResource(java.lang.Class javaClass, Resource rdfType, java.lang.String uri)
Answer a resource that represents a generic ontology node in this model. If a resource with the given uri exists in the model, it will be re-used. If not, a new one is created in the updateable sub-model of the ontology model.
This is a generic method for creating any known ontology value. The selector that determines
which resource to create is the same as as the argument to the as()
method: the Java class object of the desired abstraction. For example, to create an
ontology class via this mechanism, use:
OntClass c = (OntClass) myModel.createOntResource( OntClass.class, null,
"http://example.org/ex#Parrot" );
javaClass
- The Java class object that represents the ontology abstraction to createrdfType
- Optional resource denoting the ontology class to which an individual or
axiom belongs, if that is the type of resource being created.uri
- The uri for the ontology resource, or null for an anonymous resource.
javaClass
public java.util.List listImportedOntologyURIs()
Answer a list of the imported URI's in this ontology model. Detection of imports
statments will be according to the local language profile. Note that, in order to allow this
method to be called during the imports closure process, we only query the base model,
thus side-stepping the any attached reasoner.
public boolean hasLoadedImport(java.lang.String uri)
Answer true if this model has had the given URI document imported into it. This is important to know since an import only occurs once, and we also want to be able to detect cycles of imports.
uri
- An ontology URI
public void addLoadedImport(java.lang.String uri)
Record that this model has now imported the document with the given URI, so that it will not be re-imported in the future.
uri
- A document URI that has now been imported into the model.public Profile getProfile()
Answer the language profile (for example, OWL or DAML+OIL) that this model is working to.
public ModelMaker getModelMaker()
Answer the model maker associated with this model (used for constructing the constituent models of the imports closure).
public java.util.List getSubGraphs()
Answer the sub-graphs of this model. A sub-graph is defined as a graph that is used to contain the triples from an imported document.
public Model getBaseModel()
Answer the base model of this model. The base model is the model
that contains the triples read from the source document for this
ontology. It is therefore this base model that will be updated if statements are
added to a model that is built from a union of documents (via the
imports
statements in the source document).
public void addSubModel(Model model)
Add the given model as one of the sub-models of the enclosed ontology union model. Will cause the associated infererence engine (if any) to update, so this may be an expensive operation in some cases.
model
- A sub-model to addaddSubModel( Model, boolean )
public void addSubModel(Model model, boolean rebind)
Add the given model as one of the sub-models of the enclosed ontology union model.
model
- A sub-model to addrebind
- If true, rebind any associated inferencing engine to the new data (which
may be an expensive operation)public boolean strictMode()
Answer true if this model is currently in strict checking mode. Strict mode means that converting a common resource to a particular language element, such as an ontology class, will be subject to some simple syntactic-level checks for appropriateness.
public void setStrictMode(boolean strict)
Set the checking mode to strict or non-strict.
strict
- strictMode()
public OntDocumentManager getDocumentManager()
Answer a reference to the document manager that this model is using to manage ontology <-> mappings, and to load the imports closure. Note by default, an ontology model is constructed with a reference to the shared, global document manager. Thus changing the settings via this model's document manager may affect other models also using the same instance.
public OntModelSpec getSpecification()
Answer the ontology model specification that was used to construct this model
public ExtendedIterator queryFor(BindingQueryPlan query, java.util.List altQueries, java.lang.Class asKey)
Answer the iterator over the resources from the graph that satisfy the given
query, followed by the answers to the alternative queries (if specified). A
typical scenario is that the main query gets resources of a given class (say,
rdfs:Class
), while the altQueries query for aliases for that
type (such as daml:Class
).
query
- A query to run against the modelaltQueries
- An optional list of subsidiary queries to chain on to the first
public Model write(java.io.Writer writer)
Write the model as an XML document.
It is often better to use an OutputStream rather than a Writer, since this
will avoid character encoding errors.
Note: This method is adapted for the ontology
model to write out only the base model (which contains the asserted data). To write
all triples, including imported data and inferred triples, use
writeAll
.
write
in interface Model
writer
- A writer to which the XML will be written
public Model write(java.io.Writer writer, java.lang.String lang)
Write a serialized represention of a model in a specified language.
It is often better to use an OutputStream rather than a Writer, since this
will avoid character encoding errors.
Note: This method is adapted for the ontology
model to write out only the base model (which contains the asserted data). To write
all triples, including imported data and inferred triples, use
writeAll
.
The language in which to write the model is specified by the
lang
argument. Predefined values are "RDF/XML",
"RDF/XML-ABBREV", "N-TRIPLE" and "N3". The default value,
represented by null
is "RDF/XML".
write
in interface Model
writer
- The output writerlang
- The output language
public Model write(java.io.Writer writer, java.lang.String lang, java.lang.String base)
Write a serialized represention of a model in a specified language.
It is often better to use an OutputStream rather than a Writer,
since this will avoid character encoding errors.
Note: This method is adapted for the ontology
model to write out only the base model (which contains the asserted data). To write
all triples, including imported data and inferred triples, use
writeAll
.
The language in which to write the model is specified by the
lang
argument. Predefined values are "RDF/XML",
"RDF/XML-ABBREV", "N-TRIPLE" and "N3". The default value,
represented by null
, is "RDF/XML".
write
in interface Model
writer
- The output writerbase
- The base uri for relative URI calculations.
null
means use only absolute URI's.lang
- The language in which the RDF should be written
public Model write(java.io.OutputStream out)
Write a serialization of this model as an XML document.
Note: This method is adapted for the ontology
model to write out only the base model (which contains the asserted data). To write
all triples, including imported data and inferred triples, use
writeAll
.
The language in which to write the model is specified by the
lang
argument. Predefined values are "RDF/XML",
"RDF/XML-ABBREV", "N-TRIPLE" and "N3". The default value is
represented by null
is "RDF/XML".
write
in interface Model
out
- The output stream to which the XML will be written
public Model write(java.io.OutputStream out, java.lang.String lang)
Write a serialized represention of this model in a specified language.
Note: This method is adapted for the ontology
model to write out only the base model (which contains the asserted data). To write
all triples, including imported data and inferred triples, use
writeAll
.
The language in which to write the model is specified by the
lang
argument. Predefined values are "RDF/XML",
"RDF/XML-ABBREV", "N-TRIPLE" and "N3". The default value,
represented by null
, is "RDF/XML".
write
in interface Model
out
- The output stream to which the RDF is writtenlang
- The output langauge
public Model write(java.io.OutputStream out, java.lang.String lang, java.lang.String base)
Write a serialized represention of a model in a specified language.
Note: This method is adapted for the ontology
model to write out only the base model (which contains the asserted data). To write
all triples, including imported data and inferred triples, use
writeAll
.
The language in which to write the model is specified by the
lang
argument. Predefined values are "RDF/XML",
"RDF/XML-ABBREV", "N-TRIPLE" and "N3". The default value,
represented by null
, is "RDF/XML".
write
in interface Model
out
- The output stream to which the RDF is writtenbase
- The base uri to use when writing relative URI's. null
means use only absolute URI's.lang
- The language in which the RDF should be written
public Model writeAll(java.io.Writer writer, java.lang.String lang, java.lang.String base)
Write a serialized represention of all of the contents of the model,
including inferred statements and statements imported from other
documents. To write only the data asserted in the base model, use
write
.
It is often better to use an OutputStream rather than a Writer,
since this will avoid character encoding errors.
The language in which to write the model is specified by the
lang
argument. Predefined values are "RDF/XML",
"RDF/XML-ABBREV", "N-TRIPLE" and "N3". The default value,
represented by null
, is "RDF/XML".
writer
- The output writerbase
- The base uri for relative URI calculations.
null
means use only absolute URI's.lang
- The language in which the RDF should be written
public Model writeAll(java.io.OutputStream out, java.lang.String lang, java.lang.String base)
Write a serialized represention of all of the contents of the model,
including inferred statements and statements imported from other
documents. To write only the data asserted in the base model, use
write
.
The language in which to write the model is specified by the
lang
argument. Predefined values are "RDF/XML",
"RDF/XML-ABBREV", "N-TRIPLE" and "N3". The default value,
represented by null
, is "RDF/XML".
out
- The output stream to which the RDF is writtenbase
- The base uri to use when writing relative URI's. null
means use only absolute URI's.lang
- The language in which the RDF should be written
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |