com.esri.arcgis.datasourcesraster
Interface IRasterBuilder

All Superinterfaces:

Serializable

All Known Implementing Classes:

ApplanixBuilder, IkonosBuilder, IRasterBuilderProxy, ISATBuilder, ISDefBuilder, LandsatBuilder, MatchATBuilder, NITFBuilder, OverviewBuilder, QuickBirdBuilder, RapidEyeBuilder, RasterDatasetBuilder, RasterType, RPDefBuilder, RPFBuilder, SpotBuilder, TableBuilder

public interface IRasterBuilder
extends Serializable

Provides access to members that control a raster builder.

Product Availability

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

Method Summary

void	beginConstruction(IDataSourceCrawler pCrawler) Initializes the raster builder for URI construction given a valid data source crawler object.
IBuilderItem	build(IItemURI pItemURI) Construct a builder item using the specified item URI.
void	constructURIs(Object crawlerItem) Constructs one or more item URI objects given the crawled data source item.
IItemURIArray	endConstruction() Shuts down the raster builder object upon completion of URI construction.
IPropertySet	getAuxiliaryFieldAlias() Optional look-up that maps field names to possile metadata property names.
IFields	getAuxiliaryFields() Fields to be created and populated in the raster catalog when a builder is used.
IItemURI	getNextURI() Returns the next available item URI object.
IPropertySet	getProperties() The raster dataset builder properties.
IDataSourceCrawler	getRecommendedCrawler(IPropertySet pDataSourceProperties) Returns a crawler best suited for data source as recommended by the raster builder.
boolean	isCanBuildInPlace() Indicates whether the raster type can build an item URI as soon as it is contructed.
boolean	isStale(IItemURI pItemURI) Indicates whether the data source referenced by the specified item URI has been updated since the item URI was last constructed.
void	setAuxiliaryFieldAliasByRef(IPropertySet ppFieldNameMap) Optional look-up that maps field names to possile metadata property names.
void	setAuxiliaryFieldsByRef(IFields ppAuxiliaryFields) Fields to be created and populated in the raster catalog when a builder is used.
void	setPropertiesByRef(IPropertySet ppBuilderPoperties) The raster dataset builder properties.

Method Detail

getRecommendedCrawler

IDataSourceCrawler getRecommendedCrawler(IPropertySet pDataSourceProperties)
                                         throws IOException,
                                                AutomationException

Returns a crawler best suited for data source as recommended by the raster builder.

Product Availability

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

Parameters:

pDataSourceProperties - A reference to a com.esri.arcgis.system.IPropertySet (in)

Returns:

A reference to a com.esri.arcgis.datasourcesraster.IDataSourceCrawler

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

beginConstruction

void beginConstruction(IDataSourceCrawler pCrawler)
                       throws IOException,
                              AutomationException

Initializes the raster builder for URI construction given a valid data source crawler object.

Product Availability

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

Parameters:

pCrawler - A reference to a com.esri.arcgis.datasourcesraster.IDataSourceCrawler (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

constructURIs

void constructURIs(Object crawlerItem)
                   throws IOException,
                          AutomationException

Constructs one or more item URI objects given the crawled data source item.

Product Availability

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

Parameters:

crawlerItem - A Variant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getNextURI

IItemURI getNextURI()
                    throws IOException,
                           AutomationException

Returns the next available item URI object.

Product Availability

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

Returns:

A reference to a com.esri.arcgis.datasourcesraster.IItemURI

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

endConstruction

IItemURIArray endConstruction()
                              throws IOException,
                                     AutomationException

Shuts down the raster builder object upon completion of URI construction. Once all item URIs are constructed and returned via repated calls to the GetNextURI, this method might return an array of item URIs possibly created as a result of the shut down process.????&

Product Availability

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

Returns:

A reference to a com.esri.arcgis.datasourcesraster.IItemURIArray

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isStale

boolean isStale(IItemURI pItemURI)
                throws IOException,
                       AutomationException

Indicates whether the data source referenced by the specified item URI has been updated since the item URI was last constructed.

Product Availability

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

Parameters:

pItemURI - A reference to a com.esri.arcgis.datasourcesraster.IItemURI (in)

Returns:

The pIsStale

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

build

IBuilderItem build(IItemURI pItemURI)
                   throws IOException,
                          AutomationException

Construct a builder item using the specified item URI.

Product Availability

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

Parameters:

pItemURI - A reference to a com.esri.arcgis.datasourcesraster.IItemURI (in)

Returns:

A reference to a com.esri.arcgis.datasourcesraster.IBuilderItem

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setPropertiesByRef

void setPropertiesByRef(IPropertySet ppBuilderPoperties)
                        throws IOException,
                               AutomationException

The raster dataset builder properties.

Product Availability

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

Parameters:

ppBuilderPoperties - A reference to a com.esri.arcgis.system.IPropertySet (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getProperties

IPropertySet getProperties()
                           throws IOException,
                                  AutomationException

The raster dataset builder properties.

Product Availability

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

Returns:

A reference to a com.esri.arcgis.system.IPropertySet

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setAuxiliaryFieldsByRef

void setAuxiliaryFieldsByRef(IFields ppAuxiliaryFields)
                             throws IOException,
                                    AutomationException

Fields to be created and populated in the raster catalog when a builder is used.

Product Availability

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

Parameters:

ppAuxiliaryFields - A reference to a com.esri.arcgis.geodatabase.IFields (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getAuxiliaryFields

IFields getAuxiliaryFields()
                           throws IOException,
                                  AutomationException

Fields to be created and populated in the raster catalog when a builder is used.

Product Availability

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

Returns:

A reference to a com.esri.arcgis.geodatabase.IFields

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setAuxiliaryFieldAliasByRef

void setAuxiliaryFieldAliasByRef(IPropertySet ppFieldNameMap)
                                 throws IOException,
                                        AutomationException

Optional look-up that maps field names to possile metadata property names.

Product Availability

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

Parameters:

ppFieldNameMap - A reference to a com.esri.arcgis.system.IPropertySet (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getAuxiliaryFieldAlias

IPropertySet getAuxiliaryFieldAlias()
                                    throws IOException,
                                           AutomationException

Optional look-up that maps field names to possile metadata property names.

Product Availability

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

Returns:

A reference to a com.esri.arcgis.system.IPropertySet

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isCanBuildInPlace

boolean isCanBuildInPlace()
                          throws IOException,
                                 AutomationException

Indicates whether the raster type can build an item URI as soon as it is contructed.

Product Availability

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

Returns:

The pbCanBuildInPlace

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.