com.esri.arcgis.server
Class IServerDirectoryInfoProxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by 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.