com.esri.arcgis.geoprocessing
Class IGpDispatchProxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.geoprocessing.IGpDispatchProxy
All Implemented Interfaces:
IGpDispatch, Externalizable, Serializable

public class IGpDispatchProxy
extends com.esri.arcgis.interop.Dispatch
implements IGpDispatch, Serializable

Provides access to the properties and methods of a Geoprocessor object.

When To Use

The GPDispatch object is a coarse grainded ArcObject that permits geoprocessing tools and environments to be used in a scripting language. This object supports the COM IDispatch object. This object may also be used in COM-compliant languages such as Visual Basic for Applications (VBA), and Visual Basic. With ArcGIS 9.2, you are now recommended to use the new Geoprocessor class.

Product Availability

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

Supported Platforms

Windows

See Also:
Serialized Form

Field Summary
 
Fields inherited from class com.esri.arcgis.interop.Dispatch
DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, E
 
Constructor Summary
  IGpDispatchProxy()
           
  IGpDispatchProxy(Object obj)
           
protected IGpDispatchProxy(Object obj, String iid)
           
 
Method Summary
 void addError(String message)
          Sets the output error message.
 void addListener(String iidStr, Object theListener, Object theSource)
           
 void addMessage(String message)
          Sets the output message.
 void addReturnMessage(int index)
          Sets the return message as an output message by index.
 void addToolbox(String toolbox)
          Add the toolbox to the current session.
 void addWarning(String message)
          Sets the output warning message.
 String checkExtension(String extension)
          Checks the status of a product extension.
 String checkInExtension(String extension)
          Checks in a product extension.
 String checkOutExtension(String extension)
          Checks out a product extension.
 String checkProduct(String code)
          Check the status of a license code.
 void clearEnvironment(String env)
          Clears the value of a given environment.
 String command(String commandLine)
          executes the given command line.
 void copyParameter(int from, int to)
          Copy given tool parameter to another.
 Object createObject(Object pObjectName, Object pExtraArg)
          Creates a geoprocessing object that can be used in a scripting environment.
 Object createRandomValueGenerator(int seed, String distributionType)
          Creates a geoprocessing random number generator object that can be used to generate random numbers.
 String createScratchName(Object prefix, Object suffix, Object dataType, Object workspace)
          Creates a scratch name for the given workspace.
 String createUniqueName(String inputTableName, Object workspace)
          Creates a unique name for the given workspace.
 Object describe(Object pInputValue, Object dataType)
          Returns a descriptor object describing the properties of the specified data element.
 boolean exists(Object pInputValue, Object dataType)
          Checks if a data element exists.
 int getMaxSeverity()
          The maximum severity of the return messages.
 String getMessage(int index)
          Gets the return message by index.
 int getMessageCount()
          The number of returned messages.
 String getMessages(Object severity)
          Gets all the return messages.
 String getParameterAsText(int index)
          Gets given tool parameter as text.
 int getParameterCount()
          The number of input tool parameters.
 int getReturnCode(int index)
          Gets the return code by index.
 int getSeverity(int index)
          Gets the return severity by index.
 String getSystemEnvironment(String envName)
          Gets the given system environment.
 String getToolbox()
          Sets the current (default) toolbox.
 Object insertCursor(Object pInputValue, Object spRef)
          Returns an insert cursor object against the given table/feature class.
 boolean isLogHistory()
          Indicates whether or not operations are logged or not.
 boolean isOverwriteOutput()
          Indicates whether or not outputs should be overwritten.
 Object listDatasets(Object wildCard, Object featureType)
          Returns a collection of datasets in the current workspace based on a query string and type.
 Object listEnvironments(Object pWildcard)
          Gets list of GeoProcessor Environments.
 Object listFeatureClasses(Object wildCard, Object featureType, Object dataset)
          Returns a collection of feature classes in the current workspace or optional dataset, based on a query string and type.
 Object listFields(Object pInputValue, Object wildCard, Object fieldType)
          Returns a collection of fields in the given table/feature class based on a query string and type.
 Object listIndexes(Object pInputValue, Object wildCard)
          Returns a collection of indexes in the given table/feature class based on a query string and type.
 Object listRasters(Object wildCard, Object rasterType)
          Returns a collection of rasters in the current workspace based on a query string and type.
 Object listTables(Object wildCard, Object tableType)
          Returns a collection of tables in the current workspace based on a query string and type.
 Object listToolboxes(Object pWildcard)
          Gets list of GeoProcessor Toolboxes.
 Object listTools(Object pWildcard)
          Gets list of GeoProcessor Tools.
 Object listWorkspaces(Object wildCard, Object workspaceType)
          Returns a collection of workspaces in the current workspace based on a query string and type.
 void loadSettings(String fileName)
          Loads the current GeoProcessor environment settings.
 String parseFieldName(String inputFieldName, Object workspace)
          Parses a field name into its constituent parts.
 String parseTableName(String inputTableName, Object workspace)
          Parses a table name into its constituent parts.
 String productInfo()
          Gets the product license info.
 String qualifyFieldName(String inputFieldName, Object workspace)
          Qualifies a field name for the workspace and connected user.
 String qualifyTableName(String inputTableName, Object workspace)
          Qualifies a table name for the workspace and connected user.
 void readExternal(ObjectInput in)
           
 void refreshCatalog(Object pInputValue)
          Refreshes the parent of the specified object in the catalog object associated with the Geoprocessor.
 void removeListener(String iidStr, Object theListener)
           
 void removeToolbox(String toolbox)
          Remove the toolbox from the current session.
 void resetEnvironments()
          Tests if a given environments value is set or not.
 void saveSettings(String fileName)
          Saves the current GeoProcessor environment settings.
 Object searchCursor(Object pInputValue, Object whereClause, Object spRef, Object fields, Object sortFields)
          Returns a search cursor object against the given table/feature class.
 void setLogHistory(boolean logHistory)
          Indicates whether or not operations are logged or not.
 void setOverwriteOutput(boolean overwriteOutput)
          Indicates whether or not outputs should be overwritten.
 void setParameterAsText(int index, String argument)
          Sets given tool parameter as text.
 String setProduct(String code)
          Sets the license level.
 void setToolbox(String toolbox)
          Sets the current (default) toolbox.
 String testSchemaLock(String fileName)
          Tests if an exclusive schema lock is set on a dataset.
 Object updateCursor(Object pInputValue, Object whereClause, Object spRef, Object fields, Object sortFields)
          Returns an update cursor object against the given table/feature class.
 String usage(String method)
          Generates the Usage for a given tool.
 String validateFieldName(String inputFieldName, Object workspace)
          Checks a field for compatibility with the workspace.
 String validateTableName(String inputTableName, Object workspace)
          Checks a table name for compatibility with the workspace.
 void writeExternal(ObjectOutput out)
           
 
Methods inherited from class com.esri.arcgis.interop.Dispatch
bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, queryInterface, release, setNativeMode, setPropertyByName, toString, vtblInvoke
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

IGpDispatchProxy

public IGpDispatchProxy()

IGpDispatchProxy

public IGpDispatchProxy(Object obj)
                 throws IOException
Throws:
IOException

IGpDispatchProxy

protected IGpDispatchProxy(Object obj,
                           String iid)
                    throws IOException
Throws:
IOException
Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException
Overrides:
addListener in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException
Overrides:
removeListener in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

getMessageCount

public int getMessageCount()
                    throws IOException,
                           AutomationException
The number of returned messages.

Product Availability

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

Supported Platforms

Windows

Specified by:
getMessageCount in interface IGpDispatch
Returns:
The count
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMessage

public String getMessage(int index)
                  throws IOException,
                         AutomationException
Gets the return message by index.

Product Availability

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

Supported Platforms

Windows

Specified by:
getMessage in interface IGpDispatch
Parameters:
index - The index (in)
Returns:
The message
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getSeverity

public int getSeverity(int index)
                throws IOException,
                       AutomationException
Gets the return severity by index.

Product Availability

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

Supported Platforms

Windows

Specified by:
getSeverity in interface IGpDispatch
Parameters:
index - The index (in)
Returns:
The severity
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getReturnCode

public int getReturnCode(int index)
                  throws IOException,
                         AutomationException
Gets the return code by index.

Product Availability

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

Supported Platforms

Windows

Specified by:
getReturnCode in interface IGpDispatch
Parameters:
index - The index (in)
Returns:
The code
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMessages

public String getMessages(Object severity)
                   throws IOException,
                          AutomationException
Gets all the return messages.

Product Availability

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

Supported Platforms

Windows

Specified by:
getMessages in interface IGpDispatch
Parameters:
severity - A Variant (in, optional, pass null if not required)
Returns:
The messages
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMaxSeverity

public int getMaxSeverity()
                   throws IOException,
                          AutomationException
The maximum severity of the return messages.

Product Availability

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

Supported Platforms

Windows

Specified by:
getMaxSeverity in interface IGpDispatch
Returns:
The severity
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addMessage

public void addMessage(String message)
                throws IOException,
                       AutomationException
Sets the output message.

Product Availability

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

Supported Platforms

Windows

Specified by:
addMessage in interface IGpDispatch
Parameters:
message - The message (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addError

public void addError(String message)
              throws IOException,
                     AutomationException
Sets the output error message.

Product Availability

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

Supported Platforms

Windows

Specified by:
addError in interface IGpDispatch
Parameters:
message - The message (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addWarning

public void addWarning(String message)
                throws IOException,
                       AutomationException
Sets the output warning message.

Product Availability

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

Supported Platforms

Windows

Specified by:
addWarning in interface IGpDispatch
Parameters:
message - The message (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addReturnMessage

public void addReturnMessage(int index)
                      throws IOException,
                             AutomationException
Sets the return message as an output message by index.

Product Availability

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

Supported Platforms

Windows

Specified by:
addReturnMessage in interface IGpDispatch
Parameters:
index - The index (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setProduct

public String setProduct(String code)
                  throws IOException,
                         AutomationException
Sets the license level.

Product Availability

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

Supported Platforms

Windows

Specified by:
setProduct in interface IGpDispatch
Parameters:
code - The code (in)
Returns:
The status
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

checkProduct

public String checkProduct(String code)
                    throws IOException,
                           AutomationException
Check the status of a license code.

Product Availability

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

Supported Platforms

Windows

Specified by:
checkProduct in interface IGpDispatch
Parameters:
code - The code (in)
Returns:
The status
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

productInfo

public String productInfo()
                   throws IOException,
                          AutomationException
Gets the product license info.

Product Availability

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

Supported Platforms

Windows

Specified by:
productInfo in interface IGpDispatch
Returns:
The status
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

checkOutExtension

public String checkOutExtension(String extension)
                         throws IOException,
                                AutomationException
Checks out a product extension.

Product Availability

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

Supported Platforms

Windows

Specified by:
checkOutExtension in interface IGpDispatch
Parameters:
extension - The extension (in)
Returns:
The status
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

checkInExtension

public String checkInExtension(String extension)
                        throws IOException,
                               AutomationException
Checks in a product extension.

Product Availability

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

Supported Platforms

Windows

Specified by:
checkInExtension in interface IGpDispatch
Parameters:
extension - The extension (in)
Returns:
The status
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

checkExtension

public String checkExtension(String extension)
                      throws IOException,
                             AutomationException
Checks the status of a product extension.

Product Availability

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

Supported Platforms

Windows

Specified by:
checkExtension in interface IGpDispatch
Parameters:
extension - The extension (in)
Returns:
The status
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getParameterCount

public int getParameterCount()
                      throws IOException,
                             AutomationException
The number of input tool parameters.

Product Availability

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

Supported Platforms

Windows

Specified by:
getParameterCount in interface IGpDispatch
Returns:
The count
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getParameterAsText

public String getParameterAsText(int index)
                          throws IOException,
                                 AutomationException
Gets given tool parameter as text.

Product Availability

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

Supported Platforms

Windows

Specified by:
getParameterAsText in interface IGpDispatch
Parameters:
index - The index (in)
Returns:
The argument
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setParameterAsText

public void setParameterAsText(int index,
                               String argument)
                        throws IOException,
                               AutomationException
Sets given tool parameter as text.

Product Availability

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

Supported Platforms

Windows

Specified by:
setParameterAsText in interface IGpDispatch
Parameters:
index - The index (in)
argument - The argument (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

copyParameter

public void copyParameter(int from,
                          int to)
                   throws IOException,
                          AutomationException
Copy given tool parameter to another.

Product Availability

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

Supported Platforms

Windows

Specified by:
copyParameter in interface IGpDispatch
Parameters:
from - The from (in)
to - The to (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

listTools

public Object listTools(Object pWildcard)
                 throws IOException,
                        AutomationException
Gets list of GeoProcessor Tools.

Product Availability

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

Supported Platforms

Windows

Specified by:
listTools in interface IGpDispatch
Parameters:
pWildcard - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

listEnvironments

public Object listEnvironments(Object pWildcard)
                        throws IOException,
                               AutomationException
Gets list of GeoProcessor Environments.

Product Availability

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

Supported Platforms

Windows

Specified by:
listEnvironments in interface IGpDispatch
Parameters:
pWildcard - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

listToolboxes

public Object listToolboxes(Object pWildcard)
                     throws IOException,
                            AutomationException
Gets list of GeoProcessor Toolboxes.

Product Availability

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

Supported Platforms

Windows

Specified by:
listToolboxes in interface IGpDispatch
Parameters:
pWildcard - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setToolbox

public void setToolbox(String toolbox)
                throws IOException,
                       AutomationException
Sets the current (default) toolbox.

Product Availability

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

Supported Platforms

Windows

Specified by:
setToolbox in interface IGpDispatch
Parameters:
toolbox - The toolbox (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getToolbox

public String getToolbox()
                  throws IOException,
                         AutomationException
Sets the current (default) toolbox.

Product Availability

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

Supported Platforms

Windows

Specified by:
getToolbox in interface IGpDispatch
Returns:
The toolbox
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addToolbox

public void addToolbox(String toolbox)
                throws IOException,
                       AutomationException
Add the toolbox to the current session.

Product Availability

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

Supported Platforms

Windows

Specified by:
addToolbox in interface IGpDispatch
Parameters:
toolbox - The toolbox (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

removeToolbox

public void removeToolbox(String toolbox)
                   throws IOException,
                          AutomationException
Remove the toolbox from the current session.

Product Availability

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

Supported Platforms

Windows

Specified by:
removeToolbox in interface IGpDispatch
Parameters:
toolbox - The toolbox (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getSystemEnvironment

public String getSystemEnvironment(String envName)
                            throws IOException,
                                   AutomationException
Gets the given system environment.

Product Availability

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

Supported Platforms

Windows

Specified by:
getSystemEnvironment in interface IGpDispatch
Parameters:
envName - The envName (in)
Returns:
The pEnvironment
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

command

public String command(String commandLine)
               throws IOException,
                      AutomationException
executes the given command line.

Product Availability

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

Supported Platforms

Windows

Specified by:
command in interface IGpDispatch
Parameters:
commandLine - The commandLine (in)
Returns:
The results
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

usage

public String usage(String method)
             throws IOException,
                    AutomationException
Generates the Usage for a given tool.

Product Availability

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

Supported Platforms

Windows

Specified by:
usage in interface IGpDispatch
Parameters:
method - The method (in)
Returns:
The usage
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

exists

public boolean exists(Object pInputValue,
                      Object dataType)
               throws IOException,
                      AutomationException
Checks if a data element exists.

Product Availability

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

Supported Platforms

Windows

Specified by:
exists in interface IGpDispatch
Parameters:
pInputValue - A Variant (in)
dataType - A Variant (in, optional, pass null if not required)
Returns:
The exists
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

refreshCatalog

public void refreshCatalog(Object pInputValue)
                    throws IOException,
                           AutomationException
Refreshes the parent of the specified object in the catalog object associated with the Geoprocessor.

Product Availability

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

Supported Platforms

Windows

Specified by:
refreshCatalog in interface IGpDispatch
Parameters:
pInputValue - A Variant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

listFeatureClasses

public Object listFeatureClasses(Object wildCard,
                                 Object featureType,
                                 Object dataset)
                          throws IOException,
                                 AutomationException
Returns a collection of feature classes in the current workspace or optional dataset, based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:
listFeatureClasses in interface IGpDispatch
Parameters:
wildCard - A Variant (in, optional, pass null if not required)
featureType - A Variant (in, optional, pass null if not required)
dataset - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

listDatasets

public Object listDatasets(Object wildCard,
                           Object featureType)
                    throws IOException,
                           AutomationException
Returns a collection of datasets in the current workspace based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:
listDatasets in interface IGpDispatch
Parameters:
wildCard - A Variant (in, optional, pass null if not required)
featureType - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

listTables

public Object listTables(Object wildCard,
                         Object tableType)
                  throws IOException,
                         AutomationException
Returns a collection of tables in the current workspace based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:
listTables in interface IGpDispatch
Parameters:
wildCard - A Variant (in, optional, pass null if not required)
tableType - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

listRasters

public Object listRasters(Object wildCard,
                          Object rasterType)
                   throws IOException,
                          AutomationException
Returns a collection of rasters in the current workspace based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:
listRasters in interface IGpDispatch
Parameters:
wildCard - A Variant (in, optional, pass null if not required)
rasterType - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

listWorkspaces

public Object listWorkspaces(Object wildCard,
                             Object workspaceType)
                      throws IOException,
                             AutomationException
Returns a collection of workspaces in the current workspace based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:
listWorkspaces in interface IGpDispatch
Parameters:
wildCard - A Variant (in, optional, pass null if not required)
workspaceType - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

listFields

public Object listFields(Object pInputValue,
                         Object wildCard,
                         Object fieldType)
                  throws IOException,
                         AutomationException
Returns a collection of fields in the given table/feature class based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:
listFields in interface IGpDispatch
Parameters:
pInputValue - A Variant (in)
wildCard - A Variant (in, optional, pass null if not required)
fieldType - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

listIndexes

public Object listIndexes(Object pInputValue,
                          Object wildCard)
                   throws IOException,
                          AutomationException
Returns a collection of indexes in the given table/feature class based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:
listIndexes in interface IGpDispatch
Parameters:
pInputValue - A Variant (in)
wildCard - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

searchCursor

public Object searchCursor(Object pInputValue,
                           Object whereClause,
                           Object spRef,
                           Object fields,
                           Object sortFields)
                    throws IOException,
                           AutomationException
Returns a search cursor object against the given table/feature class.

Product Availability

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

Supported Platforms

Windows

Specified by:
searchCursor in interface IGpDispatch
Parameters:
pInputValue - A Variant (in)
whereClause - A Variant (in, optional, pass null if not required)
spRef - A Variant (in, optional, pass null if not required)
fields - A Variant (in, optional, pass null if not required)
sortFields - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

updateCursor

public Object updateCursor(Object pInputValue,
                           Object whereClause,
                           Object spRef,
                           Object fields,
                           Object sortFields)
                    throws IOException,
                           AutomationException
Returns an update cursor object against the given table/feature class.

Product Availability

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

Supported Platforms

Windows

Specified by:
updateCursor in interface IGpDispatch
Parameters:
pInputValue - A Variant (in)
whereClause - A Variant (in, optional, pass null if not required)
spRef - A Variant (in, optional, pass null if not required)
fields - A Variant (in, optional, pass null if not required)
sortFields - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

insertCursor

public Object insertCursor(Object pInputValue,
                           Object spRef)
                    throws IOException,
                           AutomationException
Returns an insert cursor object against the given table/feature class.

Product Availability

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

Supported Platforms

Windows

Specified by:
insertCursor in interface IGpDispatch
Parameters:
pInputValue - A Variant (in)
spRef - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

describe

public Object describe(Object pInputValue,
                       Object dataType)
                throws IOException,
                       AutomationException
Returns a descriptor object describing the properties of the specified data element.

Product Availability

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

Supported Platforms

Windows

Specified by:
describe in interface IGpDispatch
Parameters:
pInputValue - A Variant (in)
dataType - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

createObject

public Object createObject(Object pObjectName,
                           Object pExtraArg)
                    throws IOException,
                           AutomationException
Creates a geoprocessing object that can be used in a scripting environment.

Product Availability

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

Supported Platforms

Windows

Specified by:
createObject in interface IGpDispatch
Parameters:
pObjectName - A Variant (in)
pExtraArg - A Variant (in, optional, pass null if not required)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

createRandomValueGenerator

public Object createRandomValueGenerator(int seed,
                                         String distributionType)
                                  throws IOException,
                                         AutomationException
Creates a geoprocessing random number generator object that can be used to generate random numbers.

Product Availability

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

Specified by:
createRandomValueGenerator in interface IGpDispatch
Parameters:
seed - The seed (in)
distributionType - The distributionType (in)
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setOverwriteOutput

public void setOverwriteOutput(boolean overwriteOutput)
                        throws IOException,
                               AutomationException
Indicates whether or not outputs should be overwritten.

Product Availability

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

Supported Platforms

Windows

Specified by:
setOverwriteOutput in interface IGpDispatch
Parameters:
overwriteOutput - The overwriteOutput (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isOverwriteOutput

public boolean isOverwriteOutput()
                          throws IOException,
                                 AutomationException
Indicates whether or not outputs should be overwritten.

Product Availability

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

Supported Platforms

Windows

Specified by:
isOverwriteOutput in interface IGpDispatch
Returns:
The overwriteOutput
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setLogHistory

public void setLogHistory(boolean logHistory)
                   throws IOException,
                          AutomationException
Indicates whether or not operations are logged or not.

Product Availability

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

Specified by:
setLogHistory in interface IGpDispatch
Parameters:
logHistory - The logHistory (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isLogHistory

public boolean isLogHistory()
                     throws IOException,
                            AutomationException
Indicates whether or not operations are logged or not.

Product Availability

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

Specified by:
isLogHistory in interface IGpDispatch
Returns:
The logHistory
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

validateFieldName

public String validateFieldName(String inputFieldName,
                                Object workspace)
                         throws IOException,
                                AutomationException
Checks a field for compatibility with the workspace.

Product Availability

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

Supported Platforms

Windows

Specified by:
validateFieldName in interface IGpDispatch
Parameters:
inputFieldName - The inputFieldName (in)
workspace - A Variant (in, optional, pass null if not required)
Returns:
The outputFieldName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

validateTableName

public String validateTableName(String inputTableName,
                                Object workspace)
                         throws IOException,
                                AutomationException
Checks a table name for compatibility with the workspace.

Product Availability

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

Supported Platforms

Windows

Specified by:
validateTableName in interface IGpDispatch
Parameters:
inputTableName - The inputTableName (in)
workspace - A Variant (in, optional, pass null if not required)
Returns:
The outputTableName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

qualifyFieldName

public String qualifyFieldName(String inputFieldName,
                               Object workspace)
                        throws IOException,
                               AutomationException
Qualifies a field name for the workspace and connected user.

Product Availability

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

Supported Platforms

Windows

Specified by:
qualifyFieldName in interface IGpDispatch
Parameters:
inputFieldName - The inputFieldName (in)
workspace - A Variant (in, optional, pass null if not required)
Returns:
The outputFieldName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

qualifyTableName

public String qualifyTableName(String inputTableName,
                               Object workspace)
                        throws IOException,
                               AutomationException
Qualifies a table name for the workspace and connected user.

Product Availability

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

Supported Platforms

Windows

Specified by:
qualifyTableName in interface IGpDispatch
Parameters:
inputTableName - The inputTableName (in)
workspace - A Variant (in, optional, pass null if not required)
Returns:
The outputTableName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

parseFieldName

public String parseFieldName(String inputFieldName,
                             Object workspace)
                      throws IOException,
                             AutomationException
Parses a field name into its constituent parts.

Product Availability

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

Supported Platforms

Windows

Specified by:
parseFieldName in interface IGpDispatch
Parameters:
inputFieldName - The inputFieldName (in)
workspace - A Variant (in, optional, pass null if not required)
Returns:
The outputParsedName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

parseTableName

public String parseTableName(String inputTableName,
                             Object workspace)
                      throws IOException,
                             AutomationException
Parses a table name into its constituent parts.

Product Availability

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

Supported Platforms

Windows

Specified by:
parseTableName in interface IGpDispatch
Parameters:
inputTableName - The inputTableName (in)
workspace - A Variant (in, optional, pass null if not required)
Returns:
The outputParsedName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

createScratchName

public String createScratchName(Object prefix,
                                Object suffix,
                                Object dataType,
                                Object workspace)
                         throws IOException,
                                AutomationException
Creates a scratch name for the given workspace.

Product Availability

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

Specified by:
createScratchName in interface IGpDispatch
Parameters:
prefix - A Variant (in, optional, pass null if not required)
suffix - A Variant (in, optional, pass null if not required)
dataType - A Variant (in, optional, pass null if not required)
workspace - A Variant (in, optional, pass null if not required)
Returns:
The outputTableName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

createUniqueName

public String createUniqueName(String inputTableName,
                               Object workspace)
                        throws IOException,
                               AutomationException
Creates a unique name for the given workspace.

Product Availability

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

Specified by:
createUniqueName in interface IGpDispatch
Parameters:
inputTableName - The inputTableName (in)
workspace - A Variant (in, optional, pass null if not required)
Returns:
The outputTableName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

saveSettings

public void saveSettings(String fileName)
                  throws IOException,
                         AutomationException
Saves the current GeoProcessor environment settings.

Product Availability

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

Specified by:
saveSettings in interface IGpDispatch
Parameters:
fileName - The fileName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

loadSettings

public void loadSettings(String fileName)
                  throws IOException,
                         AutomationException
Loads the current GeoProcessor environment settings.

Product Availability

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

Specified by:
loadSettings in interface IGpDispatch
Parameters:
fileName - The fileName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

testSchemaLock

public String testSchemaLock(String fileName)
                      throws IOException,
                             AutomationException
Tests if an exclusive schema lock is set on a dataset.

Product Availability

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

Specified by:
testSchemaLock in interface IGpDispatch
Parameters:
fileName - The fileName (in)
Returns:
The status
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

clearEnvironment

public void clearEnvironment(String env)
                      throws IOException,
                             AutomationException
Clears the value of a given environment.

Product Availability

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

Specified by:
clearEnvironment in interface IGpDispatch
Parameters:
env - The env (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

resetEnvironments

public void resetEnvironments()
                       throws IOException,
                              AutomationException
Tests if a given environments value is set or not.

Product Availability

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

Specified by:
resetEnvironments in interface IGpDispatch
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException
Specified by:
writeExternal in interface Externalizable
Overrides:
writeExternal in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException
Specified by:
readExternal in interface Externalizable
Overrides:
readExternal in class com.esri.arcgis.interop.Dispatch
Throws:
IOException
ClassNotFoundException