com.esri.arcgis.geoprocessing
Class GPServer

java.lang.Object
  com.esri.arcgis.geoprocessing.GPServer

All Implemented Interfaces:

IGPServer, IGPServer2, com.esri.arcgis.interop.RemoteObjRef, IServerObject, IServerObjectExtensionManager, ILogSupport, IObjectActivate, IObjectConstruct, IRequestHandler, IRequestHandler2, IRESTRequestHandler, ISupportErrorInfo, java.io.Serializable

public class GPServer
extends java.lang.Object
implements com.esri.arcgis.interop.RemoteObjRef, IGPServer, IObjectConstruct, IRequestHandler, IRequestHandler2, IObjectActivate, ILogSupport, ISupportErrorInfo, IServerObject, IServerObjectExtensionManager, IGPServer2, IRESTRequestHandler

COM Class 'GPServer'. Generated 3/19/2015 1:20:45 PM from 'C:\ArcGIS\COM\esriGeoprocessing.olb'

Description 'GP Server Class.' Generator Options: PromptForTypeLibraries = False ClashPrefix = esri_ LowerCaseMemberNames = True IDispatchOnly = False RetryOnReject = False AwtForOcxs = True ArraysAsObjects = False DontRenameSameMethods = False ImplementConflictingInterfaces = True ReuseMethods = True RenameConflictingInterfaceMethods = True GenBeanInfo = True GenerateJavadoc =

See Also:

Serialized Form

Field Summary

Fields inherited from interface com.esri.arcgis.geoprocessing.IGPServer

IID, IID234f4a93_8516_4247_914c_57c59f1d3f5f, xxDummy

Fields inherited from interface com.esri.arcgis.system.IRequestHandler2

IID, IID8319e7d0_8ad1_48ed_aa99_03f9d0c93ba8, xxDummy

Fields inherited from interface com.esri.arcgis.system.IRequestHandler

IID46a0e2ea_3b64_4a46_bd78_88a1660f35bb

Fields inherited from interface com.esri.arcgis.system.IObjectActivate

IID, IIDe3b78022_143e_4e61_9099_ed319ec061e7, xxDummy

Fields inherited from interface com.esri.arcgis.system.ISupportErrorInfo

IID, IIDdf0b3d60_548f_101b_8e65_08002b2bd119, xxDummy

Fields inherited from interface com.esri.arcgis.server.IServerObject

IID, IID0ad6ab40_9d6a_4bf8_8b86_eb89406dfc6c, xxDummy

Fields inherited from interface com.esri.arcgis.server.IServerObjectExtensionManager

IID, IID25d8b9dd_c7e8_4da4_bf4b_08a67087ceea, xxDummy

Fields inherited from interface com.esri.arcgis.geoprocessing.IGPServer2

IID, IID27909bc6_7ad1_4f5a_8e90_1bb8b95a569f, xxDummy

Fields inherited from interface com.esri.arcgis.system.IRESTRequestHandler

IID, IID9d66a418_d54a_48ed_88bd_043a25fa9c83, xxDummy

Constructor Summary

GPServer()
Constructs a GPServer using ArcGIS Engine.

GPServer(java.lang.Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
GPServer theGPServer = (GPServer) obj;

Method Summary

void	activate() Activates the object.
void	cancelJob(java.lang.String jobID) Cancels the specified job.
void	construct(IPropertySet props) Two phase object construction.
void	deactivate() Deactivates the object.
boolean	equals(java.lang.Object o) Compare this object with another
IGPResult	execute(java.lang.String toolName, IGPValues values, IGPResultOptions pOptions) Executes the specified tool with the supplied values and options and returns the results.
IGPResult	execute(java.lang.String toolName, IGPValues values, IGPResultOptions options, IPropertySet envValues) Executes the specified tool with the supplied values and options and returns the results.
IServerObjectExtension	findExtensionByCLSID(java.lang.String cLSID) Returns a server object extension found using a string representation of its class ID.
IServerObjectExtension	findExtensionByTypeName(java.lang.String name) Returns a server object extension found using its type name.
static java.lang.String	getClsid() getClsid.
java.lang.String	getConfigurationName() Name of the server object configuration that defines the server object.
int	getExecutionType() Indicates if the geoprocessing server is synchronous or asynchronous.
com.esri.arcgis.interop.Dispatch	getJintegraDispatch() Deprecated. Internal use only.
IPropertySet	getJobEnvironmentValues(java.lang.String jobID) Returns the enviornment values for the job.
IGPValues	getJobInputValues(java.lang.String jobID, IStringArray parameterNames) Returns the input values for the job.
IJobMessages	getJobMessages(java.lang.String jobID) Returns the messages of the specified job.
IGPResult	getJobResult(java.lang.String jobID, IStringArray parameterNames, IGPResultOptions pOptions) Returns the results of the specified job.
IEnvelope	getJobResultMapExtent(java.lang.String jobID) Returns the extent for the job.
IGPResultOptions	getJobResultOptions(java.lang.String jobID) Returns the result options for the job.
int	getJobStatus(java.lang.String jobID) Returns the status of the specified job.
java.lang.String	getJobToolName(java.lang.String jobID) Returns the tool name for the job.
java.lang.String	getResultMapServerName() Indicates if there is an associated map server to draw the results and the name of the map server.
IGDSData	getResultWorkspace(java.lang.String jobID, int transportType) Returns a zip file of the results workspace.
java.lang.String	getSchema() This method returns the resource hierarchy of a REST based SOE.
IGPToolInfos	getTaskInfos() Returns the tool information of the available tasks.
IStringArray	getTaskNames() Returns the names of the available tasks.
IGPToolInfo	getToolInfo(java.lang.String toolName) Returns the tool information of the specified tool name.
IGPToolInfos	getToolInfos() Returns the tool information of the available tools.
IStringArray	getToolNames() Returns the names of the available tools.
java.lang.String	getTypeName() Type of the server object (MapServer or GeocodeServer).
byte[]	handleBinaryRequest(byte[] request) Handles a binary request.
byte[]	handleBinaryRequest2(java.lang.String capabilities, byte[] request) Handles a binary request with explicit capabilities.
byte[]	handleRESTRequest(java.lang.String capabilities, java.lang.String resourceName, java.lang.String operationName, java.lang.String operationInput, java.lang.String outputFormat, java.lang.String requestProperties, java.lang.String[] responseProperties) Handles REST requests for SOE.
java.lang.String	handleStringRequest(java.lang.String capabilities, java.lang.String request) Handles a SOAP string request.
int	hashCode() the hashcode for this object
void	initLogging(ILog log) Initializes an object with a log.
void	interfaceSupportsErrorInfo(GUID riid) interfaceSupportsErrorInfo
void	release() Release a GPServer.
java.lang.String	submitJob(java.lang.String toolName, IGPValues values) Submits the specified tool with the supplied values and options and returns the job id.
java.lang.String	submitJob(java.lang.String toolName, IGPValues values, IGPResultOptions options, IPropertySet envValues) Submits the specified tool with the supplied values and options and returns the job id.

Methods inherited from class java.lang.Object

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

Constructor Detail

GPServer

public GPServer()
         throws java.io.IOException,
                java.net.UnknownHostException

Constructs a GPServer using ArcGIS Engine.

Throws:

java.io.IOException - if there are interop problems

java.net.UnknownHostException - if there are interop problems

GPServer

public GPServer(java.lang.Object obj)
         throws java.io.IOException

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

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

Parameters:

obj - an object returned from ArcGIS Engine or Server

Throws:

java.io.IOException - if there are interop problems

Method Detail

getClsid

public static java.lang.String getClsid()

getClsid.

equals

public boolean equals(java.lang.Object o)

Compare this object with another

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

the hashcode for this object

Overrides:

hashCode in class java.lang.Object

getJintegraDispatch

public com.esri.arcgis.interop.Dispatch getJintegraDispatch()

Deprecated. Internal use only.

Specified by:

getJintegraDispatch in interface com.esri.arcgis.interop.RemoteObjRef

release

public void release()

Release a GPServer.

Specified by:

release in interface com.esri.arcgis.interop.RemoteObjRef

getToolNames

public IStringArray getToolNames()
                          throws java.io.IOException,
                                 AutomationException

Returns the names of the available tools.

Specified by:

getToolNames in interface IGPServer

Specified by:

getToolNames in interface IGPServer2

Returns:

A reference to a com.esri.arcgis.system.IStringArray

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getToolInfos

public IGPToolInfos getToolInfos()
                          throws java.io.IOException,
                                 AutomationException

Returns the tool information of the available tools.

Specified by:

getToolInfos in interface IGPServer

Specified by:

getToolInfos in interface IGPServer2

Returns:

A reference to a com.esri.arcgis.geoprocessing.IGPToolInfos

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getToolInfo

public IGPToolInfo getToolInfo(java.lang.String toolName)
                        throws java.io.IOException,
                               AutomationException

Returns the tool information of the specified tool name.

Specified by:

getToolInfo in interface IGPServer

Specified by:

getToolInfo in interface IGPServer2

Parameters:

toolName - The toolName (in)

Returns:

A reference to a com.esri.arcgis.geoprocessing.IGPToolInfo

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTaskNames

public IStringArray getTaskNames()
                          throws java.io.IOException,
                                 AutomationException

Returns the names of the available tasks.

Specified by:

getTaskNames in interface IGPServer

Specified by:

getTaskNames in interface IGPServer2

Returns:

A reference to a com.esri.arcgis.system.IStringArray

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTaskInfos

public IGPToolInfos getTaskInfos()
                          throws java.io.IOException,
                                 AutomationException

Returns the tool information of the available tasks.

Specified by:

getTaskInfos in interface IGPServer

Specified by:

getTaskInfos in interface IGPServer2

Returns:

A reference to a com.esri.arcgis.geoprocessing.IGPToolInfos

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getResultMapServerName

public java.lang.String getResultMapServerName()
                                        throws java.io.IOException,
                                               AutomationException

Indicates if there is an associated map server to draw the results and the name of the map server.

Specified by:

getResultMapServerName in interface IGPServer

Specified by:

getResultMapServerName in interface IGPServer2

Returns:

The mapServerName

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

execute

public IGPResult execute(java.lang.String toolName,
                         IGPValues values,
                         IGPResultOptions pOptions)
                  throws java.io.IOException,
                         AutomationException

Executes the specified tool with the supplied values and options and returns the results.

Specified by:

execute in interface IGPServer

Parameters:

toolName - The toolName (in)

values - A reference to a com.esri.arcgis.geoprocessing.IGPValues (in)

pOptions - A reference to a com.esri.arcgis.geoprocessing.IGPResultOptions (in)

Returns:

A reference to a com.esri.arcgis.geoprocessing.IGPResult

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

submitJob

public java.lang.String submitJob(java.lang.String toolName,
                                  IGPValues values)
                           throws java.io.IOException,
                                  AutomationException

Submits the specified tool with the supplied values and options and returns the job id.

Specified by:

submitJob in interface IGPServer

Parameters:

toolName - The toolName (in)

values - A reference to a com.esri.arcgis.geoprocessing.IGPValues (in)

Returns:

The jobID

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getJobStatus

public int getJobStatus(java.lang.String jobID)
                 throws java.io.IOException,
                        AutomationException

Returns the status of the specified job.

Specified by:

getJobStatus in interface IGPServer

Specified by:

getJobStatus in interface IGPServer2

Parameters:

jobID - The jobID (in)

Returns:

A com.esri.arcgis.system.esriJobStatus constant

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getJobMessages

public IJobMessages getJobMessages(java.lang.String jobID)
                            throws java.io.IOException,
                                   AutomationException

Returns the messages of the specified job.

Specified by:

getJobMessages in interface IGPServer

Specified by:

getJobMessages in interface IGPServer2

Parameters:

jobID - The jobID (in)

Returns:

A reference to a com.esri.arcgis.system.IJobMessages

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getJobResult

public IGPResult getJobResult(java.lang.String jobID,
                              IStringArray parameterNames,
                              IGPResultOptions pOptions)
                       throws java.io.IOException,
                              AutomationException

Returns the results of the specified job.

Specified by:

getJobResult in interface IGPServer

Specified by:

getJobResult in interface IGPServer2

Parameters:

jobID - The jobID (in)

parameterNames - A reference to a com.esri.arcgis.system.IStringArray (in)

pOptions - A reference to a com.esri.arcgis.geoprocessing.IGPResultOptions (in)

Returns:

A reference to a com.esri.arcgis.geoprocessing.IGPResult

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

cancelJob

public void cancelJob(java.lang.String jobID)
               throws java.io.IOException,
                      AutomationException

Cancels the specified job.

Specified by:

cancelJob in interface IGPServer

Specified by:

cancelJob in interface IGPServer2

Parameters:

jobID - The jobID (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getExecutionType

public int getExecutionType()
                     throws java.io.IOException,
                            AutomationException

Indicates if the geoprocessing server is synchronous or asynchronous.

Specified by:

getExecutionType in interface IGPServer

Specified by:

getExecutionType in interface IGPServer2

Returns:

A com.esri.arcgis.geoprocessing.esriExecutionType constant

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getResultWorkspace

public IGDSData getResultWorkspace(java.lang.String jobID,
                                   int transportType)
                            throws java.io.IOException,
                                   AutomationException

Returns a zip file of the results workspace.

Specified by:

getResultWorkspace in interface IGPServer

Specified by:

getResultWorkspace in interface IGPServer2

Parameters:

jobID - The jobID (in)

transportType - A com.esri.arcgis.geodatabasedistributed.esriGDSTransportType constant (in)

Returns:

A reference to a com.esri.arcgis.geodatabasedistributed.IGDSData

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

construct

public void construct(IPropertySet props)
               throws java.io.IOException,
                      AutomationException

Two phase object construction.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

construct in interface IObjectConstruct

Parameters:

props - A reference to a com.esri.arcgis.system.IPropertySet (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

handleBinaryRequest

public byte[] handleBinaryRequest(byte[] request)
                           throws java.io.IOException,
                                  AutomationException

Handles a binary request.

Specified by:

handleBinaryRequest in interface IRequestHandler

Parameters:

request - An unsigned byte (in)

Returns:

An unsigned byte

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

handleStringRequest

public java.lang.String handleStringRequest(java.lang.String capabilities,
                                            java.lang.String request)
                                     throws java.io.IOException,
                                            AutomationException

Handles a SOAP string request.

Specified by:

handleStringRequest in interface IRequestHandler

Parameters:

capabilities - The capabilities (in)

request - The request (in)

Returns:

The response

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

handleBinaryRequest2

public byte[] handleBinaryRequest2(java.lang.String capabilities,
                                   byte[] request)
                            throws java.io.IOException,
                                   AutomationException

Handles a binary request with explicit capabilities.

Specified by:

handleBinaryRequest2 in interface IRequestHandler2

Parameters:

capabilities - The capabilities (in)

request - An unsigned byte (in)

Returns:

An unsigned byte

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

activate

public void activate()
              throws java.io.IOException,
                     AutomationException

Activates the object.

Specified by:

activate in interface IObjectActivate

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

deactivate

public void deactivate()
                throws java.io.IOException,
                       AutomationException

Deactivates the object.

Specified by:

deactivate in interface IObjectActivate

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

initLogging

public void initLogging(ILog log)
                 throws java.io.IOException,
                        AutomationException

Initializes an object with a log.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

initLogging in interface ILogSupport

Parameters:

log - A reference to a com.esri.arcgis.system.ILog (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

interfaceSupportsErrorInfo

public void interfaceSupportsErrorInfo(GUID riid)
                                throws java.io.IOException,
                                       AutomationException

interfaceSupportsErrorInfo

Specified by:

interfaceSupportsErrorInfo in interface ISupportErrorInfo

Parameters:

riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getConfigurationName

public java.lang.String getConfigurationName()
                                      throws java.io.IOException,
                                             AutomationException

Name of the server object configuration that defines the server object.

Specified by:

getConfigurationName in interface IServerObject

Returns:

The name

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTypeName

public java.lang.String getTypeName()
                             throws java.io.IOException,
                                    AutomationException

Type of the server object (MapServer or GeocodeServer).

Specified by:

getTypeName in interface IServerObject

Returns:

The name

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

findExtensionByCLSID

public IServerObjectExtension findExtensionByCLSID(java.lang.String cLSID)
                                            throws java.io.IOException,
                                                   AutomationException

Returns a server object extension found using a string representation of its class ID.

Specified by:

findExtensionByCLSID in interface IServerObjectExtensionManager

Parameters:

cLSID - The cLSID (in)

Returns:

A reference to a com.esri.arcgis.server.IServerObjectExtension

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

findExtensionByTypeName

public IServerObjectExtension findExtensionByTypeName(java.lang.String name)
                                               throws java.io.IOException,
                                                      AutomationException

Returns a server object extension found using its type name.

Specified by:

findExtensionByTypeName in interface IServerObjectExtensionManager

Parameters:

name - The name (in)

Returns:

A reference to a com.esri.arcgis.server.IServerObjectExtension

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

execute

public IGPResult execute(java.lang.String toolName,
                         IGPValues values,
                         IGPResultOptions options,
                         IPropertySet envValues)
                  throws java.io.IOException,
                         AutomationException

Executes the specified tool with the supplied values and options and returns the results.

Specified by:

execute in interface IGPServer2

Parameters:

toolName - The toolName (in)

values - A reference to a com.esri.arcgis.geoprocessing.IGPValues (in)

options - A reference to a com.esri.arcgis.geoprocessing.IGPResultOptions (in)

envValues - A reference to a com.esri.arcgis.system.IPropertySet (in)

Returns:

A reference to a com.esri.arcgis.geoprocessing.IGPResult

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

submitJob

public java.lang.String submitJob(java.lang.String toolName,
                                  IGPValues values,
                                  IGPResultOptions options,
                                  IPropertySet envValues)
                           throws java.io.IOException,
                                  AutomationException

Submits the specified tool with the supplied values and options and returns the job id.

Specified by:

submitJob in interface IGPServer2

Parameters:

toolName - The toolName (in)

values - A reference to a com.esri.arcgis.geoprocessing.IGPValues (in)

options - A reference to a com.esri.arcgis.geoprocessing.IGPResultOptions (in)

envValues - A reference to a com.esri.arcgis.system.IPropertySet (in)

Returns:

The jobID

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getJobToolName

public java.lang.String getJobToolName(java.lang.String jobID)
                                throws java.io.IOException,
                                       AutomationException

Returns the tool name for the job.

Specified by:

getJobToolName in interface IGPServer2

Parameters:

jobID - The jobID (in)

Returns:

The name

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getJobInputValues

public IGPValues getJobInputValues(java.lang.String jobID,
                                   IStringArray parameterNames)
                            throws java.io.IOException,
                                   AutomationException

Returns the input values for the job.

Specified by:

getJobInputValues in interface IGPServer2

Parameters:

jobID - The jobID (in)

parameterNames - A reference to a com.esri.arcgis.system.IStringArray (in)

Returns:

A reference to a com.esri.arcgis.geoprocessing.IGPValues

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getJobResultOptions

public IGPResultOptions getJobResultOptions(java.lang.String jobID)
                                     throws java.io.IOException,
                                            AutomationException

Returns the result options for the job.

Specified by:

getJobResultOptions in interface IGPServer2

Parameters:

jobID - The jobID (in)

Returns:

A reference to a com.esri.arcgis.geoprocessing.IGPResultOptions

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getJobEnvironmentValues

public IPropertySet getJobEnvironmentValues(java.lang.String jobID)
                                     throws java.io.IOException,
                                            AutomationException

Returns the enviornment values for the job.

Specified by:

getJobEnvironmentValues in interface IGPServer2

Parameters:

jobID - The jobID (in)

Returns:

A reference to a com.esri.arcgis.system.IPropertySet

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getJobResultMapExtent

public IEnvelope getJobResultMapExtent(java.lang.String jobID)
                                throws java.io.IOException,
                                       AutomationException

Returns the extent for the job.

Specified by:

getJobResultMapExtent in interface IGPServer2

Parameters:

jobID - The jobID (in)

Returns:

A reference to a com.esri.arcgis.geometry.IEnvelope

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

handleRESTRequest

public byte[] handleRESTRequest(java.lang.String capabilities,
                                java.lang.String resourceName,
                                java.lang.String operationName,
                                java.lang.String operationInput,
                                java.lang.String outputFormat,
                                java.lang.String requestProperties,
                                java.lang.String[] responseProperties)
                         throws java.io.IOException,
                                AutomationException

Handles REST requests for SOE.

This method is invoked by ArcGIS Server's REST handler, which intercepts client's request (in URL form), parses it and passes it on to this method in form of parameter values.

The REST SOE developer must add logic to use these parameter values to determine which resource/operation is being requested and accordingly handle these requests and generate responses in the output format indicated by the "outputFormat" parameter. For more information on developing REST SOEs, please consult the Java ArcObjects Developer Guide.

Developer doc: Developing extensions > Server Object Extensions > SOE Web Services > REST Web Services > Developing SOE REST Web Services
Samples: Samples > Server Object Extensions section

Specified by:

handleRESTRequest in interface IRESTRequestHandler

Parameters:

capabilities - The capabilities supported by the SOE. An admin can choose which capabilities are enabled on a particular SOE (in ArcGIS Manager or ArcCatalog), based on certain criteria such as security roles. This list of allowed capabilities is then sent to this method, at runtime, as a comma separated list. (in)

resourceName - Name of the resource being addressed. If empty, its assumed that root resource is being addressed. (in)

operationName - Name of the operation being invoked. If empty, description of resource is returned. (in)

operationInput - Input parameters, in form of comma separated list, to the operation specified by operationName parameter. (in)

outputFormat - OutputFormat of operation. Possible formats are JSON, HTML, AMF, etc. (in)

requestProperties - The requestProperties (in)

responseProperties - The responseProperties (out)

Returns:

Output generated by the SOE

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSchema

public java.lang.String getSchema()
                           throws java.io.IOException,
                                  AutomationException

This method returns the resource hierarchy of a REST based SOE. This hierarchy is in JSON format as shown in the example below:

For an SOE that has a root resource (called "root") with one operation ("operation0"), and 2 sub-resources with one operation each ("operation1" and "operation2" respectively), the schema would look like:

 {
   "name": "MyRESTSOE",
   "description": "My REST SOE with 3 resources and 1 operation each.",
   "isCollection": false,
   "operations": [
   {
      "name": "operation0",
      "parameters": ["param01"],
      "supportedOutputFormats": ["json"]
    }
 ],
 "resources": [
  {
      "name": "subresource1",
      "description": "Sub Resource 1",
      "isCollection": true,
      "operations": [
       {
          "name": "operation1",
          "parameters": ["param10", "param11"],
          "supportedOutputFormats": ["json"]
       }
    ]
  },
  {
      "name": "subresource2",
      "description": "Sub Resource 2",
      "isCollection": true,
      "operations": [
       {
          "name": "operation2",
          "parameters": ["param20", "param21"],
          "supportedOutputFormats": ["json"]
       }
    ]
  }
 ]
}

Specified by:

getSchema in interface IRESTRequestHandler

Returns:

resource hierarchy of REST SOE, as String

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.