Home >
Online Product Documentation >
Table of Contents >
Modifying Java Options
Modifying Java Options
Stylus Studio allows you to modify settings for
- Java virtual machine (JVM) used by Stylus Studio
- 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.
|
|
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:
|
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.
|
|
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
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.