Configuring a custom Java Components web application
Java Components’s configuration determines many of its essential methods. Configuring your web application customizes how it operates internally, as well as having an effect on the user’s experience.
Perform cosmetic customization tasks using the Actuate Java Components style sheets, as described in Modifying global style elements.
Customizing Java Components configuration
You set configuration parameters for the Java Components application to tune performance and to control service and application execution.
You configure the Java Components application by changing configuration file contents, such as web.xml. To understand the common configuration files and how each of their entries affect Java Components, see Actuate Java Components configuration.
The following section describes the customization procedure using the text editor.
How to customize Java Components configuration parameters
Use the following procedure to customize configuration parameters for Java Components. In this procedure, it assumed that web.xml is the configuration file.
1 Extract the contents of the Actuate Java Component WAR or EAR file into a temporary directory.
2 Make a backup copy of web.xml.
3 Using a text editor that supports UTF‑8 encoding, edit web.xml to change parameter values. Parameter definitions use the following format:
<param-name><keyword></param-name>
<param-value><value></param-value>
where
<keyword> is the name of the parameter.
<value> is the parameter value.
Do not enclose the keyword and value within quotes, and use no spaces between <param-name>, the keyword or value, and </param-name>. For example, the definition for the default locale parameter is:
<param-name>DEFAULT_LOCALE</param-name>
<param-value>en_US</param-value>
4 Save web.xml.
5 Recompress your Java Components WAR file using the Java jar utility and redeploy it to the application server or servlet engine as an application.
6 Restart the application server or servlet engine that runs Java Components.
How to set a default Java Components locale and time zone
The default locale and timezone for Java Componentss are set when you install it. To change the default settings, you modify the values of the DEFAULT_LOCALE and DEFAULT_TIMEZONE configuration parameters.
1 Extract the contents of the Actuate Java component WAR or EAR file into a temporary directory.
2 Using a UTF-8 compliant code editor, open the web.xml configuration file.
3 Navigate to the lines that define DEFAULT_LOCALE, similar to the following code:
<param-name>DEFAULT_LOCALE</param-name>
<param-value>en_US</param-value>
Change the current locale id, en_US in the above example, to the desired locale id in param-value. Valid locale id strings are listed in <context root>\WEB‑INF\localemap.xml.
4 Navigate to the lines that define DEFAULT_TIMEZONE, similar to the following code:
<param-name>DEFAULT_TIMEZONE</param-name>
<param-value>America/Los_Angeles</param-value>
Change the current time zone id, Pacific Standard Time in the above example, to the desired default time-zone in param-value. Valid time zone id strings are listed in <context root>\WEB-INF\TimeZones.xml.
5 Save web.xml.
6 Recompress your Actuate Java Component WAR or EARfile using the Java jar utility and redeploy it to the application server or servlet engine as an application.
7 Restart the application server or servlet engine that runs Java Components.
<keyword> is the name of the parameter.