Enterprise Information Portal APIs

com.ibm.mm.sdk.server
Class DKDatastoreExtDD

java.lang.Object
  |
  +--com.ibm.mm.sdk.server.dkAbstractDatastoreExt
        |
        +--com.ibm.mm.sdk.server.DKDatastoreExtDD
All Implemented Interfaces:
DKConstant, DKConstantDD, dkDatastoreExt, dkExtension, DKMessageId, DKMessageIdDD

public class DKDatastoreExtDD
extends dkAbstractDatastoreExt
implements DKConstantDD, DKMessageIdDD

DKDatastoreExtDD is the implementation class of DD datastore extension object.


Fields inherited from interface com.ibm.mm.sdk.common.DKConstantDD
copyright, DK_ACTYPE_DD, DK_DD_APPEND, DK_DD_ATTR, DK_DD_BINDER, DK_DD_BLOB, DK_DD_CABINET, DK_DD_CREATE, DK_DD_CREATE_DATE, DK_DD_DATASTORE_EXT, DK_DD_DEFAULT_MIMETYPE, DK_DD_DLL_NAME, DK_DD_DOC_TYPE, DK_DD_DOCUMENT, DK_DD_DS_API_NAME, DK_DD_DSTYPE, DK_DD_FIELD, DK_DD_FILENAME, DK_DD_KEYWORD, DK_DD_LIBRARY, DK_DD_OPT_CONTENT, DK_DD_OPT_CONTENT_ATTRONLY, DK_DD_OPT_CONTENT_NO, DK_DD_OPT_CONTENT_YES, DK_DD_OPT_LIMIT, DK_DD_OPT_NO_LIMIT, DK_DD_OPT_RUN_FINALIZE_ON_EXIT, DK_DD_OPT_RUN_FINALIZE_ON_EXIT_NO, DK_DD_OPT_RUN_FINALIZE_ON_EXIT_YES, DK_DD_OPT_SEARCH_OPTION, DK_DD_OPT_SEARCH_OPTION_STEMS, DK_DD_OPT_SEARCH_OPTION_THESAURUS, DK_DD_OPT_SORT_ORDER, DK_DD_OPT_SORT_ORDER_DATE_ASC, DK_DD_OPT_SORT_ORDER_DATE_DES, DK_DD_OPT_SORT_ORDER_SCORES, DK_DD_OVERWRITE, DK_DD_PID_DOC_EXT, DK_DD_PID_DOC_ID, DK_DD_PID_DOC_ID_CNT, DK_DD_PROFILE, DK_DD_ROOM, DK_DD_SERVER_TYPE, DK_DD_TITLE, DK_DD_UNKNOWN
 
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.DKMessageIdDD
copyright, DK_DD_MSG_MSGID_DOMDOC, DK_DD_MSG_MSGID_GOVERNOR, DK_DD_MSG_MSGID_NO_ATTR_OBJ, DK_DD_MSG_MSGID_NO_BINDER_OBJ, DK_DD_MSG_MSGID_NO_CABINET_OBJ, DK_DD_MSG_MSGID_NO_DOCUMENT_OBJ, DK_DD_MSG_MSGID_NO_MESSAGE, DK_DD_MSG_MSGID_NO_ROOM_OBJ, DK_DD_MSG_MSGID_NO_SUCCESS, DK_DD_MSG_MSGID_NUL_PARAM
 
Fields inherited from interface com.ibm.mm.sdk.common.DKMessageId
    For details, see the class or interface
 
Constructor Summary
DKDatastoreExtDD()
          Default constructor for DKDatastoreExtDD.
DKDatastoreExtDD(dkDatastore ds)
          Constructs a DKDatastoreExtDD for a given datastore object.
 
Method Summary
 java.lang.String checkedOutUserid(dkDataObject item)
          Gets the userId that checkout the item from the datastore.
 void checkIn(dkDataObject item)
          Checks-in a document or folder item previously checked out from the datastore.
 void checkOut(dkDataObject item)
          Checks-out a document or folder item from the datastore.
 DKCommonPrivilege getCommonPrivilege()
          Gets the commmon privilege of a specific datastore.
 dkDatastore getDatastore()
          Gets the reference to the owning datastore object.
 java.lang.String getName()
          Gets the name of this extension object.
 boolean isCheckedOut(dkDataObject item)
          Checks if a document or folder item was checked out from the datastore.
 boolean isSupported(java.lang.String functionName)
          Query if the given function name is supported by this extension.
 java.lang.String[] listFunctions()
          Lists all supported function-names from this extension.
 void setDatastore(dkDatastore ds)
          Sets the reference to the owning datastore object.
 void setName(java.lang.String extName)
          Sets the name of this extension object.
 void unlockCheckedOut(dkDataObject item)
          Unlocks the item from the datastore
 
Methods inherited from class com.ibm.mm.sdk.server.dkAbstractDatastoreExt
addChild, addLink, addPart, addToFolder, changePassword, getCommonItemPrivilege, getCommonPrivilege, getFoldersContainingDDO, moveObject, moveObject, removeChild, removeFromFolder, removeLink, removeLinks, removePart, retrieveFormOverlay
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DKDatastoreExtDD

public DKDatastoreExtDD()
                 throws DKException,
                        java.lang.Exception
Default constructor for DKDatastoreExtDD.

DKDatastoreExtDD

public DKDatastoreExtDD(dkDatastore ds)
                 throws DKException,
                        java.lang.Exception
Constructs a DKDatastoreExtDD for a given datastore object.
Method Detail

getDatastore

public dkDatastore getDatastore()
                         throws java.lang.Exception
Gets the reference to the owning datastore object.
Overrides:
getDatastore in class dkAbstractDatastoreExt
Returns:
the dkDatastore object.

setDatastore

public void setDatastore(dkDatastore ds)
                  throws DKUsageError,
                         java.lang.Exception
Sets the reference to the owning datastore object.
Overrides:
setDatastore in class dkAbstractDatastoreExt
Parameters:
ds - datastore.

getName

public java.lang.String getName()
                         throws java.lang.Exception
Gets the name of this extension object.
Overrides:
getName in class dkAbstractDatastoreExt
Returns:
name of this object.

setName

public void setName(java.lang.String extName)
             throws java.lang.Exception
Sets the name of this extension object. This operation is not supported, since you can not change the datastore standard extension name.
Overrides:
setName in class dkAbstractDatastoreExt
Parameters:
extName - name of this extension object.

isSupported

public boolean isSupported(java.lang.String functionName)
                    throws java.lang.Exception
Query if the given function name is supported by this extension.
Overrides:
isSupported in class dkAbstractDatastoreExt
Parameters:
functionName - the name of the function providing this features
Returns:
true if this function is supported

listFunctions

public java.lang.String[] listFunctions()
                                 throws java.lang.Exception
Lists all supported function-names from this extension. Returns null if there are no functions supported.
Overrides:
listFunctions in class dkAbstractDatastoreExt
Returns:
an array of supported function names, or null if there is no function supported

checkOut

public void checkOut(dkDataObject item)
              throws DKException,
                     java.lang.Exception
Checks-out a document or folder item from the datastore. The current user will have exclusive updating privileges to the item. All other users are allowed read access only, until the object is checked back in. Note: For DD, the following rules apply:

checkIn

public void checkIn(dkDataObject item)
             throws DKException,
                    java.lang.Exception
Checks-in a document or folder item previously checked out from the datastore. Check-in releases all updating privileges to this item. Note: For DD/390, the following rules apply:

getCommonPrivilege

public DKCommonPrivilege getCommonPrivilege()
                                     throws java.lang.Exception,
                                            DKException,
                                            DKUsageError,
                                            DKDatastoreAccessError
Gets the commmon privilege of a specific datastore.
Overrides:
getCommonPrivilege in class dkAbstractDatastoreExt
Returns:
a DKCommonPrivilege object

isCheckedOut

public boolean isCheckedOut(dkDataObject item)
                     throws DKException,
                            java.lang.Exception
Checks if a document or folder item was checked out from the datastore.
Overrides:
isCheckedOut in class dkAbstractDatastoreExt
Parameters:
item - a document or folder item
Returns:
true if item was checked-out, otherwise return false

checkedOutUserid

public java.lang.String checkedOutUserid(dkDataObject item)
                                  throws DKException,
                                         java.lang.Exception
Gets the userId that checkout the item from the datastore.
Overrides:
checkedOutUserid in class dkAbstractDatastoreExt
Parameters:
item - a document or folder item
Returns:
the userid that checked out the item

unlockCheckedOut

public void unlockCheckedOut(dkDataObject item)
                      throws DKException,
                             java.lang.Exception
Unlocks the item from the datastore
Overrides:
unlockCheckedOut in class dkAbstractDatastoreExt
Parameters:
item - a document or folder item

EIP Java APIs

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