Updating the Grasshopper .NET Framework

The Grasshopper .NET Framework is a set of JAR files, which implement the .NET Framework APIs on top of the J2EE platform. You may want to update Grasshopper .NET Framework either with a newer version of an already existing JAR file, or with a new JAR that should be added to the framework.

The following steps should be performed in order to update an existing JAR file with a newer version:

1. Copy the JAR file to the <Visual MainWin_install_dir>\jgac\vmw4j2ee_110 folder.

2. Restart Visual Studio .NET.

3. In Visual Studio .NET, go to the Application Servers page under Tools > Options > Visual MainWin > Java Environment and use the Update button to update the configured application servers, to include the new Visual MainWin Framework.

The following steps should be performed in order to add a new JAR file to the Grasshopper .NET Framework.

1. Copy the JAR file to the <Visual MainWin_install_dir>\jgac\vmw4j2ee_110 folder.

2. Make sure that the settings.xml file, located inside the <Visual MainWin_install_dir>\jgac folder, is not read-only.

3. Edit the settings.xml file:

   1. Locate the <package> element for the J2EE Helpers:

      <package readonly="true"
      	  identity="j2ee.helpers" local="true"
      	  dllname="J2EE.Helpers.dll">
      	  <jar>J2EE.Helpers.jar</jar>
      </package>
      

   2. Add a new <package> section, and set the identity, dllname and jar fields to those of your package. For example, to add the System.DirectoryServices component, add the following:

      <package readonly="true" 
      	  identity="system.directoryservices" 
      	  dllname="System.DirectoryServices.dll">
      	  <jar>System.DirectoryServices.jar</jar>
      	  <jar>Novell.Directory.Ldap.jar</jar>
      </package>
      

      Note: In the example above, the System.DirectoryServices.dll is implemented in two jars, System.DirectoryServices.jar and Novell.Directory.Ldap.jar. Both of them should be defined.

4. Save the settings.xml file and close it.

5. Restart Visual Studio .NET.

6. In Visual Studio .NET, go to the Application Servers page under Tools > Options > Visual MainWin > Java Environment and use the Update button to update the configured application servers, to include the new Visual MainWin Framework.