CallBacks Class Reference

Inherit from this class and override some or all of the methods for informative and error handling callbacks. More...

#include <CallBacks.h>

List of all members.

Public Member Functions

virtual void categoryLoaded ()
 During the loadtime of AIML data this is called after each AIML category is loaded.
virtual void filePostLoad (const char *const fileName)
 During the loadtime of AIML data this is called after a file is parsed for AIML tags.
virtual void filePreLoad (const char *const fileName)
 During the loadtime of AIML data this is called before a file is parsed for AIML tags.
virtual void infiniteSymbolicReduction ()
 When srai AIML tags cause an infinite recursion, the infinite recursion is automatically terminated and this method is called.
virtual void inputTagNumericConversionError (const char *const message)
 When the AIML tag Input has a value inside of its index attribute which is not a numeric value, this method is called.
virtual void inputTagSizeExceeded ()
 When the AIML tag Input's index exceeds its size, this method is called.
virtual void starTagNumericConversionError (const char *const message)
 When the AIML tag Star has a value inside of its index attribute which is not a numeric value, this method is called.
virtual void starTagSizeExceeded ()
 When the AIML tag Star's index exceeds its size, this method is called.
virtual void storeGossip (const char *const gossip)
 Stores gossip from the aiml gossip tag.
virtual void symbolicReduction (const char *const symbol)
 After text in between srai tags is constructed, the text is sent to this callback.
virtual void thatStarTagNumericConversionError (const char *const message)
 When the AIML tag ThatStar has a value inside of its index attribute which is not a numeric value, this method is called.
virtual void thatStarTagSizeExceeded ()
 When the AIML tag ThatStar's index exceeds its size, this method is called.
virtual void thatTagNumericConversionError (const char *const message)
 When the AIML tag That has a value inside of its index attribute which is not a numeric value, this method is called.
virtual void thatTagSizeExceeded ()
 When the AIML tag That's index exceeds its size, this method is called.
virtual void topicStarTagNumericConversionError (const char *const message)
 When the AIML tag Topic has a value inside of its index attribute which is not a numeric value, this method is called.
virtual void topicStarTagSizeExceeded ()
 When the AIML tag TopicStar's index exceeds its size, this method is called.
virtual void XMLParseError (const char *const message)
 When a XML Parse Error is encountered during the parsing of the AIML tags this method will be called.
virtual void XMLParseFatalError (const char *const message)
 When a XML Parse Fatal Error is encountered during the parsing of the AIML tags this method will be called.
virtual void XMLParseWarning (const char *const message)
 When a XML Parse Warning is encountered during the parsing of the AIML tags this method will be called.
virtual ~CallBacks ()
 No operations Destructor.


Detailed Description

Inherit from this class and override some or all of the methods for informative and error handling callbacks.

You can pick and choose which callbacks you want to do something about by only overriding the callback methods that you feel like doing something about. The remaining methods you do not override will then just remain the default no-ops (no operations) and do nothing.

After you create your custom subclass of CallBacks, you instantiate it and call GraphBuilder's method setCallBacks GraphBuilder::setCallBacks() giving it the address of your custom subclass of CallBacks. GraphBuilder will NOT try to delete your subclass. You are responsible for the memory management of your CallBacks subclass.

If you do not override this class and call GraphBuilder's setCallBacks with the address of your instance, then the default one inside GraphBuilder will be used. The default CallBacks is an instantation of this no-ops (No operations) class. Therefore nothing will happen when each method is called and is thus the default behavior.


Constructor & Destructor Documentation

virtual ~CallBacks  )  [inline, virtual]
 

No operations Destructor.

Put what you need in here when you subclass CallBacks.


Member Function Documentation

virtual void categoryLoaded  )  [inline, virtual]
 

During the loadtime of AIML data this is called after each AIML category is loaded.

This enables an action to be performed after each category is loaded such as counting the categories and periodically outputing that "x" number of categories has been loaded so far.

This callback will only be called during a call to GraphBuilder::createGraph().

Exceptions:
Any can be thrown.

virtual void filePostLoad const char *const   fileName  )  [inline, virtual]
 

During the loadtime of AIML data this is called after a file is parsed for AIML tags.

This enables an action to be performed after each file is loaded such as outputing that "file x" was loaded or to count the amount of time a file takes to load using CallBacks::filePreLoad in conjunction.

This callback will only be called during a call to GraphBuilder::createGraph().

Parameters:
fileName The name of the file that was just parsed for AIML tags.
Exceptions:
Any can be thrown.

virtual void filePreLoad const char *const   fileName  )  [inline, virtual]
 

During the loadtime of AIML data this is called before a file is parsed for AIML tags.

This enables an action to be performed before each file is loaded such as outputing that "file x" is loading or to count the amount of time a file takes to load using CallBacks::filePostLoad in conjunction.

This callback will only be called during a call to GraphBuilder::createGraph().

Parameters:
fileName The name of the file that is about to be parsed for AIML tags.
Exceptions:
Any can be thrown.

virtual void infiniteSymbolicReduction  )  [inline, virtual]
 

When srai AIML tags cause an infinite recursion, the infinite recursion is automatically terminated and this method is called.

This method can be used to send an informative message that the AIML tags have infinite recursion with the srai tags or to just detect the issue. You DO NOT have to worry about trying to terminate the recursion yourself. The recursion is automatically terminated.

This callback will only be called during a call to GraphBuilder::getResponse().

Exceptions:
Any can be thrown.

virtual void inputTagNumericConversionError const char *const   message  )  [inline, virtual]
 

When the AIML tag Input has a value inside of its index attribute which is not a numeric value, this method is called.

This is useful to output when the AIML tag Input during load time has invalid numeric values for its index.

This callback will only be called during a call to GraphBuilder::createGraph()

Parameters:
message A informatative message of the error for humans
Exceptions:
Any can be thrown.

virtual void inputTagSizeExceeded  )  [inline, virtual]
 

When the AIML tag Input's index exceeds its size, this method is called.

This is useful to output when the AIML tag Input during runtime is exceeding its size for informational purposes or to aid in debugging AIML tags.

This callback will only be called during a call to GraphBuilder::getResponse()

Exceptions:
Any can be thrown.

virtual void starTagNumericConversionError const char *const   message  )  [inline, virtual]
 

When the AIML tag Star has a value inside of its index attribute which is not a numeric value, this method is called.

This is useful to output when the AIML tag Star during load time has invalid numeric values for its index.

This callback will only be called during a call to GraphBuilder::createGraph()

Parameters:
message A informatative message of the error for humans
Exceptions:
Any can be thrown.

virtual void starTagSizeExceeded  )  [inline, virtual]
 

When the AIML tag Star's index exceeds its size, this method is called.

This is useful to output when the AIML tag Star during runtime is exceeding its size for informational purposes or to aid in debugging AIML tags.

This callback will only be called during a call to GraphBuilder::getResponse()

Exceptions:
Any can be thrown.

virtual void storeGossip const char *const   gossip  )  [inline, virtual]
 

Stores gossip from the aiml gossip tag.

Whenever the gossip tag is encountered during the runtime of rebecca aiml, this callback is called. This gives the opportunity to store gossip into a flat file, or something else deemed appropriate.

The possibility of this callback being called is only during a call to GraphBuilder::getResponse().

Parameters:
gossip The final constructed text between a gossip AIML tag.
Exceptions:
Any can be thrown.

virtual void symbolicReduction const char *const   symbol  )  [inline, virtual]
 

After text in between srai tags is constructed, the text is sent to this callback.

Usually srai is used for symbolicReduction, hence the name of this callback method. This method is called before the GraphBuilder::getResponse() is called with the constructed srai text. This method is mostly useful for informative purposes of seeing what the AIML is recalling its self with during calls to GraphBuilder::getResponse().

This callback will only be called during a call to GraphBuilder::getResponse().

Parameters:
symbol The final constructed text that was constructed from between a srai AIML tag encountered.
Exceptions:
Any can be thrown.

virtual void thatStarTagNumericConversionError const char *const   message  )  [inline, virtual]
 

When the AIML tag ThatStar has a value inside of its index attribute which is not a numeric value, this method is called.

This is useful to output when the AIML tag ThatStar during load time has invalid numeric values for its index.

This callback will only be called during a call to GraphBuilder::createGraph()

Parameters:
message A informatative message of the error for humans
Exceptions:
Any can be thrown.

virtual void thatStarTagSizeExceeded  )  [inline, virtual]
 

When the AIML tag ThatStar's index exceeds its size, this method is called.

This is useful to output when the AIML tag ThatStar during runtime is exceeding its size for informational purposes or to aid in debugging AIML tags.

This callback will only be called during a call to GraphBuilder::getResponse()

Exceptions:
Any can be thrown.

virtual void thatTagNumericConversionError const char *const   message  )  [inline, virtual]
 

When the AIML tag That has a value inside of its index attribute which is not a numeric value, this method is called.

This is useful to output when the AIML tag That during load time has invalid numeric values for its index.

This callback will only be called during a call to GraphBuilder::createGraph()

Parameters:
message A informatative message of the error for humans
Exceptions:
Any can be thrown.

virtual void thatTagSizeExceeded  )  [inline, virtual]
 

When the AIML tag That's index exceeds its size, this method is called.

This is useful to output when the AIML tag That during runtime is exceeding its size for informational purposes or to aid in debugging AIML tags.

This callback will only be called during a call to GraphBuilder::getResponse()

Exceptions:
Any can be thrown.

virtual void topicStarTagNumericConversionError const char *const   message  )  [inline, virtual]
 

When the AIML tag Topic has a value inside of its index attribute which is not a numeric value, this method is called.

This is useful to output when the AIML tag Topic during load time has invalid numeric values for its index.

This callback will only be called during a call to GraphBuilder::createGraph()

Parameters:
message A informatative message of the error for humans
Exceptions:
Any can be thrown.

virtual void topicStarTagSizeExceeded  )  [inline, virtual]
 

When the AIML tag TopicStar's index exceeds its size, this method is called.

This is useful to output when the AIML tag TopicStar during runtime is exceeding its size for informational purposes or to aid in debugging AIML tags.

This callback will only be called during a call to GraphBuilder::getResponse()

Exceptions:
Any can be thrown.

virtual void XMLParseError const char *const   message  )  [inline, virtual]
 

When a XML Parse Error is encountered during the parsing of the AIML tags this method will be called.

Parameters:
message The XML Error Message
This callback will only be called during a call to GraphBuilder::createGraph().

Exceptions:
Any can be thrown.

virtual void XMLParseFatalError const char *const   message  )  [inline, virtual]
 

When a XML Parse Fatal Error is encountered during the parsing of the AIML tags this method will be called.

Parameters:
message The XML Fatal Error Message
This callback will only be called during a call to GraphBuilder::createGraph().

Exceptions:
Any can be thrown.

virtual void XMLParseWarning const char *const   message  )  [inline, virtual]
 

When a XML Parse Warning is encountered during the parsing of the AIML tags this method will be called.

Parameters:
message The XML Warning Message
This callback will only be called during a call to GraphBuilder::createGraph().

Exceptions:
Any can be thrown.


The documentation for this class was generated from the following file:
Generated on Tue Apr 4 23:39:12 2006 for RebeccaAIML by  doxygen 1.4.5