Enterprise Information Portal APIs

com.ibm.mm.sdk.server
Class DKDatastoreQBIC

java.lang.Object
  |
  +--com.ibm.mm.sdk.server.dkAbstractDatastore
        |
        +--com.ibm.mm.sdk.server.DKDatastoreQBIC
All Implemented Interfaces:
DKConstant, DKConstantDL, dkDatastore, dkDatastoreIntQBIC, DKMessageId, DKMessageIdDL, dkQueryEvaluator, dkQueryManager

public class DKDatastoreQBIC
extends dkAbstractDatastore
implements dkDatastoreIntQBIC, DKConstantDL, DKMessageIdDL


Fields inherited from interface com.ibm.mm.sdk.common.DKConstantDL
    For details, see the class or interface
 
Fields inherited from interface com.ibm.mm.sdk.common.DKConstant
    For details, see the class or interface
 
Fields inherited from interface com.ibm.mm.sdk.common.DKMessageIdDL
DK_DL_MSG_INVNBR_TEXTMAPPING, DK_DL_MSG_MSGID_NOT_FOUND
 
Fields inherited from interface com.ibm.mm.sdk.common.DKMessageId
    For details, see the class or interface
 
Constructor Summary
DKDatastoreQBIC()
          Constructs the datastore and initializes the datastore.
DKDatastoreQBIC(java.lang.String configuration)
          Constructs the datastore and initializes the datastore.
 
Method Summary
 void addColorFeature()
          Add color feature to the current catalog
 void addColorHistogramFeature()
          Add color histogram feature to the current catalog
 void addDrawFeature()
          Add draw feature to the current catalog
 void addExtension(java.lang.String extensionName, dkExtension extensionObj)
          Adds a new extension object.
 void addFeature(int featureSelection, boolean bReCatalog)
          Add feature to the current catalog
 void addObject(dkDataObject ddo)
          Adds this ddo to this datastore.
 void addTextureFeature()
          Add texture feature to the current catalog
 java.lang.String catalogName()
          Get the current catalog name
 void closeCatalog()
          Close current catalog
 void commit()
          Commits a datastore transaction
 void connect(java.lang.String datastore_name, java.lang.String user_name, java.lang.String authentication, java.lang.String connect_string)
          Connects to a datastore.
 DKHandle connection()
          Gets the connection handle for a datastore
 void createCatalog(java.lang.String database_name, java.lang.String catalog_name)
          Create image search catalog
 void createDatabase(java.lang.String database_name)
          Create image search database
 DKDDO createDDO(java.lang.String objectType, int Flags)
          Creates a new DDO with object type, properties and attributes set for a given backend server.
 dkQuery createQuery(DKCQExpr qe)
          Creates a query object.
 dkQuery createQuery(java.lang.String command, short commandLangType, DKNVPair[] params)
          Creates a query object.
 java.lang.String databaseName()
          Get the current database name
 dkDatastoreDef datastoreDef()
          Get datastore definition
 java.lang.String datastoreName()
          Gets the name of this datastore object.
 java.lang.String datastoreType()
          Gets the datastore type for this datastore object
 void deleteCatalog(java.lang.String database_name, java.lang.String catalog_name)
          Delete image search catalog
 void deleteDatabase(java.lang.String database_name)
          Delete image search database
 void deleteObject(dkDataObject ddo)
          Deletes this ddo from this datastore.
 void destroy()
          datastore destroy - datastore cleanup if needed
 void disconnect()
          Disconnects to a datastore.
 java.lang.Object evaluate(DKCQExpr qe)
          evaluates the query.
 java.lang.Object evaluate(dkQuery query)
          evaluates the query.
 java.lang.Object evaluate(java.lang.String command, short commandLangType, DKNVPair[] params)
          evaluates the query.
 dkResultSetCursor execute(DKCQExpr qe)
          executes the query.
 dkResultSetCursor execute(dkQuery query)
          executes the query.
 dkResultSetCursor execute(java.lang.String command, short commandLangType, DKNVPair[] params)
          executes the query.
 void executeWithCallback(DKCQExpr qe, dkCallback callbackObj)
          execute the query with callback function.
 void executeWithCallback(dkQuery query, dkCallback callbackObj)
          execute the query with callback function.
 void executeWithCallback(java.lang.String command, short commandLangType, DKNVPair[] params, dkCallback callbackObj)
          execute the query with callback function.
 dkExtension getExtension(java.lang.String extensionName)
          Gets the extension object from a given extenstion name.
 java.lang.String getLibServerName()
          Get the library server name
 dkSchemaMapping getMapping(java.lang.String mappingName)
          Get mapping information for this datastore
 java.lang.Object getOption(int option)
          Gets a datastore option.
 DKHandle handle(java.lang.String type)
          Gets a datastore handle
 boolean isConnected()
          Checks to see if the datastore is connected.
 java.lang.Object listCatalogs()
          List all catalogs in the current database
 java.lang.Object listCatalogs(java.lang.String database_name)
          List all catalogs in the specified database
 java.lang.Object listColorImages()
          List all images cataloged in the color feature in the current catalog.
 java.lang.Object listDatabases()
          List all databases in the image search server
 java.lang.String[] listDataSourceNames()
          List the available datastore source names that can be used to connect with.
 dkCollection listDataSources()
          List the available datastore sources that can be used to connect with.
 java.lang.Object listDrawImages()
          List all images cataloged in the draw feature in the current catalog.
 dkCollection listEntities()
          Gets a list of entities from persistent datastore
 java.lang.String[] listEntityAttrNames(java.lang.String entityName)
          Gets a list of attribute names for a given entity name.
 dkCollection listEntityAttrs(java.lang.String entityName)
          Gets a list of attributes for a given entity name.
 java.lang.String[] listEntityNames()
          Gets a list of entity names from persistent datastore
 java.lang.String[] listExtensionNames()
          Gets the list of extension objects' names
 java.lang.Object listFeatures()
          List all features in the current catalog
 java.lang.Object listHistogramImages()
          List all images cataloged in the histogram feature in the current catalog.
 java.lang.String[] listMappingNames()
          Gets the list of the register mappings for this datastore
 java.lang.Object listSchema()
          Deprecated. Replace by listEntities
 java.lang.Object listSchemaAttributes(java.lang.String schemaEntry)
          Deprecated. Replace by listEntityAttributes
 java.lang.Object listServers()
          Deprecated. Replace by listDataSources
 java.lang.Object listTextureImages()
          List all images cataloged in the texture feature in the current catalog.
 void openCatalog(java.lang.String database_name, java.lang.String catalog_name)
          Open QBIC catalog for a specified database
 void processImageQueue()
          Process the image queue.
 void processImages(DKImageRecordQBIC[] imageList, int count)
          Process a list of images for the current catalog
 void queueImages(DKImageRecordQBIC[] imageList, int count)
          Put a list of images into the image queue for later processing
 void reCatalogImages(int featureSelectionList)
          Recatalog the images
 java.lang.String registerMapping(DKNVPair sourceMap)
          Registers mapping information to this datastore
 void removeColorFeature()
          Remove color feature from the current catalog
 void removeColorHistogramFeature()
          Remove color histogram feature from the current catalog
 void removeDrawFeature()
          Remove draw feature from the current catalog
 void removeExtension(java.lang.String extensionName)
          Remove an existing extension object
 void removeTextureFeature()
          Remove texture feature from the current catalog
 void retrieveObject(dkDataObject ddo)
          Retrieves this ddo from this datastore.
 void rollback()
          Rollback a datastore transaction
 void setOption(int option, java.lang.Object value)
          Sets a datastore option.
 void unRegisterMapping(java.lang.String mappingName)
          Unregisters mapping information for this datastore
 void updateObject(dkDataObject ddo)
          Updates this ddo in this datastore.
 java.lang.String userName()
          Gets the user name for this datastore object
 
Methods inherited from class com.ibm.mm.sdk.server.dkAbstractDatastore
addObject, addObject, addObjects, addObjects, addObjects, changePassword, clearCache, clearCache, deleteObject, deleteObject, deleteObjects, deleteObjects, deleteObjects, evaluate, execute, executeWithCallback, listAvailableServices, listSearchableEntities, listSearchableEntityNames, listSearchTemplateNames, listSearchTemplates, retrieveObject, retrieveObject, retrieveObjects, retrieveObjects, retrieveObjects, serviceMgr, startTransaction, updateObject, updateObject, updateObjects, updateObjects, updateObjects
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.ibm.mm.sdk.common.dkDatastoreIntQBIC
deleteServer, deleteUser, listUsers, updateServer, updateUser
 
Methods inherited from interface com.ibm.mm.sdk.common.dkDatastore
addObject, addObject, addObjects, addObjects, addObjects, changePassword, clearCache, clearCache, deleteObject, deleteObject, deleteObjects, deleteObjects, deleteObjects, evaluate, execute, executeWithCallback, listAvailableServices, listSearchableEntities, listSearchableEntityNames, listSearchTemplateNames, listSearchTemplates, retrieveObject, retrieveObject, retrieveObjects, retrieveObjects, retrieveObjects, serviceMgr, startTransaction, updateObject, updateObject, updateObjects, updateObjects, updateObjects
 

Constructor Detail

DKDatastoreQBIC

public DKDatastoreQBIC()
                throws DKException,
                       java.lang.Exception
Constructs the datastore and initializes the datastore.

DKDatastoreQBIC

public DKDatastoreQBIC(java.lang.String configuration)
                throws DKException,
                       java.lang.Exception
Constructs the datastore and initializes the datastore.
Method Detail

connect

public void connect(java.lang.String datastore_name,
                    java.lang.String user_name,
                    java.lang.String authentication,
                    java.lang.String connect_string)
             throws DKException,
                    java.lang.Exception
Connects to a datastore.
Specified by:
connect in interface dkDatastore
Overrides:
connect in class dkAbstractDatastore
Parameters:
datastore_name - the datastore name used for connection
user_name - the user name used for connection
authentication - the authentication used for connection
connect_string - the connect string used for connection. This is used to provide additional connection options.

disconnect

public void disconnect()
                throws DKException,
                       java.lang.Exception
Disconnects to a datastore.
Specified by:
disconnect in interface dkDatastore
Overrides:
disconnect in class dkAbstractDatastore

getOption

public java.lang.Object getOption(int option)
                           throws DKException,
                                  java.lang.Exception
Gets a datastore option.
Specified by:
getOption in interface dkDatastore
Overrides:
getOption in class dkAbstractDatastore
Parameters:
option - the option identifier
Returns:
an option value

setOption

public void setOption(int option,
                      java.lang.Object value)
               throws DKException,
                      java.lang.Exception
Sets a datastore option.
Specified by:
setOption in interface dkDatastore
Overrides:
setOption in class dkAbstractDatastore
Parameters:
option - the option identifier
value - the option value

evaluate

public java.lang.Object evaluate(java.lang.String command,
                                 short commandLangType,
                                 DKNVPair[] params)
                          throws DKException,
                                 java.lang.Exception
evaluates the query.
Specified by:
evaluate in interface dkDatastore
Overrides:
evaluate in class dkAbstractDatastore
Parameters:
command - a query string
commandLang - a query type
params - additional query option in name/value pair
Returns:
a collection of the results

evaluate

public java.lang.Object evaluate(dkQuery query)
                          throws DKException,
                                 java.lang.Exception
evaluates the query.
Specified by:
evaluate in interface dkDatastore
Overrides:
evaluate in class dkAbstractDatastore
Parameters:
query - a query object
Returns:
a collection of the results

evaluate

public java.lang.Object evaluate(DKCQExpr qe)
                          throws DKException,
                                 java.lang.Exception
evaluates the query.
Specified by:
evaluate in interface dkDatastore
Overrides:
evaluate in class dkAbstractDatastore
Parameters:
qe - a common query expression object
Returns:
a collection of the results

execute

public dkResultSetCursor execute(java.lang.String command,
                                 short commandLangType,
                                 DKNVPair[] params)
                          throws DKException,
                                 java.lang.Exception
executes the query.
Specified by:
execute in interface dkDatastore
Overrides:
execute in class dkAbstractDatastore
Parameters:
command - a query string
commandLang - a query type
params - additional query option in name/value pair
Returns:
resultSetCursor which represents a datastore cursor.

execute

public dkResultSetCursor execute(dkQuery query)
                          throws DKException,
                                 java.lang.Exception
executes the query.
Specified by:
execute in interface dkDatastore
Overrides:
execute in class dkAbstractDatastore
Parameters:
query - a query object
Returns:
resultSetCursor which represents a datastore cursor.

execute

public dkResultSetCursor execute(DKCQExpr qe)
                          throws DKException,
                                 java.lang.Exception
executes the query.
Specified by:
execute in interface dkDatastore
Overrides:
execute in class dkAbstractDatastore
Parameters:
qe - a common query expression object
Returns:
resultSetCursor which represents a datastore cursor.

executeWithCallback

public void executeWithCallback(dkQuery query,
                                dkCallback callbackObj)
                         throws DKException,
                                java.lang.Exception
execute the query with callback function.
Specified by:
executeWithCallback in interface dkDatastore
Overrides:
executeWithCallback in class dkAbstractDatastore
Parameters:
qo - a query object
callbackObj - a dkCallback object

executeWithCallback

public void executeWithCallback(java.lang.String command,
                                short commandLangType,
                                DKNVPair[] params,
                                dkCallback callbackObj)
                         throws DKException,
                                java.lang.Exception
execute the query with callback function.
Specified by:
executeWithCallback in interface dkDatastore
Overrides:
executeWithCallback in class dkAbstractDatastore
Parameters:
command - a query string
commandLang - a query type
params - additional query option in name/value pair
callbackObj - a dkCallback object

executeWithCallback

public void executeWithCallback(DKCQExpr qe,
                                dkCallback callbackObj)
                         throws DKException,
                                java.lang.Exception
execute the query with callback function.
Specified by:
executeWithCallback in interface dkDatastore
Overrides:
executeWithCallback in class dkAbstractDatastore
Parameters:
qe - a common query expression object
callbackObj - a dkCallback object

createQuery

public dkQuery createQuery(java.lang.String command,
                           short commandLangType,
                           DKNVPair[] params)
                    throws DKException,
                           java.lang.Exception
Creates a query object.
Specified by:
createQuery in interface dkDatastore
Overrides:
createQuery in class dkAbstractDatastore
Parameters:
command - a query string
commandLang - a query type
params - additional query option in name/value pair
Returns:
a query object

createQuery

public dkQuery createQuery(DKCQExpr qe)
                    throws DKException,
                           java.lang.Exception
Creates a query object.
Specified by:
createQuery in interface dkDatastore
Overrides:
createQuery in class dkAbstractDatastore
Parameters:
qe - a common query expression object

addObject

public void addObject(dkDataObject ddo)
               throws DKException,
                      java.lang.Exception
Adds this ddo to this datastore.
Specified by:
addObject in interface dkDatastore
Overrides:
addObject in class dkAbstractDatastore
Parameters:
ddo - the ddo to be added to this datastore

deleteObject

public void deleteObject(dkDataObject ddo)
                  throws DKException,
                         java.lang.Exception
Deletes this ddo from this datastore.
Specified by:
deleteObject in interface dkDatastore
Overrides:
deleteObject in class dkAbstractDatastore
Parameters:
ddo - the ddo to be deleted from this datastore

retrieveObject

public void retrieveObject(dkDataObject ddo)
                    throws DKException,
                           java.lang.Exception
Retrieves this ddo from this datastore.
Specified by:
retrieveObject in interface dkDatastore
Overrides:
retrieveObject in class dkAbstractDatastore
Parameters:
ddo - the ddo to be retrieved from this datastore

updateObject

public void updateObject(dkDataObject ddo)
                  throws DKException,
                         java.lang.Exception
Updates this ddo in this datastore.
Specified by:
updateObject in interface dkDatastore
Overrides:
updateObject in class dkAbstractDatastore
Parameters:
ddo - the ddo to be updated in this datastore

commit

public void commit()
            throws DKException,
                   java.lang.Exception
Commits a datastore transaction
Specified by:
commit in interface dkDatastore
Overrides:
commit in class dkAbstractDatastore

rollback

public void rollback()
              throws DKException,
                     java.lang.Exception
Rollback a datastore transaction
Specified by:
rollback in interface dkDatastore
Overrides:
rollback in class dkAbstractDatastore

isConnected

public boolean isConnected()
                    throws java.lang.Exception
Checks to see if the datastore is connected.
Specified by:
isConnected in interface dkDatastore
Overrides:
isConnected in class dkAbstractDatastore
Returns:
true if connected

datastoreName

public java.lang.String datastoreName()
                               throws java.lang.Exception
Gets the name of this datastore object. Usually it represents a datastore source's server name.
Specified by:
datastoreName in interface dkDatastore
Overrides:
datastoreName in class dkAbstractDatastore
Returns:
datastore name

datastoreType

public java.lang.String datastoreType()
                               throws java.lang.Exception
Gets the datastore type for this datastore object
Specified by:
datastoreType in interface dkDatastore
Overrides:
datastoreType in class dkAbstractDatastore
Returns:
datastore type

connection

public DKHandle connection()
                    throws java.lang.Exception
Gets the connection handle for a datastore
Specified by:
connection in interface dkDatastore
Overrides:
connection in class dkAbstractDatastore
Returns:
connection handle

handle

public DKHandle handle(java.lang.String type)
                throws java.lang.Exception
Gets a datastore handle
Specified by:
handle in interface dkDatastore
Overrides:
handle in class dkAbstractDatastore
Parameters:
type - type of datastore handle wanted
Returns:
a datastore handle

userName

public java.lang.String userName()
                          throws java.lang.Exception
Gets the user name for this datastore object
Specified by:
userName in interface dkDatastore
Overrides:
userName in class dkAbstractDatastore
Returns:
user name

listDataSources

public dkCollection listDataSources()
                             throws DKException,
                                    java.lang.Exception
List the available datastore sources that can be used to connect with.
Specified by:
listDataSources in interface dkDatastore
Overrides:
listDataSources in class dkAbstractDatastore
Returns:
a collection of server definitions

listDataSourceNames

public java.lang.String[] listDataSourceNames()
                                       throws DKException,
                                              java.lang.Exception
List the available datastore source names that can be used to connect with.
Specified by:
listDataSourceNames in interface dkDatastore
Overrides:
listDataSourceNames in class dkAbstractDatastore
Returns:
an array of server names

listServers

public java.lang.Object listServers()
                             throws DKException,
                                    java.lang.Exception
Deprecated. Replace by listDataSources

List the available datastore sources that can be used to connect with.
Specified by:
listServers in interface dkDatastore
Overrides:
listServers in class dkAbstractDatastore
Returns:
a collection of server definitions
See Also:
listDataSources()

listSchema

public java.lang.Object listSchema()
                            throws DKException,
                                   java.lang.Exception
Deprecated. Replace by listEntities

List the entities that belong to this datastore
Specified by:
listSchema in interface dkDatastore
Overrides:
listSchema in class dkAbstractDatastore
Returns:
an object that contains the schema
See Also:
listEntities()

listSchemaAttributes

public java.lang.Object listSchemaAttributes(java.lang.String schemaEntry)
                                      throws DKException,
                                             java.lang.Exception
Deprecated. Replace by listEntityAttributes

List the attributes that belong to a schema.
Specified by:
listSchemaAttributes in interface dkDatastore
Overrides:
listSchemaAttributes in class dkAbstractDatastore
Parameters:
schemaEntry - the name of the schema.
Returns:
an object that contains the attributes that belong to this schema
See Also:
listEntityAttrs(java.lang.String)

listEntities

public dkCollection listEntities()
                          throws DKException,
                                 java.lang.Exception
Gets a list of entities from persistent datastore
Specified by:
listEntities in interface dkDatastore
Overrides:
listEntities in class dkAbstractDatastore
Returns:
a collection of entity defs
Throws:
DKException - if error occurs

listEntityNames

public java.lang.String[] listEntityNames()
                                   throws DKException,
                                          java.lang.Exception
Gets a list of entity names from persistent datastore
Specified by:
listEntityNames in interface dkDatastore
Overrides:
listEntityNames in class dkAbstractDatastore
Returns:
an array of entity names
Throws:
DKException - if error occurs

listEntityAttrs

public dkCollection listEntityAttrs(java.lang.String entityName)
                             throws DKException,
                                    java.lang.Exception
Gets a list of attributes for a given entity name.
Specified by:
listEntityAttrs in interface dkDatastore
Overrides:
listEntityAttrs in class dkAbstractDatastore
Parameters:
entityName - name of entity to retrieve attributes for
Returns:
a dkCollection of dkAttrDef objects
Throws:
DKException - if the entity name does not exist

listEntityAttrNames

public java.lang.String[] listEntityAttrNames(java.lang.String entityName)
                                       throws DKException,
                                              java.lang.Exception
Gets a list of attribute names for a given entity name.
Specified by:
listEntityAttrNames in interface dkDatastore
Overrides:
listEntityAttrNames in class dkAbstractDatastore
Parameters:
entityName - name of entity to retrieve attribute names for
Returns:
an array of attribute names
Throws:
DKException - if the entity name does not exist

destroy

public void destroy()
             throws DKException,
                    java.lang.Exception
datastore destroy - datastore cleanup if needed
Specified by:
destroy in interface dkDatastore
Overrides:
destroy in class dkAbstractDatastore

createDatabase

public void createDatabase(java.lang.String database_name)
                    throws DKException,
                           java.lang.Exception
Create image search database
Specified by:
createDatabase in interface dkDatastoreIntQBIC
Parameters:
database_name - database name

deleteDatabase

public void deleteDatabase(java.lang.String database_name)
                    throws DKException,
                           java.lang.Exception
Delete image search database
Specified by:
deleteDatabase in interface dkDatastoreIntQBIC
Parameters:
database_name - database name

createCatalog

public void createCatalog(java.lang.String database_name,
                          java.lang.String catalog_name)
                   throws DKException,
                          java.lang.Exception
Create image search catalog
Specified by:
createCatalog in interface dkDatastoreIntQBIC
Parameters:
database_name - database name
catalog_name - catalog name

deleteCatalog

public void deleteCatalog(java.lang.String database_name,
                          java.lang.String catalog_name)
                   throws DKException,
                          java.lang.Exception
Delete image search catalog
Specified by:
deleteCatalog in interface dkDatastoreIntQBIC
Parameters:
database_name - database name
catalog_name - catalog name

openCatalog

public void openCatalog(java.lang.String database_name,
                        java.lang.String catalog_name)
                 throws DKException,
                        java.lang.Exception
Open QBIC catalog for a specified database
Specified by:
openCatalog in interface dkDatastoreIntQBIC
Parameters:
database_name - database name
catalog_name - catalog name

closeCatalog

public void closeCatalog()
                  throws DKException,
                         java.lang.Exception
Close current catalog
Specified by:
closeCatalog in interface dkDatastoreIntQBIC

addColorFeature

public void addColorFeature()
                     throws DKException,
                            java.lang.Exception
Add color feature to the current catalog
Specified by:
addColorFeature in interface dkDatastoreIntQBIC

addDrawFeature

public void addDrawFeature()
                    throws DKException,
                           java.lang.Exception
Add draw feature to the current catalog
Specified by:
addDrawFeature in interface dkDatastoreIntQBIC

addColorHistogramFeature

public void addColorHistogramFeature()
                              throws DKException,
                                     java.lang.Exception
Add color histogram feature to the current catalog
Specified by:
addColorHistogramFeature in interface dkDatastoreIntQBIC

addTextureFeature

public void addTextureFeature()
                       throws DKException,
                              java.lang.Exception
Add texture feature to the current catalog
Specified by:
addTextureFeature in interface dkDatastoreIntQBIC

addFeature

public void addFeature(int featureSelection,
                       boolean bReCatalog)
                throws DKException,
                       java.lang.Exception
Add feature to the current catalog
Specified by:
addFeature in interface dkDatastoreIntQBIC
Parameters:
featureSelection - specific feature
bReCatalog - when true image search server reanalyze the new feature for existing images.

removeColorFeature

public void removeColorFeature()
                        throws DKException,
                               java.lang.Exception
Remove color feature from the current catalog
Specified by:
removeColorFeature in interface dkDatastoreIntQBIC

removeDrawFeature

public void removeDrawFeature()
                       throws DKException,
                              java.lang.Exception
Remove draw feature from the current catalog
Specified by:
removeDrawFeature in interface dkDatastoreIntQBIC

removeColorHistogramFeature

public void removeColorHistogramFeature()
                                 throws DKException,
                                        java.lang.Exception
Remove color histogram feature from the current catalog
Specified by:
removeColorHistogramFeature in interface dkDatastoreIntQBIC

removeTextureFeature

public void removeTextureFeature()
                          throws DKException,
                                 java.lang.Exception
Remove texture feature from the current catalog
Specified by:
removeTextureFeature in interface dkDatastoreIntQBIC

processImages

public void processImages(DKImageRecordQBIC[] imageList,
                          int count)
                   throws DKException,
                          java.lang.Exception
Process a list of images for the current catalog
Specified by:
processImages in interface dkDatastoreIntQBIC
Parameters:
imageList - Image Record list
count - number of objects in the array

queueImages

public void queueImages(DKImageRecordQBIC[] imageList,
                        int count)
                 throws DKException,
                        java.lang.Exception
Put a list of images into the image queue for later processing
Specified by:
queueImages in interface dkDatastoreIntQBIC
Parameters:
imageList - Image Record list
count - number of objects in the array

processImageQueue

public void processImageQueue()
                       throws DKException,
                              java.lang.Exception
Process the image queue.
Specified by:
processImageQueue in interface dkDatastoreIntQBIC

reCatalogImages

public void reCatalogImages(int featureSelectionList)
                     throws DKException,
                            java.lang.Exception
Recatalog the images
Specified by:
reCatalogImages in interface dkDatastoreIntQBIC
Parameters:
featureSelectionList - feature list. features are ored together.

listDatabases

public java.lang.Object listDatabases()
                               throws DKException,
                                      java.lang.Exception
List all databases in the image search server
Specified by:
listDatabases in interface dkDatastoreIntQBIC
Returns:
a collection of DKIndexQBIC objects

listCatalogs

public java.lang.Object listCatalogs()
                              throws DKException,
                                     java.lang.Exception
List all catalogs in the current database
Specified by:
listCatalogs in interface dkDatastoreIntQBIC
Returns:
a collection of DKIndexQBIC objects

listCatalogs

public java.lang.Object listCatalogs(java.lang.String database_name)
                              throws DKException,
                                     java.lang.Exception
List all catalogs in the specified database
Specified by:
listCatalogs in interface dkDatastoreIntQBIC
Parameters:
database_name - database name
Returns:
a collection of DKIndexQBIC objects

listFeatures

public java.lang.Object listFeatures()
                              throws DKException,
                                     java.lang.Exception
List all features in the current catalog
Specified by:
listFeatures in interface dkDatastoreIntQBIC
Returns:
a collection of DKIndexQBIC objects

listColorImages

public java.lang.Object listColorImages()
                                 throws DKException,
                                        java.lang.Exception
List all images cataloged in the color feature in the current catalog.
Specified by:
listColorImages in interface dkDatastoreIntQBIC
Returns:
a collection of DKImageInfoQBIC objects

listHistogramImages

public java.lang.Object listHistogramImages()
                                     throws DKException,
                                            java.lang.Exception
List all images cataloged in the histogram feature in the current catalog.
Specified by:
listHistogramImages in interface dkDatastoreIntQBIC
Returns:
a collection of DKImageInfoQBIC objects

listDrawImages

public java.lang.Object listDrawImages()
                                throws DKException,
                                       java.lang.Exception
List all images cataloged in the draw feature in the current catalog.
Specified by:
listDrawImages in interface dkDatastoreIntQBIC
Returns:
a collection of DKImageInfoQBIC objects

listTextureImages

public java.lang.Object listTextureImages()
                                   throws DKException,
                                          java.lang.Exception
List all images cataloged in the texture feature in the current catalog.
Specified by:
listTextureImages in interface dkDatastoreIntQBIC
Returns:
a collection of DKImageInfoQBIC objects

databaseName

public java.lang.String databaseName()
                              throws DKException,
                                     java.lang.Exception
Get the current database name
Specified by:
databaseName in interface dkDatastoreIntQBIC
Returns:
the database name

catalogName

public java.lang.String catalogName()
                             throws DKException,
                                    java.lang.Exception
Get the current catalog name
Specified by:
catalogName in interface dkDatastoreIntQBIC
Returns:
the catalog name

getLibServerName

public java.lang.String getLibServerName()
                                  throws DKException,
                                         java.lang.Exception
Get the library server name
Specified by:
getLibServerName in interface dkDatastoreIntQBIC
Returns:
the library server name

datastoreDef

public dkDatastoreDef datastoreDef()
                            throws DKException,
                                   java.lang.Exception
Get datastore definition
Specified by:
datastoreDef in interface dkDatastore
Overrides:
datastoreDef in class dkAbstractDatastore
Returns:
the meta-data (dkDatastoreDef) of this datastore

registerMapping

public java.lang.String registerMapping(DKNVPair sourceMap)
                                 throws DKException,
                                        java.lang.Exception
Registers mapping information to this datastore
Specified by:
registerMapping in interface dkDatastore
Overrides:
registerMapping in class dkAbstractDatastore
Parameters:
sourceMap - source name and mapping
Returns:
the mapping name for the mapping information

unRegisterMapping

public void unRegisterMapping(java.lang.String mappingName)
                       throws DKException,
                              java.lang.Exception
Unregisters mapping information for this datastore
Specified by:
unRegisterMapping in interface dkDatastore
Overrides:
unRegisterMapping in class dkAbstractDatastore
Parameters:
mappingName - name of the mapping information
Returns:
an array of register mapping objects' names

listMappingNames

public java.lang.String[] listMappingNames()
                                    throws DKException,
                                           java.lang.Exception
Gets the list of the register mappings for this datastore
Specified by:
listMappingNames in interface dkDatastore
Overrides:
listMappingNames in class dkAbstractDatastore
Returns:
an array of register mapping objects' names

getMapping

public dkSchemaMapping getMapping(java.lang.String mappingName)
                           throws DKException,
                                  java.lang.Exception
Get mapping information for this datastore
Specified by:
getMapping in interface dkDatastore
Overrides:
getMapping in class dkAbstractDatastore
Parameters:
mappingName - name of the mapping information
Returns:
the schema mapping object

getExtension

public dkExtension getExtension(java.lang.String extensionName)
                         throws DKException,
                                java.lang.Exception
Gets the extension object from a given extenstion name.
Specified by:
getExtension in interface dkDatastore
Overrides:
getExtension in class dkAbstractDatastore
Parameters:
extensionName - name of the extension object.
Returns:
extension object.

addExtension

public void addExtension(java.lang.String extensionName,
                         dkExtension extensionObj)
                  throws DKException,
                         java.lang.Exception
Adds a new extension object.
Specified by:
addExtension in interface dkDatastore
Overrides:
addExtension in class dkAbstractDatastore
Parameters:
extensionName - name of new extension object
extensionObj - the extension object to be set

removeExtension

public void removeExtension(java.lang.String extensionName)
                     throws DKException,
                            java.lang.Exception
Remove an existing extension object
Specified by:
removeExtension in interface dkDatastore
Overrides:
removeExtension in class dkAbstractDatastore
Parameters:
extensionName - name of extension object to be removed

listExtensionNames

public java.lang.String[] listExtensionNames()
                                      throws DKException,
                                             java.lang.Exception
Gets the list of extension objects' names
Specified by:
listExtensionNames in interface dkDatastore
Overrides:
listExtensionNames in class dkAbstractDatastore
Returns:
an array of extension objects' names

createDDO

public DKDDO createDDO(java.lang.String objectType,
                       int Flags)
                throws DKException,
                       java.lang.Exception
Creates a new DDO with object type, properties and attributes set for a given backend server.
Specified by:
createDDO in interface dkDatastore
Overrides:
createDDO in class dkAbstractDatastore
Parameters:
objectType - the object type you want to create
Flags - to indicate various options to specify more detail characteristics of the DDO to create. For example, it may be a directive to create a document DDO, a folder, etc.
Returns:
a new DDO of the given object type with all the properties and attributes set, so that the user only need to set the attribute values

EIP Java APIs

(c) Copyright International Business Machines Corporation 1996, 2002. IBM Corp. All rights reserved.