In most cases, when you modify a Java class definition during development, you need to not only recompile the class, but also to reassemble your application to load the new class definition. Nucleus can also use a disposable Class Loader to instantiate components and to resolve class names in general, which under some circumstances you may be able to use to reduce the number of times you need to reassemble your application during development. This disposable Class Loader loads classes from one or more directories defined by the atg.nucleus.class.path system variable. The value of this variable is a comma-delimited list of directories or URLs. These classes must not exist in the regular CLASSPATH; if they do, they will be loaded by the regular class loader and will not be reloadable. Nucleus then uses a special disposable Class Loader to load the classes specified by atg.nucleus.class.path, if it cannot find those classes in the regular CLASSPATH.
To use the Class Loader:
Be careful to segregate the classes you’re changing in their own build directory tree, outside the CLASSPATH.
Specify that build tree in the
atg.nucleus.class.pathsystem variable. You can do this by adding the following Java argument to yourenvironment.shorenvironment.batfile:set JAVA_ARGS=
%JAVA_ARGS% -Datg.nucleus.class.path=file:/path/to/build/treeThe value of the
atg.nucleus.class.pathsystem variable is a comma-delimited list of URLs. For example, it might look like this in Windows:set JAVA_ARGS=%JAVA_ARGS% -Datg.nucleus.class.path=
file:///C:\ATG\Dynamo\MyFiles,file:///C:\Zapf\Dynamo\YourFilesor like this in UNIX:
JAVA_ARGS="-Datg.nucleus.class.path=
file:///work/ATG/Dynamo/MyFiles,file:///relax/Zapf/Dynamo/YourFiles
${JAVA_ARGS}"When you change a class, remove from Nucleus any instances of that class. You can do this by selecting each such component in the ATG Control Center Components window by selecting File > Stop Component or by right-clicking on the component and selecting Stop Component from the pop-up menu.
Select Tools > Make New Class Loader in the ATG Control Center Components window.
Note that the disposable class loader will not work with any code that uses java.lang.Class.forName to resolve a class, such as Relational Views.
