com.esri.adf.web.ags.data
Class AGSLocalMapResource

java.lang.Object
  com.esri.adf.web.data.GISResource
      com.esri.adf.web.ags.data.AGSMapResource
          com.esri.adf.web.ags.data.AGSLocalMapResource

All Implemented Interfaces:

java.io.Serializable, WebContextInitialize, WebLifecycle

Direct Known Subclasses:

AGSLocalExtensionsResource

public class AGSLocalMapResource

extends AGSMapResource

See Also:

Serialized Form

Field Summary

protected AGSLocalConnection	delegate
protected com.esri.arcgis.carto.MapServer	localMapServer

Fields inherited from class com.esri.adf.web.ags.data.AGSMapResource

endPointURL, generatedAlias, mapName, mapServer, user

Fields inherited from class com.esri.adf.web.data.GISResource

alias, context, defaultSpatialReference, functionalities, init

Constructor Summary

AGSLocalMapResource()

AGSLocalMapResource(java.lang.String serverObjectName, java.util.List hosts, java.lang.String clusterType, AGSUser user)

Method Summary

void	activate() This method is called by the associated WebContext when the context itself is being activated.
java.lang.Object	createArcObject(java.lang.String progId) Creates an ArcObject with this progId in the current server context.
protected void	createMapServer()
void	destroy() The cleanup (final) chores of the resource like releasing held resources must be performed in this method.
boolean	equals(java.lang.String resource) Determines whether the resource string represents this AGSLocalConnection.
java.lang.String	getAlias() Returns a reader friendly name for this resource.
java.lang.String	getClusterType()
java.util.List	getHosts()
com.esri.arcgis.carto.MapServer	getLocalMapServer()
com.esri.arcgis.server.ServerConnection	getServerConnection() Returns the ServerConnection object from the server.
com.esri.arcgis.server.IServerContext	getServerContext() Returns the IServerContext object from the server.
com.esri.arcgis.server.IServerObjectManager	getServerObjectManager() Returns the IServerObjectManager object from the server.
java.lang.String	getServerObjectName() The name of the server object on the GIS server machine.
AGSUser	getUser()
void	init(WebContext context) This method is called by the WebContext to initialize the resource.
boolean	isPooled() Returns an indicator of whether the server object is pooled or not.
java.lang.Object	loadObject(java.lang.String xml) Deserializes the string to a server object by calling the loadObject method on the AGSWebContext.
void	passivate() This method is called by the associated WebContext when the context itself is being passivated.
java.lang.String	saveObject(java.lang.Object persistObj) Serializes a server object to a String.
void	setClusterType(java.lang.String clusterType)
void	setHosts(java.util.List hosts)
void	setServerObjectName(java.lang.String serverObjectName)
void	setUser(AGSUser user)

Methods inherited from class com.esri.adf.web.ags.data.AGSMapResource

getEndPointURL, getMapName, getMapServer, setEndPointURL, setMapName

Methods inherited from class com.esri.adf.web.data.GISResource

addFunctionality, getDefaultSpatialReference, getFunctionalities, getFunctionality, getWebContext, setAlias, setFunctionalities

Methods inherited from class java.lang.Object

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

Field Detail

localMapServer

protected com.esri.arcgis.carto.MapServer localMapServer

delegate

protected AGSLocalConnection delegate

Constructor Detail

AGSLocalMapResource

public AGSLocalMapResource()

AGSLocalMapResource

public AGSLocalMapResource(java.lang.String serverObjectName,
                           java.util.List hosts,
                           java.lang.String clusterType,
                           AGSUser user)

Method Detail

createMapServer

protected void createMapServer()

Overrides:

createMapServer in class AGSMapResource

init

public void init(WebContext context)

Description copied from class: GISResource

This method is called by the WebContext to initialize the resource. This is typically called when the context itself is initialized or when users add a new resource to the context by using the WebContext#addResource(GISResource) method. A GISResource is usable only after this method has been called.

This method iterates through all its supported GISFunctionalitys and calls the GISFunctionality.initFunctionality(GISResource) on them all.

Sub-classes that want to do custom initialization should override this method and make the super call first before doing the custom stuff:

 public void init(WebContext context) {
   super.init(context);
   myInit();
 }
 

Specified by:

init in interface WebContextInitialize

Overrides:

init in class AGSMapResource

destroy

public void destroy()

Description copied from class: GISResource

The cleanup (final) chores of the resource like releasing held resources must be performed in this method. This is typically called when the context itself is being destroyed or when users remove this resource from the context by using the WebContext.removeResource(GISResource) method. A GISResource is unusable after this method has been called.

This method iterates through all its supported GISFunctionalitys and calls the GISFunctionality.destroyFunctionality() on them all.

Sub-classes that want to do custom cleanup chores should override this method and do the custom cleanup first before making the super call:

 public void destroy() {
   myDestroy();
   super.destroy();
 }
 

Specified by:

destroy in interface WebContextInitialize

Overrides:

destroy in class GISResource

See Also:

WebContextInitialize.destroy(), GISFunctionality.destroyFunctionality(), WebContext.destroy(), WebContext.removeResource(GISResource)

activate

public void activate()

Description copied from class: GISResource

This method is called by the associated WebContext when the context itself is being activated. This typically happens when a new user request is received to perform a set of operations. A GISResource is available for the execution of these operations only after this method has been called.

This method iterates through all its supported GISFunctionalitys and calls the activate() method on those functionalities that implement WebLifecycle.

Sub-classes that want to do custom activation should override this method and make the super call first before doing the custom stuff:

 public void activate() {
   super.activate();
   myActivate();
 }
 

Specified by:

activate in interface WebLifecycle

Overrides:

activate in class GISResource

See Also:

WebLifecycle.activate(), WebContext.activate()

passivate

public void passivate()

Description copied from class: GISResource

This method is called by the associated WebContext when the context itself is being passivated. This typically happens after a user request to perform a set of operations has been serviced. A GISResource is unavailable for the execution of more operations after this method has been called.

This method iterates through all its supported GISFunctionalitys and calls the passivate() method on those functionalities that implement WebLifecycle.

Sub-classes that want to do custom passivation should override this method and do the custom passivation first before making the super call:

 public void passivate() {
   myPassivate();
   super.passivate();
 }
 

Specified by:

passivate in interface WebLifecycle

Overrides:

passivate in class GISResource

See Also:

WebLifecycle.passivate(), WebContext.passivate()

createArcObject

public java.lang.Object createArcObject(java.lang.String progId)

Creates an ArcObject with this progId in the current server context.

Parameters:

progId - the class id

Returns:

Object- the ArcObject represented by this progId

saveObject

public java.lang.String saveObject(java.lang.Object persistObj)

Serializes a server object to a String.

Parameters:

persistObj - the object to store

Returns:

String- a string representation of the object

loadObject

public java.lang.Object loadObject(java.lang.String xml)

Deserializes the string to a server object by calling the loadObject method on the AGSWebContext.

Parameters:

xml - the string representation of the server object

Returns:

Object- the loaded Object

equals

public boolean equals(java.lang.String resource)

Determines whether the resource string represents this AGSLocalConnection.

Parameters:

resource - the resource string

Returns:

boolean- if true, the resource is the same

getLocalMapServer

public com.esri.arcgis.carto.MapServer getLocalMapServer()

isPooled

public boolean isPooled()

Returns an indicator of whether the server object is pooled or not.

Returns:

boolean- if true, server object is pooled

getAlias

public java.lang.String getAlias()

Description copied from class: GISResource

Returns a reader friendly name for this resource.

It is a good practice for users to explicitly set an alias when the resource is created programmatically or declaratively. Resource providers should provide an auto-generated alias anyway in case users don't explicitly set an alias themselves.

Overrides:

getAlias in class AGSMapResource

getServerObjectManager

public com.esri.arcgis.server.IServerObjectManager getServerObjectManager()

Returns the IServerObjectManager object from the server.

Returns:

IServerObjectManager- the IServerObjectMananger object

getServerConnection

public com.esri.arcgis.server.ServerConnection getServerConnection()

Returns the ServerConnection object from the server.

Returns:

ServerConnection- the ServerConnection object

getServerContext

public com.esri.arcgis.server.IServerContext getServerContext()

Returns the IServerContext object from the server.

Returns:

IServerContext- the IServerContext object

getServerObjectName

public java.lang.String getServerObjectName()

The name of the server object on the GIS server machine.

Returns:

String- the server object name

setServerObjectName

public void setServerObjectName(java.lang.String serverObjectName)

getHosts

public java.util.List getHosts()

setHosts

public void setHosts(java.util.List hosts)

setUser

public void setUser(AGSUser user)

Overrides:

setUser in class AGSMapResource

getUser

public AGSUser getUser()

Overrides:

getUser in class AGSMapResource

getClusterType

public java.lang.String getClusterType()

setClusterType

public void setClusterType(java.lang.String clusterType)