com.esri.arcgis.trackinganalyst
Class ObjectList

java.lang.Object
  com.esri.arcgis.trackinganalyst.ObjectList

All Implemented Interfaces:

com.esri.arcgis.interop.RemoteObjRef, ISet, Serializable

public class ObjectList
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, ISet

A container class to hold relevant objects (e.g., server connection, actions, feature class).

Description

This class holds relevant objects (e.g., server connection, actions and feature classes). The class implements ISet interface to control a simple set of objects it holds.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

See Also:

Serialized Form

Constructor Summary

ObjectList()
Constructs a ObjectList using ArcGIS Engine.

ObjectList(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
ObjectList theObjectList = (ObjectList) obj;

Method Summary

void	add(Object unk) Adds an object to the set.
boolean	equals(Object o) Compare this object with another
boolean	find(Object unk) Searches for the object in the set.
static String	getClsid() getClsid.
int	getCount() The element count of the set.
int	hashCode() the hashcode for this object
Object	next() Obtains the next object in the set.
void	remove(Object unk) Removes the object from the set.
void	removeAll() Removes all objects from the set.
void	reset() Resets the set for enumerating through the objects with Next.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef

getJintegraDispatch, release

Constructor Detail

ObjectList

public ObjectList()
           throws IOException,
                  UnknownHostException

Constructs a ObjectList using ArcGIS Engine.

Throws:

IOException - if there are interop problems

UnknownHostException - if there are interop problems

ObjectList

public ObjectList(Object obj)
           throws IOException

Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
ObjectList theObjectList = (ObjectList) obj;

Construct a ObjectList using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to ObjectList.

Parameters:

obj - an object returned from ArcGIS Engine or Server

Throws:

IOException - if there are interop problems

Method Detail

getClsid

public static String getClsid()

getClsid.

equals

public boolean equals(Object o)

Compare this object with another

Overrides:

equals in class Object

hashCode

public int hashCode()

the hashcode for this object

Overrides:

hashCode in class Object

add

public void add(Object unk)
         throws IOException,
                AutomationException

Adds an object to the set.

Description

Adds the specified object to the Set. If you add the same object to a Set twice, no error occurs but the resulting Set has only one reference to the object.

Remarks

The order in which objects are added to the Set using Add is not guaranteed to be the same order in which they are returned by the Next method.

When adding an object to a Set, you are merely adding a new reference to the object not copying it. The reference is released when the Set is destroyed or the object is removed. For example, if you add geodatabase features to a Set (or an Array) using a feature cursor, you must use a non-recycling cursor, otherwise the memory location of the previous feature is overwritten.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

add in interface ISet

Parameters:

unk - A reference to another Object (IUnknown) (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

remove

public void remove(Object unk)
            throws IOException,
                   AutomationException

Removes the object from the set.

Description

Removes the reference to the specified object from the Set.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

remove in interface ISet

Parameters:

unk - A reference to another Object (IUnknown) (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

removeAll

public void removeAll()
               throws IOException,
                      AutomationException

Removes all objects from the set.

Description

Removes all references to objects from the Set.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

removeAll in interface ISet

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

find

public boolean find(Object unk)
             throws IOException,
                    AutomationException

Searches for the object in the set.

Description

Indicates whether a reference to the specified object has been added to the Set with the Add method.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

find in interface ISet

Parameters:

unk - A reference to another Object (IUnknown) (in)

Returns:

The found

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

next

public Object next()
            throws IOException,
                   AutomationException

Obtains the next object in the set.

Description

The Next method returns the next object in the Set.

Remarks

The order that objects are returned from the Set object using the Next method is not guaranteed to be the same order as they were passed into the Add method. However, the Next method will return the objects in the same order.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

next in interface ISet

Returns:

A reference to another Object (IUnknown)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

reset

public void reset()
           throws IOException,
                  AutomationException

Resets the set for enumerating through the objects with Next.

Description

The Reset method resets the Set so that the next call to the Next method returns the first object in the Set.

Remarks

The order that objects are returned from the Set object using the Next method is not guaranteed to be the same order as they were passed into the Add method. However, the Next method will return the objects in the same order.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

reset in interface ISet

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getCount

public int getCount()
             throws IOException,
                    AutomationException

The element count of the set.

Description

Returns the number of objects in the Set.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

getCount in interface ISet

Returns:

The count

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.