Getting started  

Migrating ArcGIS Engine applications


The following list shows the major changes that will affect older applications being migrated to ArcGIS 9.2.

 

 

 

Core API

  • Package restructure

All the commands and tools, listeners, and events associated with visual JavaBeans and control classes have been moved into a controls package. For example:

 

com.esri.arcgis.beans.map.IMapControlEvents2Adapter  to  com.esri.arcgis.controls.IMapControlEvents2Adapter

 

All the Beans (TOCBean, MapBean, SceneBean, GlobeBean, ToolBarBean, PageLayoutBean) are still in the com.esri.arcgis.beans.* package, but the associated controls are in the com.esri.arcgis.controls.* package.

 

com.esri.arcgis.beans.map.MapControl  to com.esri.arcgis.control.MapControl

 

You must recompile applications prior to ArcGIS 9.2 Engine after reorganizing the import statements to make them 9.2 compatible.

 

  • ReaderControl Removal

ReaderBean/Control is no longer available.  All the tools and commands previously on the ReaderControl are now available for use with the MapBean (or MapControl).

 

 

JAR File Changes

 

  • JAR Files Merge

Previously, the JARs necessary to run an application were the jintegra.jar, arcobjects.jar, and the arcgis_visualbeans.jar.   These have all been merged into the arcobjects.jar.  This single arcobjects.jar is the only necessary jar to run the application and it should be put in the classpath.

 

  • arcobjects.jar Relocation

The arcobjects.jar file has been relocated and under the %ARCGISHOME%/java/lib folder. Please make sure you point to the correct location in your development environments.

 

 

 

Other changes

 

  • ArcGIS Engine Runtime, Software Developer Kit (SDK), and Developer Help are separate installs.
    • ArcGIS Engine Runtime - Core components necessary to run an application. It must be installed first.
    • Java Engine SDK - Samples and tools.
    • Java Developer Help - Javadoc and Help System.

 

  • No Private JRE

The Engine Runtime or SDK installs no longer provide a JRE. A JRE must already be present before the Runtime or SDK can be installed.