2.3 Setting the Cloudtran Preferences

2.3.1  The Cloudtran Preferences

You do this via the overall preferences page by clicking

Window -> Preferences

Select the Cloudtran preferences on the left-hand side:

There is only one change you must make - set the "GigaSpaces Home" value.

1. JeeWiz Home

   This is the directory of the JeeWiz installation, which is the generation engine underneath CloudTran. The default value points to a run-time copy of JeeWiz in the builder plugin. There is no need to alter this value unless you install a standalone version of JeeWiz onto your system.

   You may want to copy the JeeWiz directory higher up the filesystem to shorten path lengths. If you do this, you will have to copy the directory from the location shown here to its new location, then change this entry.

2. GigaSpaces Home

   Initially this value will be blank: there is no default. This value is required if you want to compile or run the generated GigaSpaces application; it is not required just to do modelling. Point this to the home directory of your GigaSpaces installation, e.g. C:\gigaspaces-xap-premium-8.0.2-ga.

   See the prerequisites for more information on installing GigaSpaces.

3. Java Home

   This is the location of your JDK. This must be version 1.6 (aka Java SE 6) or above.

   This field sets the 'JAVA_HOME' property for JeeWiz builds.

4. Custom Template Directory

   You don't need to worry about this at first. Having used the Cloudtran, you (or your architect) may want to change the way it works. If you have some custom templates that apply to all projects, you can put them in a directory and point to that directory in this entry. When you do this, the templates in this directory will override the corresponding ones in the standard product.

   The Cloudtran uses a stack of template directories, which will all be beneath the resources/ directory of the JeeWiz Home property described above. The complete list is

   ${customTemplateDirectory}
   resources/cloudtran/control
   resources/roundTripping/control
   resources/bizobject/control
   resources/java/control
   resources/convert-base/control
   resources/base/control

   This will at least give you a place to start looking. If you want to implement a specific customisation, post a question on the Cloudtran forum.

   You can also use the customization feature for an individual project by setting the customTemplateDirectory property for an application object in the model; see the customTemplateDirectory property documentation.

2.3.2  Generate-Time Preferences

To bring up the generate-time settings click

Window -> Preferences -> CloudTran -> Generate Time Settings

There are a number of preferences that can be amended in this section. They are

1. Ant Log Level

   This field applies to events during the build, from the JeeWiz generator; it alters the level of logging that will be output during the generation.

   By default, the generator logs significant events (e.g., directory creation, or generation of the final output file). The default is 'Info' level. 'Verbose' and 'Debug' give increasing levels of logging.

   The Verbose level is sufficient to diagnose most problems. The Debug level produces much more output, and is a last resort.

   By default the log is sent to the console window. For verbose and debug levels, you will probably need to send the log output to a text file via the 'Create Log File' option.

   This field sets the '-verbose' and '-debug' flags to the invoked Ant. This will normally be necessary if Verbose or Debug generate logging levels are used.

2. Create Log File

   Sends the logging from the generation process to an output file, rather than to the console.

3. Log File

   This defines the file that logging is to be sent to, if the "Create Log File" tickbox is checked. A relative file specification will be relative to the Eclipse project directory.

4. Generate Log Level

   This defines how much logging and tracing is generated in the code. This is different from the 'Ant log level' above; there is no relation between the two. The options are:

   • Info This level of logging is used for significant non-error events, like the application being ready to start.
   • Debug This is used for normal events in main-line processing code, like a file being successfully opened or an entry being written into a space.
   • Detailed Debug This is used for highly detailed events. This will record all method entries and exits, and (if a method has requested it) log the return value from methods that return a value. From detailed debug level trace, it should be possible to trace most of the flow of an application
5. Create Aggregate Specification File

   If set, the JeeWiz generator engine will create a file containing the aggregate specification. The "aggregate specification" is the original specification, in simple XML format, plus any XML added by executable patterns. This gives a complete 'platform-specific model' plus any embedded code.

   In addition, the aggregate specification file contains cross-reference information on the templates used, the objects firing executable patterns and the objects they create, and the Velocity methods declared on model objects.

   Getting the aggregate specification file is useful for pattern developers to debug patterns.

6. Aggregate Specification File

   This is the path for the aggregate specification file.