To make it simpler to use as an end user, we've created a JBI Client API which makes it easy to work with any JBI container and other JBI components.
The JavaDoc is probably self evident for many things, especially if you are aware of the JBI APIs. There is an example test case which shows many of these APIs in action.