More on this in detail at a later point, but, ... I would suggest checking this out.

XPages Extensibility APIs Developer Guide : Learn more about Controls and Libraries http://ow.ly/1SVN4