com.esri.arcgis.server
Class IServerDirectoryInfoProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.server.IServerDirectoryInfoProxy

All Implemented Interfaces:

IServerDirectoryInfo, Externalizable, Serializable

Direct Known Subclasses:

IServerDirectoryInfo2Proxy

public class IServerDirectoryInfoProxy
extends com.esri.arcgis.interop.Dispatch
implements IServerDirectoryInfo, Serializable

Provides access to properties of a server directory.

Superseded By

IServerDirectoryInfo2

Remarks

The ArcGIS Server manages a set of server directories. A server directory is a location on a file system that the GIS server is configured to clean up files it writes. Server dirtectories can be added, removed, and modified by users or developers who are members of the agsadmin users group, and therfore have administrator priviliges on the ArcGIS Server.

Users and developers who are not administrators also need access to the list of the GIS server's server directories and the set of their properties that are necessary for programming applications that use them as locations to write output. Users that are members of the agsusers user group, but are not members of the agsadmin user group, can get information about server directories using the GetServerDirectoryInfos method on IServerObjectManager to get the IServerDirectoryInfo interface.

IServerDirectoryInfo provides read-only access to a subset of the server directory's properties. These properties include:

Path: the physical path of the directory in disk

URL: the URL of the virtual directory corresonding to the physical directory

Description: the description of the server directory

CleaningMode: indicates whether the directory is cleaned by file age, by last accessed, or its contents are not cleaned up

MaxFileAge: inidicates the maximum age, or the maximum time since last accessed, that files can be in the server directory before they are cleaned up

The properties listed above are those necessary for developers of server applications to make use of the various GIS server's server directories.

Product Availability

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

See Also:

Serialized Form

Field Summary

boolean

noncastable

Fields inherited from class com.esri.arcgis.interop.Dispatch

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef

Constructor Summary

	IServerDirectoryInfoProxy()
	IServerDirectoryInfoProxy(Object obj)
protected	IServerDirectoryInfoProxy(Object obj, String iid)

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
int	getCleaningMode() The mode by which the files in the server directory are cleaned (by age, by size or none).
String	getDescription() The description of the server directory.
int	getMaxFileAge() The maximum age (in seconds) a file can be in the server directory before it is deleted, if the cleaning mode is by file age.
String	getPath() The path of the output directory.
String	getURL() The URL of the virtual directory that maps to the physical directory as described by the Path property.
void	removeListener(String iidStr, Object theListener)

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, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal

Methods inherited from class java.lang.Object

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

Field Detail

noncastable

public boolean noncastable

Constructor Detail

IServerDirectoryInfoProxy

public IServerDirectoryInfoProxy()

IServerDirectoryInfoProxy

public IServerDirectoryInfoProxy(Object obj)
                          throws IOException

Throws:

IOException

IServerDirectoryInfoProxy

protected IServerDirectoryInfoProxy(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

getPath

public String getPath()
               throws IOException,
                      AutomationException

The path of the output directory.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getPath in interface IServerDirectoryInfo

Returns:

The pPath

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getURL

public String getURL()
              throws IOException,
                     AutomationException

The URL of the virtual directory that maps to the physical directory as described by the Path property.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getURL in interface IServerDirectoryInfo

Returns:

The pUrl

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDescription

public String getDescription()
                      throws IOException,
                             AutomationException

The description of the server directory.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getDescription in interface IServerDirectoryInfo

Returns:

The pText

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getCleaningMode

public int getCleaningMode()
                    throws IOException,
                           AutomationException

The mode by which the files in the server directory are cleaned (by age, by size or none).

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getCleaningMode in interface IServerDirectoryInfo

Returns:

A com.esri.arcgis.server.esriServerDirectoryCleaningMode constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMaxFileAge

public int getMaxFileAge()
                  throws IOException,
                         AutomationException

The maximum age (in seconds) a file can be in the server directory before it is deleted, if the cleaning mode is by file age.

Remarks

MaxFileAge is in seconds.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getMaxFileAge in interface IServerDirectoryInfo

Returns:

The pAge

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.