number of ratings	0
average rating	0.00

Appendix B - Startup properties

The startup.properties file is a key file in controlling the behaviour of an application. This appendix documents the parameters in the startup file.

Properties

The list below contains the basic set of properties used by Carousel. The properties file is a generic mechanism and can be used for other purposes such as application specific variables and therefore it cannot be guaranteed that this is an exhaustive list of values that can be found in the startup file .

Table B-1 - Startup properties

Property	Role
UseWindow	(true|false) Toggles use of a separate Window for the application. With a Window the application does not appear in the normal frame of the applet viewer and can appear as though it occupies the fullscreen (depending on the values of ClientWidth and ClientHeight).
ClientWidth	Width of the applet or application window in pixels, defaults to 640
ClientHeight	Height of the applet or application window in pixels, defaults to 480
StartPackage	The name of the package in which the page implementations are found e.g. com.mycompany.mypackage
StartClass	The name of the start page or the first page that is displayed. e.g. Welcome . The page name is qualified by prefixing it with the StartPackage name.
Title	The application title, shown on the main window.
StyleFile	The name of the file containing the style definitions, by default this is styles.xml
ModelData	The name of the file listing the datasets used by the application, by default this is datasets.xml
CenterWin	A boolean value (true|false) indicating whether or not the application window is to be centered on screen.
XDataSourceClass	The name of the class that implements the datasource, by default this is net.xoetrope.optional.data.XOptionalDataSource
XLibVisualise	A boolean indicating whether or not to show the visualizer. The visualizer allows you to see the data in the model at runtime.
Validations	The name of the file containing the validation rules, by default this is validations.xml
ValidationFactory	The name of an alternative validation factory class.
LogLevel	An integer value indicating the logging level used by the debug version of the application.
LifeCycleListener	The name of a class that implements the XLifeCycleListener interface. This interface is used to perform special shutdown operations.
ComponentRegistry	The name of the XML file containing component registry information.
NumComponentFactories	Specify the extra component factories to use and the source of registry info
ComponentFactory0	An entry like this is used for each component factory and names the class that implements the component factory.
DefaultModelClass	Sets the default model class. Normally this is XBaseModel . The model class has a major role in Carousel applications and any changes to this parameter should be undertaken with caution.

And some properties introduced with XUI 2.0:

Table B-2 - Startup parameters introduced in version 2.0 of XUI

Property	Role
LAF 1	The class name of a Look and Feel installer. A look and feel installer includes a static method installLAF that carries out whatever steps are needed to install the look and feel. The method is called when the application first starts.
SynthConfigFile	The file used by the Synth look and feel for its configuration.
SynthResourceLoader	The class used by the Synth look and feel to load the resources referenced in the Synth configuration file.
ProjectPath	The root path of the project. This property is generated dynamically and does not appear in the properties file and is instead set during startup.

1 Swing only

comments

If you were logged in you could rate this article or add a comment.