This is an old revision of the document!


SOLoist Explorer

SOLoist Explorerâ„¢ is a simple tool that provides a HTTP interface for:

  • writing and executing OQL queries (results in HTML or Excel sheet; see generated SQL, etc.)
  • browsing the UML model
  • browsing the object space

It is implemented as a servlet in the SOLoist library.

Basic Installation

The servlet should be added to web.xml of your web application:

<servlet>
	<servlet-name>OQLServlet</servlet-name>
	<servlet-class>rs.sol.soloist.server.server.OQLServlet</servlet-class>
</servlet>
 
<servlet-mapping>
	<servlet-name>OQLServlet</servlet-name>
	<url-pattern>/oql</url-pattern>
</servlet-mapping>

The servlet will be accessible at the given URL, e.g. http://localhost:8080/MyWebApplication/oql.

Advanced Installation

Authentication

OQLServlet provides no authentication mechanism whatsoever. You should use application specific filters (e.g. LoginFilter from EmptyProject).

Customization

OQLServlet supports the following init parameters:

  • title - Text to be used as the page title (default: SOLoist Explorer).
  • stylesheet - URL of the external CSS stylesheet to be used instead of the default style.
  • method - HTTP method used for HTML form submission. Values: GET (default) or POST.

Example: <xml file> <servlet>

<servlet-name>OQLServlet</servlet-name>
<servlet-class>rs.sol.soloist.server.server.OQLServlet</servlet-class>
<init-param>
	<param-name>method</param-name>
	<param-value>GET</param-value>
</init-param>

</servlet> </xml>

Print/export