com.esri.arcgis.geodatabase
Class IDatasetMigrationProxy

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

All Implemented Interfaces:

IDatasetMigration, Externalizable, Serializable

public class IDatasetMigrationProxy
extends com.esri.arcgis.interop.Dispatch
implements IDatasetMigration, Serializable

Provides access to members that migrate a dataset.

Description

The IDatasetMigration interface has methods for migrating the geometry, attribute and raster binary storage types of a dataset from an SDE data source. The migration path is based on parameters of the specified keyword.

Remarks

An exclusive schema lock should be acquired for the dataset prior to calling any of this interface's methods. An exclusive schema lock can be acquired by using the ISchemaLock interface.

The IFeatureClassStorage interface can be used with an SDE feature class to determine the type of geometry storage being used. If the geometry is migrated to a new storage type, the feature class must be re-opened for the IFeatureClassStorage to return the new value.

Consult the topic "Data migration from one storage type to another" in the ArcGIS Help system prior to migration. There are special cases to be aware of; for example, migrating from SDEBINARY to GEOGRAPHY with SQL Server is not recommended for feature classes with Z or M values.

Valid geometry migration paths for SDE/Oracle are:
Long Raw to Blob (SDEBINARY to SDELOB)
Long Raw to ST_Geometry (SDEBINARY to ST_GEOMETRY)
Blob to ST_Geometry (SDELOB to ST_GEOMETRY)
SDO_Geometry to ST_Geometry (SDO_GEOMETRY to ST_GEOMETRY)

Valid geometry migration paths for SDE/SQL Server are:
SDEBINARY to GEOMETRY
SDEBINARY to GEOGRAPHY
OGCWKB to GEOMETRY
OGCWKB to GEOGRAPHY

Valid attribute migration paths for SDE/Oracle are:
Long Raw to Blob

Valid raster migration paths for SDE/Oracle are:
Long Raw to Blob
Long Raw to ST_Raster
Blob to ST_Raster

Valid raster migration paths for SDE/PostgreSQL are:
Binary to ST_Raster

Valid raster migration paths for SDE/SQL Server are:
Binary to ST_Raster

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

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

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
void	migrateAttributeStorage(String configurationKeyword) Migrate the attribute field storage.
void	migrateGeometryStorage(String configurationKeyword) Migrate the geometry field storage.
void	migrateRasterStorage(String configurationKeyword) Migrate the raster storage.
void	migrateStorage(String configurationKeyword) Migrate all binary field storage.
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

IDatasetMigrationProxy

public IDatasetMigrationProxy()

IDatasetMigrationProxy

public IDatasetMigrationProxy(Object obj)
                       throws IOException

Throws:

IOException

IDatasetMigrationProxy

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

migrateStorage

public void migrateStorage(String configurationKeyword)
                    throws IOException,
                           AutomationException

Migrate all binary field storage.

Remarks

The MigrateStorage method will migrate all geometry, attribute and raster binaries to the parameters specified in the ConfigurationKeyword argument.

Product Availability

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

Specified by:

migrateStorage in interface IDatasetMigration

Parameters:

configurationKeyword - The configurationKeyword (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

migrateGeometryStorage

public void migrateGeometryStorage(String configurationKeyword)
                            throws IOException,
                                   AutomationException

Migrate the geometry field storage.

Remarks

The MigrateGeometryStorage method will migrate all geometry storage to the parameters specified in the ConfigurationKeyword argument.

Product Availability

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

Specified by:

migrateGeometryStorage in interface IDatasetMigration

Parameters:

configurationKeyword - The configurationKeyword (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

migrateAttributeStorage

public void migrateAttributeStorage(String configurationKeyword)
                             throws IOException,
                                    AutomationException

Migrate the attribute field storage.

Remarks

The MigrateAttributeStorage method will migrate all attribute binary storage to the parameters specified in the ConfigurationKeyword argument.

Product Availability

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

Specified by:

migrateAttributeStorage in interface IDatasetMigration

Parameters:

configurationKeyword - The configurationKeyword (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

migrateRasterStorage

public void migrateRasterStorage(String configurationKeyword)
                          throws IOException,
                                 AutomationException

Migrate the raster storage.

Remarks

The MigrateRasterStorage method will migrate all raster storage to the parameters specified in the ConfigurationKeyword argument.

Product Availability

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

Specified by:

migrateRasterStorage in interface IDatasetMigration

Parameters:

configurationKeyword - The configurationKeyword (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.