Setting Server Reporthome and Properties in a Java EE Environment

The jet.server.api.http.CustomizedServerEnv interface can be used for specifying the Logi JReport Server reporthome and for setting the server properties in a Java EE environment. It contains two methods:

String getReportHome()
Properties getServerProperties()

If you specify the implementation of this interface, Logi JReport Server will obtain not only reporthome but also server properties. The properties returned from getServerProperties() can be the properties listed in server.properties file in the directory <install_root>\bin, JVM System properties, or self-defined ones.

Logi JReport Server will retrieve the reporthome and properties from your implemented class when the WAR/EAR file has been deployed.

Below is a list of the sections covered in this topic:

Using the Default Implementations of CustomizedServerEnv
Using a Customized Implementation of CustomizedServerEnv

Using the Default Implementations of CustomizedServerEnv

The self-contained Logi JReport Server provides two implementations of CustomizedServerEnv. They are jet.server.DefaultServerEnv and jet.server.MultipleInstanceServerEnv.

jet.server.DefaultServerEnv

If you use this implementation, you will not need to specify it in the target web.xml in the makewar.xml or in ejb-jar.xml, since it can find the customized reporthome from the <context-param></context-param> tags of the target web.xml or the <env-entry></env-entry> tags of web.xml or ejb-jar.xml.

jet.server.MultipleInstanceServerEnv

This is an internally implemented class of the jet.server.api.http.CustomizedServerEnv interface which supports multiple Logi JReport Server instances in one Java EE application server. The reporthome of each instance can be assigned by the class automatically.

This implementation is extended from DefaultServerEnv. It enables finding the reporthome not only from the <context-param></context-param> or <env-entry></env-entry> tags, but also from an external file <user.home>/.Logi JReportrc. However, this implementation has three main limitations. They are:

This implementation must be clearly specified with the <env-entry></env-entry> tags in the target web.xml in the makewar.xml or in ejb-jar.xml as follows:

<env-entry>
    <env-entry-name>Logi JReport.servenv</env-entry-name>
    <env-entry-value>jet.server.MultipleInstanceServerEnv</env-entry-value>
    <env-entry-type>java.lang.String</env-entry-type>
</env-entry>

The Logi JReport Server must be initialized with JRServerContextListener from a Web module.
Since in cases of deploying multiple Logi JReport Server instances in one Java EE application server without touching the WAR, such as extracting the WAR, setting reporthome and rebuilding the WAR, Logi JReport Server has to use ServletContext to generate an ID for every instance. Logi JReport Server retrieves javax.servlet.context.tempdir from ServletContext by invoking the getAttribute(String) method, and then uses this value to generate the instance ID.
For detailed information, see Java Servlet Specification Version 2.3/2.4 SRV.3.7.1 Temporary Working Directories.
The <user.home>/.Logi JReportrc file must be created by Logi JReport Server. You can only edit the file to change the reporthome after the Logi JReport Server initialization.
Since the instance ID is generated based on a hash code retrieved from javax.servlet.context.tempdir, it cannot be pre-assigned, and is therefore impossible for you to create the <user.home>/.Logi JReportrc file. However, once the file has been created, you can edit it to change the reporthome for each instance. The RC file can hold multiple records. The record format should be as follows:
Logi JReport.rpthome.<instanceID>=the-instance-report-home
The instanceID is created by Logi JReport Server during its first initializing. It is a string of HEX encoded hash value. For example:
Logi JReport.rpthome.12345678=/home/user1/.Logi JReport/instance.12345678
Logi JReport.rpthome.12345abc=/home/user1/.Logi JReport/instance.12345abc
If Logi JReport Server cannot get the reporthome from CustomizedServerEnv, it will create a default reporthome in <user.home>/.Logi JReport/default.

The following is an example of specifying reporthomes when deploying multiple server instances using jet.server.MultipleInstanceServerEnv:

In the file makewar.xml, use the <env-entry></env-entry> tags to specify jet.server.MultipleInstanceServerEnv in the target "web.xml". For example:

<env-entry>
    <env-entry-name>Logi JReport.servenv</env-entry-name>
    <env-entry-value>jet.server.MultipleInstanceServerEnv</env-entry-value>
    <env-entry-type>java.lang.String</env-entry-type>
</env-entry>

Since different Logi JReport instances cannot access the same Logi JReport Server system database at the same time, you will need to create a dbconfig.xml file to store the connection information, and put it in jrenv.jar in workspace\bin (you can find the jrenv.jar file after extracting Logi JReport.war) for each Logi JReport Server WAR/EAR.
For detailed information about modifying the dbconfig.xml, see Configuring the Server Database.
When the Logi JReport Server WAR/EAR has been deployed, Logi JReport will create a file .Logi JReportrc in <user.home>, and each Logi JReport instance will read its reporthome from this file. This file must be created by Logi JReport Server, however, you can edit it in order to change the reporthome after it has been created.

Using a Customized Implementation of CustomizedServerEnv

You can implement the interface and add your class to the generated WAR/EAR file, then use the <env-entry></env-entry> tags to specify your implemented class in the target web.xml in the makewar.xml file or in ejb-jar.xml.

The following shows an example. Here the customized implementation of CustomizedServerEnv is named my.Logi JReportServerEnv.

<!-- Logi JReport Server calls my.Logi JReportServerEnv to obtain reporthome and server properties.-->
<env-entry>
    <env-entry-name>Logi JReport.servenv</env-entry-name> <!-- must be Logi JReport.servenv-->
    <env-entry-value>my.Logi JReportServerEnv</env-entry-value> <!-- your class name --> 
    <env-entry-type>java.lang.String</env-entry-type>
</env-entry>

Previous Topic Next Topic