The nGenera Toolkit for Java can be accessed here.

The toolkit consists of a number of classes that help the developer access the platform, as well as a Servlet that can be extended to automatically authenticate within the nGenera services ecosystem.

Instructions for use:

1. Extend BaseAuthenticatedServlet: 

public class SampleServiceServlet extends BaseAuthenticatedServlet {

2. BaseAuthenticatedServlet uses reflection to dynamically route RESTful calls to methods within your Servlet. As long as you obey the conventions, there will be no extra configuration required.

Example 1:

http://path.to.servlet/myresource/param1/param2

maps to:

get_myresource(HttpServletRequest, HttpServletResponse, String, String)

Example 2:

http://path.to.servlet/xxx/anotherresource/

maps to:

get_anotherresource(HttpServletRequest, HttpServletResponse) 

Example 3 - if you wish to post to your servlet:

http://path.to.servlet/oldresource

maps to:

post_oldresource(HttpServletRequest, HttpServletResponse)

 

Because the reference architecture dictates that a GET to the Base URL of your service should return the API, BaseAuthenticatedServlet provides a default resource in the case where none is included in the URL. This method should be extended to return a human-readable copy of the API for your service.

Example 4:

http://path.to.servlet/

maps to:

get_description(HttpServletRequest, HttpServletResponse)