JADE_SL.onto
Class BasicIntrospector

java.lang.Object
  JADE_SL.onto.BasicIntrospector

All Implemented Interfaces:

Introspector

class BasicIntrospector

extends java.lang.Object

implements Introspector

Author:

Federico Bergenti - Universita` di Parma

Constructor Summary

(package private)

BasicIntrospector()

Method Summary

void	checkClass(ObjectSchema schema, java.lang.Class javaClass) This method will never be called
AbsObject	externalise(Ontology onto, Ontology referenceOnto, java.lang.Object obj) Translate an object of a class representing an element in an ontology into a proper abstract descriptor
java.lang.Object	internalise(Ontology onto, Ontology referenceOnto, AbsObject abs) Translate an abstract descriptor into an object of a proper class representing an element in an ontology

Methods inherited from class java.lang.Object

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

Constructor Detail

BasicIntrospector

BasicIntrospector()

Method Detail

externalise

public AbsObject externalise(Ontology onto,
                             Ontology referenceOnto,
                             java.lang.Object obj)
                      throws UnknownSchemaException,
                             OntologyException

Translate an object of a class representing an element in an ontology into a proper abstract descriptor

Specified by:

externalise in interface Introspector

Parameters:

onto - The reference ontology

obj - The Object to be translated

referenceOnto - The reference ontology in the context of this translation i.e. the most extended ontology that extends onto (directly or indirectly).

Returns:

The Abstract descriptor produced by the translation

Throws:

UnknownSchemaException - If no schema for the object to be translated is defined in the ontology that uses this Introspector

OntologyException - If some error occurs during the translation

internalise

public java.lang.Object internalise(Ontology onto,
                                    Ontology referenceOnto,
                                    AbsObject abs)
                             throws UngroundedException,
                                    UnknownSchemaException,
                                    OntologyException

Translate an abstract descriptor into an object of a proper class representing an element in an ontology

Specified by:

internalise in interface Introspector

Parameters:

onto - The reference ontology

abs - The abstract descriptor to be translated

referenceOnto - The reference ontology in the context of this translation i.e. the most extended ontology that extends onto (directly or indirectly).

Returns:

The Java object produced by the translation

Throws:

UngroundedException - If the abstract descriptor to be translated contains a variable

UnknownSchemaException - If no schema for the abstract descriptor to be translated is defined in the ontology that uses this Introspector

OntologyException - If some error occurs during the translation

checkClass

public void checkClass(ObjectSchema schema,
                       java.lang.Class javaClass)
                throws OntologyException

This method will never be called

Specified by:

checkClass in interface Introspector

Parameters:

schema - The schema of the ontological element

javaClass - The java class associated to the ontologcal element

Throws:

OntologyException - if the java class does not have the correct structure