Modifying Java Options

Stylus Studio allows you to modify settings for

  • Java virtual machine (JVM) used by Stylus Studio
  • Stylus Studio Java debugger. (See Debugging Java Files for more information on this topic.)
  • Java compiler
  • External Java virtual machine

If you do not make any changes to these settings, Stylus Studio looks in the registry to determine the locations of your Java components.

This section covers the following topics:

About Java Virtual Machine Options

When Stylus Studio needs to execute Java code as part of the application of a stylesheet, it loads the Java Virtual Machine (JVM) that is in the run-time library specified in the Java Virtual Machine options page. To open this page, select Tools > Options from the Stylus Studio menu bar, and then click Application Settings > Java Virtual Machine.

On the Java Virtual Machine page, you can modify the following options:

  • Enabled indicates whether Stylus Studio loads a JVM. If you do not need a JVM, you can disable this option so that Stylus Studio requires less memory.
  • Runtime Library location. To specify an alternate location, type a new path or click Browse .
  • JDK Home Directory for your Java Development Kit (JDK). To specify a new home directory, type the value or click Browse.
  • Classpath used by JVM in Stylus Studio. To add a directory or .jar file to this class path, click Browse. For Stylus Studio to be able to find a Java class, its location must be specified in this classpath.

Note

 

This value does not affect the CLASSPATH environment variable. The default value, $(classpath), specifies that you want to use the contents of the CLASSPATH environment variable. There is no requirement for this class path and the class path used by the Stylus Studio Java compiler to be identical. However, it is good practice for them to be the same.

  • Parameters specifies the parameters for starting the JVM in the context of Stylus Studio.

Note

 

As a rule, you should never change the default value. This option exists to accommodate unusual configurations. In such situations, Stylus Studio Technical Support might instruct you to change this value.

Resetting Options

If you modify the Stylus Studio Java Virtual Machine options and then decide you want to return to the default values, click Auto detect to reset the options.

About Java Compiler Options

When you use Stylus Studio to compile Java classes, you can specify a number of options on the Java Compiler page. To open this page, select Tools > Options from the Stylus Studio menu bar, and then click Module Settings > Java > Java Compiler.

On the Java Compiler page, you can modify the following options:

  • Java Compiler is the location of the Java compiler that Stylus Studio uses. To change the location, type a path in the field or click Browse to the right of the field.
  • ClassPath used by Java compiler in Stylus Studio. To add a directory or .jar file to this class path, click Browse to the right of the field. For Stylus Studio to be able to find a Java class, its location must be specified in this class path.

Note

 

This value does not affect the CLASSPATH environment variable. The default value, $(classpath), specifies that you want to use the contents of the CLASSPATH environment variable. There is no requirement for this class path and the class path used by the Stylus Studio JVM to be identical. However, it is good practice for them to be the same.

  • Parameters specifies the parameters for running the Java compiler. Typically, you want to specify the -g parameter, which instructs the compiler to add debugging information to the generated .class file.

About External JVM Options

When Stylus Studio executes Java code as a standalone application, it uses the JVM that is specified in the External JVM options page. To open this page, select Tools > Options from the Stylus Studio menu bar, and then click Module Settings > Java > External JVM.

On the External JVM page, you can modify the following options:

  • External JVM identifies the location of the JVM you want to run.
  • Additional ClassPath used by this external JVM. To add a directory or .jar file to this class path, click Browse to the right of the field. For Stylus Studio to be able to find a Java class, its location must be specified in this class path.

Note

 

This value does not affect the CLASSPATH environment variable. The default value, $(classpath), specifies that you want to use the contents of the CLASSPATH environment variable. There is no requirement for this class path and the class path used by the Stylus Studio Java compiler to be identical. However, it is good practice for them to be the same.

  • Parameters specifies the parameters for starting this external JVM.

Note

 

As a rule, you should never change the default value. This option exists to accommodate unusual configurations. In such situations, Stylus Studio Technical Support might instruct you to change this value.

  • Display Console Window allows you to view processing information in a console window.
Resetting Options

If you modify the Stylus Studio External JVM options and then decide you want to return to the default values, click Auto detect to reset the options.

How to Modify Java Settings

To modify Java settings:
1. From the Stylus Studio menu bar, select Tools > Options.
2. Click one of the following:
3. Make your changes and click OK.

If the JVM is not already loaded, any changes you make take effect immediately. If the JVM is already loaded in Stylus Studio, you must restart Stylus Studio for the changes to take effect.

 
Free Stylus Studio XML Training: