Previous Topic  Next Topic

Creating and Getting Instances of Report Engine and Report Server

This topic describes how to create and get instances of the Report Engine and Report Server.

Creating and Getting Instances of the Report Engine

To get an instance of the Report Engine, you can use the method getInstance() or getInstance(boolean setDebugLevel) in the jet.server.api.engine.ReportEngineFactory interface.

For example,

bean = ReportEngineFactory.getInstance();

or,

bean = ReportEngineFactory.getInstance(true);

Creating and Getting Instances of Report Server

You can use the following methods to get access to the instance of Report Server. Report Server is a singleton - only one instance can exist in the system. Access to the server is through a returned RptServer object or a returned HttpRptServer object, depending on the environment of the request to get access. RptServer is designed to be instantiated in a Java Application while HttpRptServer is designed to be instantiated in a JSP page. HttpRptServer has a few extra methods available to use in the HTTP session.

Method 1

Use the method jet.server.api.http.HttpUtil.initEnv(Properties props).

The method jet.server.api.http.HttpUtil.initEnv() creates and initializes the HttpRptServer object. If the HttpRptServer has already been started in this application, it will use the existing HttpRptServer instance. Use this method to avoid creating more than one HttpRptServer instance.

    //  Prepare report server initial properties.
    //  Set reporthome minimally.
    //  System.getProperties() will bring in all configured settings.
  System.getProperties().put("reporthome", "C:\\LogiReport\\Server");

					
    //  Create instance of ReportServer or do nothing if one is running already in this JVM
  HttpUtil.initEnv(System.getProperties());

    
  HttpRptServer server = HttpUtil.getHttpRptServer();

   
    // Do something using the returned server object.

Method 2

Call the method HttpUtil.checkLogin(HttpServletRequest req, HttpServletResponse res).

The method jet.server.api.http.HttpUtil.checkLogin() implicitly calls HttpUtil.initEnv(). So, you can get the HttpRptServer after calling HttpUtil.checkLogin().

    // Use checkLogin to control access to the rest of the code in JSP file.
  if (HttpUtil.checkLogin(request, response))
    {
        // When a Report user signs in to the current session

        // get the instance of HttpRptServer.
    jet.server.api.http.HttpRptServer httpRptServer = HttpUtil.getHttpRptServer(); 

    // Do something using the returned httpRptServer object.
    }

Previous Topic  Next Topic