kaos.policy.information
Interface OntologyInterfaces

All Known Implementing Classes:

CorbaAgentDirectoryServiceProxy, CougaarAgentDirectoryServiceProxy, GridAgentDirectoryServiceProxy, GridDirectoryServicePolicyCert, KAoSAgentDirectoryServiceProxy, KAoSDirectoryService, TCPAgentDirectoryServiceProxy, TunnelClient

public interface OntologyInterfaces

Method Summary

java.util.Set	getInstancesOf(java.lang.String conceptName) Get set of instances of the given concept; if the concept is an instance itself the set contains just this instance.
java.util.Set	getOntologyDefinitionForConcept(java.lang.String conceptName) Get set of namspaces imported by the given namespace.
java.util.Vector	getPropertiesApplicableTo(java.lang.String className) Get properties applicable to the given class
java.lang.String	getRangeOnPropertyForClass(java.lang.String className, java.lang.String propertyName) Get the name of the class defining the range of the specified property for the given class.
java.util.Vector	getSchema(java.lang.String conceptName) Get XML schema of the given concept if such a schema is available
java.util.Set	getSubClassesOf(java.lang.String className) Get set of subclasses of the given class.
java.util.Set	getSubPropertiesOf(java.lang.String propertyName) Get set of subproperties of the given property.
java.util.Set	getSuperPropertiesOf(java.lang.String propertyName) Get set of superproperties of the given property.
boolean	testTrue(java.lang.String statement) Test if the KIF statemant is true according to the ontologies in the ontology repository.

Method Detail

getInstancesOf

java.util.Set getInstancesOf(java.lang.String conceptName)
                             throws UnknownConceptException,
                                    DirectoryFailure

Get set of instances of the given concept; if the concept is an instance itself the set contains just this instance.

Parameters:

conceptName - The name of the concept in the Jena format

Returns:

Set of instance ids in the Jena format

Throws:

java.lang.Exception - if forActor is unknow for the ontology repository

UnknownConceptException

DirectoryFailure

getSubClassesOf

java.util.Set getSubClassesOf(java.lang.String className)
                              throws UnknownConceptException,
                                     DirectoryFailure

Get set of subclasses of the given class.

Parameters:

className - The name of the class in Jena format

Returns:

Set of subclasses names in Jena format

Throws:

java.lang.Exception - if className is unknow for the ontology repository

UnknownConceptException

DirectoryFailure

getSuperPropertiesOf

java.util.Set getSuperPropertiesOf(java.lang.String propertyName)
                                   throws UnknownConceptException,
                                          DirectoryFailure

Get set of superproperties of the given property.

Parameters:

propertyName - The name of the property in Jena format

Returns:

Set of superproperties names in Jena format

Throws:

java.lang.Exception - if propertyName is unknow for the ontology repository

UnknownConceptException

DirectoryFailure

getSubPropertiesOf

java.util.Set getSubPropertiesOf(java.lang.String propertyName)
                                 throws UnknownConceptException,
                                        DirectoryFailure

Get set of subproperties of the given property.

Parameters:

propertyName - The name of the property in Jena format

Returns:

Set of subproperties names in Jena format

Throws:

java.lang.Exception - if propertyName is unknow for the ontology repository

UnknownConceptException

DirectoryFailure

testTrue

boolean testTrue(java.lang.String statement)
                 throws QueryFailure,
                        DirectoryFailure

Test if the KIF statemant is true according to the ontologies in the ontology repository.

Parameters:

statement - the statement in KIF to be tested if true

Returns:

true if the statement is true and false in the opposite case

Throws:

java.lang.Exception - if reasoning failed.

QueryFailure

DirectoryFailure

getPropertiesApplicableTo

java.util.Vector getPropertiesApplicableTo(java.lang.String className)
                                           throws UnknownConceptException,
                                                  QueryFailure,
                                                  DirectoryFailure

Get properties applicable to the given class

Parameters:

className - the name of the class

Returns:

vector of properties names

Throws:

java.lang.Exception - if className is unknow for the ontology repository

UnknownConceptException

QueryFailure

DirectoryFailure

getRangeOnPropertyForClass

java.lang.String getRangeOnPropertyForClass(java.lang.String className,
                                            java.lang.String propertyName)
                                            throws UnknownConceptException,
                                                   QueryFailure,
                                                   DirectoryFailure

Get the name of the class defining the range of the specified property for the given class.

Parameters:

className - the name of the class

propertyName - the name of the property

Returns:

the name of the class defining the range

Throws:

java.lang.Exception - if reasoning failed.

UnknownConceptException

QueryFailure

DirectoryFailure

getOntologyDefinitionForConcept

java.util.Set getOntologyDefinitionForConcept(java.lang.String conceptName)
                                              throws DirectoryFailure

Get set of namspaces imported by the given namespace. Curently it tries to match the concept name with the local name of the ontology definitions url

Parameters:

conceptName - The name of the namespace in the Jena format

Returns:

Set of ontology definition url potentially matching the search concept

Throws:

DirectoryFailure

getSchema

java.util.Vector getSchema(java.lang.String conceptName)
                           throws UnknownConceptException,
                                  DirectoryFailure

Get XML schema of the given concept if such a schema is available

Parameters:

conceptName - The name of the concept in the Jena format

Returns:

A Vector containing Strings that define the XML schema of the given concept. The reason it is a vector of strings and not just one string is that the definition can be complex, i.e. derived from multiple more primitive schemas, hence this vector contains definitions for all those schemas too.

Throws:

java.lang.Exception - if the concept is unknown for the xml repository.

UnknownConceptException

DirectoryFailure