ArcGIS Engine Developer Guide

JAVA APPLICATION PROGRAMMING INTERFACE
ArrayStoreException as ArcObjects is attempting to populate an IPolyline array with
an IGeometry object, attempting to place a superclass type into a subclass array.
The correct way to use this method is outlined below:
/* Set up the array and call the method. */
IGeometry[] geoArray = {new Polyline()};
tin.interpolateShape( breakline, geoArray, null );
/* "Cast" the first array element as a Polyline - this is
* the equivalent of calling QueryInterface on IGeometry.
*/
IPolyline firstPolyLine = new IPolylineProxy(geoArray[0]);
Non-OLE automation-compliant types
A few ArcObjects types are not OLE automation-compliant. They contain methods
that do not work in the ArcGIS API for Java. The API addresses each of
these situations in one of two ways:
1. Supplemental interfaces have been added that have the offending methods
overwritten in an automation-compliant way. These new interfaces are named
by appending them with the letters “GEN”, implying that they are generic for
all supported APIs. In these cases, the noncompliant interface is deprecated
with a link to the appropriate GEN interface. In the following example,
“somePoints” is an array of Point with two Point objects in it.
/* Not automation compatible - throws exception */
IEnvelope env = new Envelope();
env.defineFromPoints(2, somePoints[0]);
/* Automation compatible */
IEnvelopeGEN envGEN = new Envelope();
envGEN.defineFromPoints(somePoints);
2. A singleton utility class implements bridge interfaces. Since each utility class
can handle methods from multiple noncompliant interfaces, there is no naming
convention for the utility classes. The bridge interfaces handle the effort of
converting between noncompliant and compliant methods. In these cases, the
noncompliant methods are deprecated, with a link to the appropriate bridge
method in the utility class. To call the bridge method, simply pass in the
noncompliant object as the first argument. In this example,
myPointCollection4 is an instance of IPointCollection4, and
somePointStructures is an array of WKSPointZ objects with four objects in
it.
/* Not automation compatible - throws exception */
myPointCollection4.addWKSPointZs (4, somePointStructures[0]);
/* Automation compatible */
GeometryEnvironment geomEnv = new GeometryEnvironment();
geomEnv.addWKSPointZs(myPointCollection4, somePointStructures);
Using visual beans
The ArcGIS API for Java provides a set of reusable components as prebuilt
pieces of software code designed to provide graphical functions. As a visual beans
developer, you only need to write code to “buddy” them into your ArcGIS En-
194 • ArcGIS Engine Developer Guide