Servlet classes

The IlvDiagrammerServlet class in the package ilog.views.diagrammer.servlet is a concrete servlet class that handles HTTP requests to build an image of the diagram.

This class accepts one parameter: the project file which refers to the XML data file and the style sheet on which the diagram is based.

This parameter can be specified at initialization time (as a static configuration parameter of the servlet) or dynamically in the request URL.

The JViews Diagrammer servlet can work in two modes, depending on the value of the multiSession configuration parameter:

Mono-session mode: If multiSession is false, only one SDM engine and one SDM view (and one grapher) are created. All the requests to the servlet return an image of the same shared diagram. This option is appropriate if the users are not allowed to modify the contents of the diagram or if the changes should be visible by all users.

Multi-session mode: If multiSession is true, a new SDM engine (with its associated SDM view and grapher) is created for every different client session connected to the servlet. This mode is appropriate if users are allowed to modify the XML file or the style sheet.

The class IlvDiagrammerServlet provides support for client-side image maps. The image map can be used to attach actions to every node or link displayed in the diagram.

The class IlvDiagrammerServlet is a subclass of IlvManagerServlet that is using the same protocols as IlvDiagrammerServlet to communicate with clients.

The class IlvDiagrammerServletSupport is a subclass of IlvManagerServletSupport. This class implements the functionality of the JViews Diagrammer servlet but is not a servlet itself.

The purpose of IlvDiagrammerServletSupport is to let you build “multiplexing” servlets that can handle requests for images, but also other kinds of requests that call other parts of your application.

The class IlvDiagrammerServlet is a facade that forwards requests to the class IlvDiagrammerServletSupport.