prajna.ontology

Class OwlQuery

java.lang.Object

prajna.ontology.OwlQuery

public class OwlQuery
extends java.lang.Object

Represents a query against a collection of OwlThings.

Author:

Edward Swing

Constructor Summary

Constructors

Constructor and Description
OwlQuery() Create a new OwlQuery with a null queryClass.
OwlQuery(OwlClass owlClass) Create a new OwlQuery with the specified class as the queryClass
OwlQuery(java.lang.String className) Create a new OwlQuery with the specified class as the queryClass.

Method Summary

Methods

Modifier and Type	Method and Description
void	addRelation(java.lang.String relationName, OwlThing relatedTo) Add a relation to the set of relations to match.
void	addRestriction(OwlRestriction rest) Add a restriction to the set of restrictions for this query
java.util.Set<OwlThing>	getMatches() Get the set of OwlThings that match the query.
OwlClass	getQueryClass() Return the queryClass
void	setQueryClass(OwlClass cls) Set the queryClass.

Methods inherited from class java.lang.Object

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

Constructor Detail

OwlQuery

public OwlQuery()

Create a new OwlQuery with a null queryClass.

OwlQuery

public OwlQuery(OwlClass owlClass)

Create a new OwlQuery with the specified class as the queryClass

Parameters:

owlClass - the queryClass

OwlQuery

public OwlQuery(java.lang.String className)

Create a new OwlQuery with the specified class as the queryClass. If the class name does not match a loaded owlClass,

Parameters:

className - the name of the queryClass

Method Detail

addRelation

public void addRelation(java.lang.String relationName,
               OwlThing relatedTo)

Add a relation to the set of relations to match. This method will first attempt to find a restriction matching the relationName that restricts the specific values. If found, it will add the specified value to the set of values. If not, it will create a new restriction with the specified value for the property

Parameters:

relationName - the relation name

relatedTo - the object the thing should be related to.

addRestriction

public void addRestriction(OwlRestriction rest)

Add a restriction to the set of restrictions for this query

Parameters:

rest - the new restriction

getMatches

public java.util.Set<OwlThing> getMatches()

Get the set of OwlThings that match the query. This method gets all known OwlThings, and then checks each against the queryClass (if not null) and then each restriction in turn. Those things which match all restrictions are returned

Returns:

the set of things which match the query

getQueryClass

public OwlClass getQueryClass()

Return the queryClass

Returns:

the queryClass

setQueryClass

public void setQueryClass(OwlClass cls)

Set the queryClass. The queryClass determines the class of Things that this query is searching for. If not set, the query will match all OwlThings that match the restrictions

Parameters:

cls - the query class