com.esri.arcgis.geodatabase
Class IVersionProxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.geodatabase.IVersionProxy
All Implemented Interfaces:
IVersion, Externalizable, Serializable
Direct Known Subclasses:
IVersion2Proxy

public class IVersionProxy
extends com.esri.arcgis.interop.Dispatch
implements IVersion, Serializable

Provides access to members for managing a version.

Superseded By

IVersion2

Description

The IVersion interface is used to manage the properties of a version, such as the name, description, access and the ability to create new versions.

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
  IVersionProxy()
           
  IVersionProxy(Object obj)
           
protected IVersionProxy(Object obj, String iid)
           
 
Method Summary
 void addListener(String iidStr, Object theListener, Object theSource)
           
 IVersion createVersion(String newName)
          Creates a new version equivalent to this version.
 void delete()
          Permanently deletes the version from the database.
 int getAccess()
          The version's access permission.
 String getDescription()
          The version's description.
 IVersionInfo getVersionInfo()
          This version's information.
 IEnumLockInfo getVersionLocks()
          This version's locks.
 String getVersionName()
          The name of the version.
 boolean hasParent()
          True if this version have a parent version.
 void refreshVersion()
          Refreshes the version with the corresponding database state.
 void removeListener(String iidStr, Object theListener)
           
 void setAccess(int access)
          The version's access permission.
 void setDescription(String description)
          The version's description.
 void setVersionName(String name)
          The name of the version.
 
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

IVersionProxy

public IVersionProxy()

IVersionProxy

public IVersionProxy(Object obj)
              throws IOException
Throws:
IOException

IVersionProxy

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

getVersionLocks

public IEnumLockInfo getVersionLocks()
                              throws IOException,
                                     AutomationException
This version's locks.

Remarks

The VersionLocks method returns the enumeration IEnumLockInfo. Using the enumeration you can detect what users are currently editing the version or currently reconciling the version. This information can be used to determine if the version is available for editing, to be reconciled or to be reconciled against.

See ILockInfo and esriLockType constants for additional information regarding locking descriptions.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getVersionLocks in interface IVersion
Returns:
A reference to a com.esri.arcgis.geodatabase.IEnumLockInfo
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getVersionInfo

public IVersionInfo getVersionInfo()
                            throws IOException,
                                   AutomationException
This version's information.

Remarks

The VersionInfo method provides a reference to the IVersionInfo interface. The IVersionInfo interface contains methods which describe the properties of the version. The interface is beneficial for obtaining a version's ancestory, for example its parent version.

VersionInfo will only return versions in which the connected user has the appropriate privileges.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getVersionInfo in interface IVersion
Returns:
A reference to a com.esri.arcgis.geodatabase.IVersionInfo
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getVersionName

public String getVersionName()
                      throws IOException,
                             AutomationException
The name of the version.

Remarks

The VersionName method is used to retrieve or set a version's name. Version names are case sensitive and limited to 64 characters. Only the owner of a version can change its properties, such as the name.

The DEFAULT version cannot be renamed.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getVersionName in interface IVersion
Returns:
The name
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setVersionName

public void setVersionName(String name)
                    throws IOException,
                           AutomationException
The name of the version.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setVersionName in interface IVersion
Parameters:
name - The name (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getDescription

public String getDescription()
                      throws IOException,
                             AutomationException
The version's description.

Remarks

The Description method is used to retreive or set a version's description. Version descriptions are not required and are limited to 64 characters. Only the owner of a version can change its properties, such as the description.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getDescription in interface IVersion
Returns:
The description
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setDescription

public void setDescription(String description)
                    throws IOException,
                           AutomationException
The version's description.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setDescription in interface IVersion
Parameters:
description - The description (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getAccess

public int getAccess()
              throws IOException,
                     AutomationException
The version's access permission.

Remarks

The Access property is used to retrieve or set a version's access property. Version access can be private, public or protected. Private versions are only accessible by the version's owner, public versions can be viewed and edited by any user, and protected versions can be viewed by any user but only edited by the owner. Only the owner of a version can change its properties, such as the access.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getAccess in interface IVersion
Returns:
A com.esri.arcgis.geodatabase.esriVersionAccess constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setAccess

public void setAccess(int access)
               throws IOException,
                      AutomationException
The version's access permission.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setAccess in interface IVersion
Parameters:
access - A com.esri.arcgis.geodatabase.esriVersionAccess constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

hasParent

public boolean hasParent()
                  throws IOException,
                         AutomationException
True if this version have a parent version.

Remarks

All versions, except the default version have parent versions.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
hasParent in interface IVersion
Returns:
The hasParent
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

delete

public void delete()
            throws IOException,
                   AutomationException
Permanently deletes the version from the database.

Description

Deletes the transactional version. Must be the version owner to delete a version.

Remarks

The Delete method is used to permanently delete a version. Only the owner of the version or the ArcSDE administrator can delete the version.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
delete in interface IVersion
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

refreshVersion

public void refreshVersion()
                    throws IOException,
                           AutomationException
Refreshes the version with the corresponding database state.

Remarks

The RefreshVersion method refreshes the version to correspond with the database state the version references. For example, if a second application is editing the verison and saves their changes, you need to call the RefreshVersion method to see the latest representation of the version.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
refreshVersion in interface IVersion
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

createVersion

public IVersion createVersion(String newName)
                       throws IOException,
                              AutomationException
Creates a new version equivalent to this version.

Remarks

The CreateVersion method allows you to create new version from the existing IVersion. The new version is a child of the current version and is owned by the connected user. The version name is limited to 64 characters and is private by default.

Creating a new version requires an existing version to be the parent of the new version. When the new version is created, the parent and child versions are identical.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
createVersion in interface IVersion
Parameters:
newName - The newName (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IVersion
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.