com.esri.arcgis.geoprocessing
Class GPUpdateMapServerCache

java.lang.Object
  extended by com.esri.arcgis.geoprocessing.GPUpdateMapServerCache
All Implemented Interfaces:
IGPFunction, com.esri.arcgis.interop.RemoteObjRef, Serializable

public class GPUpdateMapServerCache
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IGPFunction

Update pre-rendered tile cache for the MapServer.

Product Availability

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

See Also:
Serialized Form

Constructor Summary
GPUpdateMapServerCache()
          Constructs a GPUpdateMapServerCache using ArcGIS Engine.
GPUpdateMapServerCache(Object obj)
          Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
GPUpdateMapServerCache theGPUpdateMapServerCache = (GPUpdateMapServerCache) obj;
 
Method Summary
 boolean equals(Object o)
          Compare this object with another
 void execute(IArray paramvalues, ITrackCancel trackcancel, IGPEnvironmentManager envMgr, IGPMessages message)
          Executes the geoprocessing function using the given array of parameter values.
static String getClsid()
          getClsid.
 IUID getDialogCLSID()
          The class identifier (CLSID) of the custom dialog object to use when invoking the geoprocessing function.
 String getDisplayName()
          Displayed name of the geoprocessing function.
 IName getFullName()
          The function name object of the geoprocessing function.
 int getHelpContext()
          The context identifier of the topic within the help file for this function object.
 String getHelpFile()
          Name of the (CHM) file containing help information for this function object.
 String getMetadataFile()
          Name of the (XML) file containing the default metadata for this function object.
 String getName()
          Name of the geoprocessing function.
 IArray getParameterInfo()
          The list of parameters accepted by the geoprocessing function.
 Object getRenderer(IGPParameter pParam)
          Returns the custom renderer to use for the specified parameter.
 int hashCode()
          the hashcode for this object
 boolean isLicensed()
          Returns whether the geoprocessing function has all necessary licenses in order to execute.
 IGPMessages validate(IArray paramvalues, boolean updateValues, IGPEnvironmentManager envMgr)
          Validates the given array of parameter values.
 
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

GPUpdateMapServerCache

public GPUpdateMapServerCache()
                       throws IOException,
                              UnknownHostException
Constructs a GPUpdateMapServerCache using ArcGIS Engine.

Throws:
IOException - if there are interop problems
UnknownHostException - if there are interop problems

GPUpdateMapServerCache

public GPUpdateMapServerCache(Object obj)
                       throws IOException
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
GPUpdateMapServerCache theGPUpdateMapServerCache = (GPUpdateMapServerCache) obj;

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

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

getName

public String getName()
               throws IOException,
                      AutomationException
Name of the geoprocessing function.

Remarks

The Name property sets the name of a function tool. This name appears when using the function tool at the command line or in scripting. It must be unique within a given toolbox and must not contain any spaces.

Product Availability

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

Supported Platforms

Windows

Specified by:
getName in interface IGPFunction
Returns:
The name
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getDisplayName

public String getDisplayName()
                      throws IOException,
                             AutomationException
Displayed name of the geoprocessing function.

Remarks

The DisplayName property sets the user-friendly name of a function tool. It is displayed in the graphic user interface of the ArcToolbox window. The DisplayName can be internationalized.

Product Availability

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

Supported Platforms

Windows

Specified by:
getDisplayName in interface IGPFunction
Returns:
The name
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getParameterInfo

public IArray getParameterInfo()
                        throws IOException,
                               AutomationException
The list of parameters accepted by the geoprocessing function.

Remarks

The ParameterInfo property is the place where a function tool's parameters are defined. It returns an IArray of parameter objects (IGPParameter); these objects define the characteristics of the input and output parameters.

Product Availability

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

Supported Platforms

Windows

Specified by:
getParameterInfo in interface IGPFunction
Returns:
A reference to a com.esri.arcgis.system.IArray
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getDialogCLSID

public IUID getDialogCLSID()
                    throws IOException,
                           AutomationException
The class identifier (CLSID) of the custom dialog object to use when invoking the geoprocessing function.

Remarks

The DialogCLSID property is used to overwrite the default system tool dialog's look and feel. By default, Toolbox creates a dialog based upon the parameters returned by the ParameterInfo property.

Product Availability

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

Supported Platforms

Windows

Specified by:
getDialogCLSID in interface IGPFunction
Returns:
A reference to a com.esri.arcgis.system.IUID
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getFullName

public IName getFullName()
                  throws IOException,
                         AutomationException
The function name object of the geoprocessing function.

Remarks

The FullName property is the function name object for the GPFunction. It is created and returned by the GPFunctionFactory. The GPFunctionFactory must first be created before the FullName property can be implemented. Refer to IGPFunctionFactory for more detail.

Product Availability

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

Supported Platforms

Windows

Specified by:
getFullName in interface IGPFunction
Returns:
A reference to a com.esri.arcgis.system.IName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getHelpFile

public String getHelpFile()
                   throws IOException,
                          AutomationException
Name of the (CHM) file containing help information for this function object.

Remarks

The HelpFile porperty stores the path to a .chm file which contains a description of the tool parameters and explains the tool's operation and usage.

Product Availability

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

Supported Platforms

Windows

Specified by:
getHelpFile in interface IGPFunction
Returns:
The file
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getHelpContext

public int getHelpContext()
                   throws IOException,
                          AutomationException
The context identifier of the topic within the help file for this function object.

Remarks

The HelpContext property is a unique ID for the help topic from a HelpFile.

Product Availability

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

Supported Platforms

Windows

Specified by:
getHelpContext in interface IGPFunction
Returns:
The context
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMetadataFile

public String getMetadataFile()
                       throws IOException,
                              AutomationException
Name of the (XML) file containing the default metadata for this function object.

Description

The MetadataFile property stores the name of a .xml file with the default metadata for a function tool. The .xml file supplies parameter descriptions in the help panel of a tool dialog. If no .chm file is provided through the HelpFile property, a tool's help is based on the .xml file's content.

Product Availability

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

Supported Platforms

Windows

Specified by:
getMetadataFile in interface IGPFunction
Returns:
The file
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isLicensed

public boolean isLicensed()
                   throws IOException,
                          AutomationException
Returns whether the geoprocessing function has all necessary licenses in order to execute.

Remarks

The IsLicensed property is used to check if a function tool is licensed to execute in the active application.

Product Availability

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

Supported Platforms

Windows

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

getRenderer

public Object getRenderer(IGPParameter pParam)
                   throws IOException,
                          AutomationException
Returns the custom renderer to use for the specified parameter.

Remarks

The GetRenderer property is used to set a custom renderer for a function tool's output.

Product Availability

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

Supported Platforms

Windows

Specified by:
getRenderer in interface IGPFunction
Parameters:
pParam - A reference to a com.esri.arcgis.geoprocessing.IGPParameter (in)
Returns:
A Variant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

validate

public IGPMessages validate(IArray paramvalues,
                            boolean updateValues,
                            IGPEnvironmentManager envMgr)
                     throws IOException,
                            AutomationException
Validates the given array of parameter values.

Remarks

The Validate method checks that a function tool's set of parameter values are of the expected number, data type, and value.

Product Availability

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

Supported Platforms

Windows

Specified by:
validate in interface IGPFunction
Parameters:
paramvalues - A reference to a com.esri.arcgis.system.IArray (in)
updateValues - The updateValues (in)
envMgr - A reference to a com.esri.arcgis.geoprocessing.IGPEnvironmentManager (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IGPMessages
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

execute

public void execute(IArray paramvalues,
                    ITrackCancel trackcancel,
                    IGPEnvironmentManager envMgr,
                    IGPMessages message)
             throws IOException,
                    AutomationException
Executes the geoprocessing function using the given array of parameter values.

Product Availability

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

Supported Platforms

Windows

Specified by:
execute in interface IGPFunction
Parameters:
paramvalues - A reference to a com.esri.arcgis.system.IArray (in)
trackcancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)
envMgr - A reference to a com.esri.arcgis.geoprocessing.IGPEnvironmentManager (in)
message - A reference to a com.esri.arcgis.geodatabase.IGPMessages (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.