public interface IServerObjectExtension
Server objects may have extensions that extend their base functionality for more specialized uses. Each type of server object may have a set of extensions that can be enabled or disabled based on its configuration. ArcGIS Server includes some server object extensions out of the box, and developers can extend ArcGIS Server by writing their own server object extensions.
Server objects extensions also have SOAP interfaces for handling SOAP requests to execute methods and returning results as SOAP responses. This support for SOAP request handling makes it possible to expose server object extensions as Web services that can be consumed by clients across the Internet.
Developers can create their own server object extensions. The goal of creating a server object extension is to provide coarse-grained methods that do a lot of work in the server, rather than pay the cost of making a large number of calls into the server from the client.
Extending a server object over creating a generic COM object that is created on demand in the server context has the following advantages:
The process for creating a server object extensions is the following:
IServerObjectExtension is a mandatory interface that must be supported by all server object extensions, and includes two methods: Init and Shutdown. This interface is used by the server object to manage the lifetime of the server object extension. The server object cocreates the server object extension and calls the Init method handing it a back reference to the server object via the server object helper argument. The server object helper implements a weak reference on the server object. The extension can keep a strong reference on the server object helper (for example, in a member variable) but should not keep a strong reference on the server object. Extensions should get the server object from the server object helper in order to make any method calls on the server object and release the reference after making the method calls. Init is called once when the instance of the server object extension is created.
The Shutdown method informs the server object extension that the server objectís context is being shutdown and is about to go away. In response the server object extension should release its reference on the server object helper:
In your custom methods, you use the server object helper to get a reference to the server object, for example:
private IServerObjectHelper m_SOH;
public void Init(IServerObjectHelper pSOH)
m_SOH = pSOH;
public void Shutdown()
m_SOH = null;
IMapServer mapsrv = m_SOH.ServerObject as IMapServer;
Your server object extension can also optionally implement IObjectConstruct, IObjectActivate and ILogSupport.
The IServerObjectExtension interface is used by developers who want to create their own server object extensions.
|Modifier and Type
|Method and Description
Initializes and starts the server object specified by the IServerObjectHelper reference.
Stops the server object specified by the IServerObjectHelper reference.
void init(IServerObjectHelper pSOH) throws java.io.IOException, AutomationException
void shutdown() throws java.io.IOException, AutomationException
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.