Jb: Jaimbizzle software

Quick Doc on writing a handler :)

ok, i'm working on the documentation on writing a handler...:/ in the meantime here's a (very) quickstart:

The config files:

dist/conf/JbActionMap.conf

this file contains the handler name to java class mapping. add you r handler name and the class it will correspond to.

this class will implement the handle() method on the JbActionHandler interface.

look at

dist/conf/JbActionDict.conf

this is a file where you can put in aliases for the action names, i.e. if a user mistypes "hello" as "helo", this is where you can place alternate spellings of a handler's name. for example one of the lines is:

test=tist,tizzle,teezo,t

if a user sends an IM to your bot with the word "tist" or "t" or "tizzle" or "teezo", it would look up the class corresponding to the "test" handler in JbActionMap.conf. (thinking out loud wouldn't it be neat to just implement a fuzzy matching system in here?)

the Handlers:
look in the

dist/conf/handlers dir

there you'll find the various config for handler files. these can be named basically anything, as long as you refer to them in the handler you write. the values can be anything as well, they're just basic java properties files to help you to not hardcode everything.

writing a handler quickstart:
as stated above, handlers should implement the JbActionHandler interface, which has only one method, handle(JbAction). a JbAction is pretty simple--it consists of a name and data. the name portion corresponds to a name in the JbActionMap.conf file, and the data is any other data that you'll be passing to your handler.

i have to go right now, but hopefully that's a quick start. please leave any questions in the comments section below. thanks!

j.

Posted by Jon at May 23, 2003 06:56 AM