com.esri.arcgis.geodatabase
Class IWorkspaceFactoryLockControlProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.geodatabase.IWorkspaceFactoryLockControlProxy

All Implemented Interfaces:

IWorkspaceFactoryLockControl, Externalizable, Serializable

public class IWorkspaceFactoryLockControlProxy
extends com.esri.arcgis.interop.Dispatch
implements IWorkspaceFactoryLockControl, Serializable

Manages Geodatabase Locking

Remarks

The IWorkspaceFactoryLockControl API must be used with extreme caution. Disabling schema locks can have adverse affects on all connected users. The disabling of schema locks not only prevents that workspace from establishing schema locks on an objects schema; it will also ignore any existing schema locks established by other processes.

This API is exposed at the workspace factory and allows for the Enabling and Disabling of schema locking on any workspace instantiated by the workspace factory. By default, schema locking is enabled on any workspace instantiated from a workspace factory.

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

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

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
void	disableSchemaLocking() All workspaces created and managed by the factory will have schema locking disabled.
void	enableSchemaLocking() All workspaces created and managed by the factory will have schema locking enabled.
boolean	isSchemaLockingEnabled() Returns true if this factory has schema locking enabled.
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

IWorkspaceFactoryLockControlProxy

public IWorkspaceFactoryLockControlProxy()

IWorkspaceFactoryLockControlProxy

public IWorkspaceFactoryLockControlProxy(Object obj)
                                  throws IOException

Throws:

IOException

IWorkspaceFactoryLockControlProxy

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

isSchemaLockingEnabled

public boolean isSchemaLockingEnabled()
                               throws IOException,
                                      AutomationException

Returns true if this factory has schema locking enabled.

Remarks

The read-only SchemaLockingEnabled property allows a caller to determine if the factory currently has schema locking enabled or disabled.

Product Availability

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

Specified by:

isSchemaLockingEnabled in interface IWorkspaceFactoryLockControl

Returns:

The isSchemaLockingEnabled

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

enableSchemaLocking

public void enableSchemaLocking()
                         throws IOException,
                                AutomationException

All workspaces created and managed by the factory will have schema locking enabled.

Remarks

The EnableSchemaLocking method is only needed if there is a need to turn schema locking “back on” after having called DisableSchemaLocking.

Product Availability

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

Specified by:

enableSchemaLocking in interface IWorkspaceFactoryLockControl

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

disableSchemaLocking

public void disableSchemaLocking()
                          throws IOException,
                                 AutomationException

All workspaces created and managed by the factory will have schema locking disabled.

Remarks

The DisableSchemaLocking method will first attempt to release any existing schema locks for this process. It will also set a state of the IWorkspaceFactory that informs all workspaces instantiated by that factory to disable schema locking.

It is important to understand that when schema locking is disabled on a workspace, it doesn’t invalidate the schema lock API. The methods related to this API such as ISchemaLock.ChangeSchemaLock() will not result in the acquiring of a schema lock on the desired object.

Product Availability

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

Specified by:

disableSchemaLocking in interface IWorkspaceFactoryLockControl

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.