ArcGIS Engine Developer Guide

BUILDING A COMMAND-LINE JAVA APPLICATION
Initializing ArcObjects
Every application built with the ArcGIS Engine Developer Kit must initialize
ArcObjects at a product level, including any appropriate extension licenses. The
AoInitialize object is used to accomplish this task. This class initializes the
ArcObjects runtime environment and must be the first ArcObjects component
created. Two methods will be called from this object:
• initialize(int product code)—This method takes an integer value representing a
product code. The Java API provides an interface called esriLicenseProductCode,
which exposes static integer fields representing the different ESRI product
levels. See the javadoc description for a full list of products.
• CheckOutExtension(int extensioncode)—This method takes an integer value representing
an extension license code. The Java API provides an interface called
esriLicenseExtensionCode, which exposes static integer fields representing the
different ESRI extension products available.
This application requires an ArcGIS Engine Runtime license with 3D Analyst
extension license.
1. Declare a static AoInitialize variable and create the signature for this method as
follows:
private static AoInitialize aoInit;
private static void licenseCheckOut(){}
2. Implement the private method.
/**
* Initialize ArcObjects product usage and check out
* available 3D Analyst extension license.
*/
private static void licenseCheckOut(){
try{
aoInit = new AoInitialize();
aoInit.initialize(esriLicenseProductCode.esriLicenseProductCodeEngine);
aoInit.checkOutExtension(esriLicenseExtensionCode.
esriLicenseExtensionCode3DAnalyst);
}catch(IOException e){
System.out.println("Program Exit: Unable to initialize ArcObjects");
System.exit(0);
}
}
Putting it all together
Now that the private methods have all been constructed, you need to create an
entry point for your application. This main method will take command-line
arguments and pass them to the tinToPoint method created in earlier steps.
422 • ArcGIS Engine Developer Guide