jade.content.onto
Class MicroIntrospector

java.lang.Object
  |
  +--jade.content.onto.MicroIntrospector
All Implemented Interfaces:
Introspector, java.io.Serializable, Serializable

public class MicroIntrospector
extends java.lang.Object
implements Introspector

This introspector does nothing but "asking objects to convert themselves into/from abstract descriptors". It could be used when working in Java environments where the reflection is not supported (MIDP). All classes in an ontology using this introspector must implement the Introspectable interface.

Author:
Giovanni Caire - TILAB
See Also:
Serialized Form

Constructor Summary
MicroIntrospector()
           
 
Method Summary
 void checkClass(ObjectSchema schema, java.lang.Class javaClass, Ontology onto)
          Check the structure of a java class associated to an ontological element to ensure that translations to/from abstract descriptors and java objects (instances of that class) can be accomplished by this introspector.
 AbsObject externalise(java.lang.Object obj, ObjectSchema schema, java.lang.Class javaClass, Ontology referenceOnto)
          Translate an object of a class representing an element in an ontology into a proper abstract descriptor
 java.lang.Object internalise(AbsObject abs, ObjectSchema schema, java.lang.Class javaClass, Ontology referenceOnto)
          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

MicroIntrospector

public MicroIntrospector()
Method Detail

externalise

public AbsObject externalise(java.lang.Object obj,
                             ObjectSchema schema,
                             java.lang.Class javaClass,
                             Ontology referenceOnto)
                      throws 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:
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(AbsObject abs,
                                    ObjectSchema schema,
                                    java.lang.Class javaClass,
                                    Ontology referenceOnto)
                             throws UngroundedException,
                                    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:
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,
                       Ontology onto)
                throws OntologyException
Check the structure of a java class associated to an ontological element to ensure that translations to/from abstract descriptors and java objects (instances of that class) can be accomplished by this introspector. This is the case if javaClass implements the Introspectable

Specified by:
checkClass in interface Introspector
Parameters:
schema - The schema of the ontological element
javaClass - The java class associated to the ontologcal element
onto - The Ontology that uses this Introspector
Throws:
OntologyException - if the java class does not have the correct structure


JADE