psdi.app.location

Class LocHierarchySet

java.lang.Object

psdi.mbo.MboSet

psdi.app.location.LocHierarchySet

All Implemented Interfaces:

java.rmi.Remote, LocHierarchySetRemote, MboAccessInterface, MboConstants, MboSetRemote, MaxRemoteProxy, Transactable, FixedLoggerNames, FixedLoggers

public class LocHierarchySet
extends MboSet
implements LocHierarchySetRemote

Represents the set of LocHierarchys.

Field Summary

Fields inherited from class psdi.mbo.MboSet

dmDeploySet, dmDeploySkipFieldValidation, fetchStopLimitEnabled, LOOKUPMAXROW, maxSorterSize, mboCountCleanuplist, mboVec, mrdVec, perfStats, strNoBaseLangValueEntered, toBeSaved

Fields inherited from interface psdi.app.location.LocHierarchySetRemote

ANCESTORHIERARCHIES, ANCESTORHIERARCHIES_EXCLUDE_TOPLEVEL, CHILDANCESTORS, CHILDLOCATIONS, CHILDREN, HIERARCHYINSYSYTEM, INSYSTEM, LOCANCESTOR, LOCANCESTORANYSYSTEM, LOCANCESTORPARENT, LOCANCESTORSELF, LOCATIONS, LOCHIERARCHY, LOCHIERARCHY_OTHER, LOCHIERLOCOPER, LOCSYSTEM, MULTIHIERSYS, NEWPARENT, PARENTS, PARENTSANCESTORS, PARENTSANCESTORS_EXCLUDE_TOPLEVEL

Fields inherited from interface psdi.mbo.MboSetRemote

INSERTONLY, INSERTORUPDATE, UPDATEONLY

Fields inherited from interface psdi.mbo.MboConstants

ALLROWS, CHANGEDBY_USER, COUNT_ADDITIONS, COUNT_AFTERSAVE, COUNT_DATABASE, COUNT_DELETED, COUNT_EXISTING, DBCONFIG, DELAYVALIDATION, DELAYVALIDATIONONLY, DISCARDABLE, GOTCOMPLETEWHERE, HIDDEN, NO_RELATEDMBOS_OF_OWNERSCHILDREN_FETCH, NOACCESSCHECK, NOACTION, NOADD, NOCOMMIT, NODELETE, NONE, NOOVERWRITE, NOSAVE, NOSETVALUE, NOUPDATE, NOVALIDATION, NOVALIDATION_AND_NOACTION, NOVALIDATION_AND_NOACTION_ALLOWCROSSOVER, READONLY, REBUILD, REQUIRED, SAMEVALUEVALIDATION, SETBYPARENT, USER

Fields inherited from interface psdi.util.logging.FixedLoggers

APPLOGGER, CRONTASKLOGGER, CRONTASKMGRLOGGER, CRONTASKMGRSQLLOGGER, DBCONNECTIONLOGGER, DDLOGGER, DMLOGGER, EVENTLOGGER, EXCEPTIONLOGGER, MAILLOGGER, MAXIMOLOGGER, MTLOGGER, NULLMBOPOINTER, SECURITY, SENDFAILEDLOGGER, SERVICELOGGER, SQLLOGGER

Fields inherited from interface psdi.util.logging.FixedLoggerNames

appenderPrefix, LOGGERNAME_APP, LOGGERNAME_CRONTASK, LOGGERNAME_CRONTASKMGR, LOGGERNAME_DBCONNECTION, LOGGERNAME_DD, LOGGERNAME_DM, LOGGERNAME_DMPREVIEW, LOGGERNAME_EVENT, LOGGERNAME_EXCEPTION, LOGGERNAME_MAIL, LOGGERNAME_MAXIMO, LOGGERNAME_MT, LOGGERNAME_NULLMBOPOINTER, LOGGERNAME_SECURITY, LOGGERNAME_SENDFAILED, LOGGERNAME_SERVICE, LOGGERNAME_SQL, LOGGERNAME_SQL_CRONTASKMGR, LOGGERNAME_TXN, loggerPrefix

Constructor Summary

Constructors

Constructor and Description
LocHierarchySet(MboServerInterface ms) Construct the set

Method Summary

Modifier and Type	Method and Description
void	canAdd() Can an object be added to the collection ? //hierarchical system cannot add more than one parent
java.util.Vector	getDeletedLocAncestors() used for networked systems only.
java.util.Vector	getDeletionsProcessed() used for networked systems only.
protected Mbo	getMboInstance(MboSet ms) Generate a new LocHierarchy object
boolean	isChildOfThisLocHierarchyProcessedForDeletion(java.lang.String lochierarchyid) used for networked systems only.
boolean	isLocAncestorAlreadyMarkedForDeletion(java.lang.String locancestorid) used for networked systems only.
boolean	isLocLocAncCreated()
boolean	isTopLevelForNetworkedLocHierAdded(java.lang.String newTopLevelLocHier) used for networked systems only.
void	recordChildrenOfThisLocHierarchyProcessedForDeletion(java.lang.String lochierarchyid) used for networked systems only.
void	recordLocAncestorAsMarkedForDeletion(java.lang.String locancestorid) used for networked systems only.
void	recordNewTopLevelLocHierForNetworkedLocHier(java.lang.String newTopLevelLocHier) used for networked systems only.
void	save(long flags) Save the object with the specified flags.
void	saveTransaction(MXTransaction txn) 12-14257/IV27403: override saveTransaction to clear the static vector parentsVector
void	setDeletedLocAncestors(java.util.Vector deletedLocAncestors) used for networked systems only.
void	setDeletionsProcessed(java.util.Vector deletionsProcessed) used for networked systems only.
void	setLocLocAncCreated(boolean locLocAncCreated)

Methods inherited from class psdi.mbo.MboSet

abortSql, add, add, addAliasForML, addAliasForML, addAtEnd, addAtEnd, addAtIndex, addAtIndex, addFakeAtEnd, addFederatedMboToSorter, addJoinedAttribute, addMbo, addMbo, addSubQbe, addSubQbe, addSubQbe, addSubQbe, addToEndOfSelectStatement, addWarning, addWarnings, appendToWhere, applyAppSpecificAuthorization, applyRowSecurity, avg, cancelAndClose, checkMethodAccess, checkMethodAccess, cleanup, clear, clearBatchedPreparedStmt, clearBatchedPreparedStmts, clearESigTransactionIdThread, clearESigTransIDForAdmin, clearIgnoredAutokeyAttrs, clearLongOpPipe, clearToBeSaved, clearTransactionReference, clearWarnings, close, commit, commitTransaction, copy, copy, copy, copyForDM, count, count, countAndCleanup, countAndCleanup, deleteAll, deleteAll, deleteAndRemove, deleteAndRemove, deleteAndRemove, deleteAndRemove, deleteAndRemove, deleteAndRemoveAll, deleteAndRemoveAll, deleteMbo, determineRequiredFieldsFromERM, dump, earliestDate, enableMethod, executeBatch, fetchNext, findAllNullRequiredFields, findByIntegrationKey, findKey, fireEventsAfterDB, fireEventsAfterDBCommit, fireEventsBeforeDB, forceDBSort, getAllAppAlwaysFieldFlags, getAllowQualifiedRestriction, getAlwaysFlags, getAlwaysFlags, getApp, getAppAlwaysFieldFlags, getAppWhere, getAttrRestrictions, getBoolean, getByte, getBytes, getClientLocale, getClientTimeZone, getCompleteWhere, getCurrentPosition, getDate, getDBFetchMaxRows, getDefaultValue, getDefaultValueHash, getDouble, getERMEntity, getESigTransactionId, getExcludeMeFromPropagation, getFlags, getFloat, getFromClause, getIgnoredAutokeyAttrs, getInsertCompanySet, getInsertItemSet, getInsertOrg, getInsertSite, getInt, getJspDefaultValueHash, getKeyAttributes, getList, getList, getLong, getMaxAppsWhere, getMaxMessage, getMbo, getMbo, getMboCtx, getMboForUniqueId, getMboLogger, getMboServer, getMboSetData, getMboSetData, getMboSetInfo, getMboSetRetainMboPositionData, getMboSetRetainMboPositionInfo, getMboSetValueData, getMboSetValueData, getMboValueData, getMboValueData, getMboValueData, getMboValueInfoStatic, getMboValueInfoStatic, getMessage, getMessage, getMessage, getMessage, getMLFromClause, getMultiSiteWhere, getMXTransaction, getName, getOrderBy, getOwner, getParentApp, getPreparedStmt, getProfile, getProxy, getQbe, getQbe, getQbe, getQbeSiteAuthorization, getQbeWhere, getQualifiedWhere, getQueryTimeout, getRelationName, getRelationship, getRetainRecordLimit, getRowRestrictions, getSecurityLogger, getSelectClause, getSelectClause, getSelection, getSelectionWhere, getSelectWhereClause, getSetOrderByForUI, getSharedMboSet, getSize, getSkipFirstNRows, getSqlLogger, getSQLOptions, getString, getTranslator, getTxnPropertyMap, getUserAndQbeWhere, getUserInfo, getUserName, getUserPrefWhere, getUserWhere, getUserWhere, getWarnings, getWhere, getZombie, handleMLMbo, handleMLMbo, hasMLQbe, hasQbe, hasWarnings, ignoreAutokeyAttr, ignoreAutokeyAttr, ignoreQbeExactMatchSet, includeRelatedMbosOfOwnersChildren, incrementDeletedCount, init, init, initDataDictionary, insertDeltaRow, insertMbo, isBasedOn, isClosed, isDeltaStorage, isDMDeploySet, isDMSkipFieldValidation, isDownloadSet, isEAuditFieldModified, isEAuditNeeded, isEmpty, isESigFieldModified, isESigNeeded, isESigNeeded, isFlagSet, isIgnoreQbeExactMatchSet, isInMemorySort, isJoinedAttribute, isLookup, isNull, isQbeCaseSensitive, isQbeExactMatch, isRetainMboPosition, isRetainRecordEnabled, isTableDomainLookup, latestDate, locateMbo, logESigVerification, logRowUpdatedException, max, min, moveFirst, moveLast, moveNext, movePrev, moveTo, moveToKey, newMboIndex, notExist, positionState, processML, remove, remove, remove, removeAllJoinedAttributes, removeCtx, removeJoinedAttribute, reset, resetForRefreshOnSave, resetQbe, resetWithSelection, rollback, rollbackToCheckpoint, rollbackToCheckpoint, rollbackTransaction, save, save, save, saveMbos, select, select, select, selectAll, setAllowQualifiedRestriction, setApp, setAppAlwaysFieldFlag, setAppWhere, setAutoKeyFlag, setBindValueAsBytes, setDBFetchMaxRows, setDefaultOrderBy, setDefaultValue, setDefaultValue, setDefaultValues, setDefaultValues, setDiscardableFlag, setDMDeploySet, setDMSkipFieldValidation, setDownloadSet, setEAuditFieldModified, setERMEntity, setESigFieldModified, setExcludeMeFromPropagation, setFederatedResources, setFlag, setFlag, setFlags, setInsertCompanySet, setInsertItemSet, setInsertOrg, setInsertSite, setLastESigTransId, setLogLargFetchResultDisabled, setMboCtx, setMboSetInfo, setMXTransaction, setNoNeedtoFetchFromDB, setNoSaveFlag, setOrderBy, setOrderByNVL, setOverrideSelectClause, setOverrideSelectFromClause, setOverrideSelectWhereClause, setOwner, setPreserveOrderByCase, setProxy, setQbe, setQbe, setQbe, setQbe, setQbe, setQbeCaseSensitive, setQbeCaseSensitive, setQbeExactMatch, setQbeExactMatch, setQbeOperatorOr, setQueryBySiteQbe, setQueryTimeout, setRelationName, setRelationship, setRequiedFlagsFromERM, setRetainMboPosition, setSetOrderByForUI, setSkipFirstNRows, setSQLOptions, setTableDomainLookup, setTxnPropertyMap, setupLongOpPipe, setUserWhere, setUserWhereAfterParse, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValueNull, setValueNull, setWhere, setWhereQbe, smartFill, smartFill, smartFind, smartFind, smartFind, smartFind, sort, splitOrderBy, startCheckpoint, startCheckpoint, sum, toBeSaved, undeleteAll, undoTransaction, unselect, unselect, unselect, unselectAll, updateMbo, updateMboSetRetainMboPositionData, updateRelatedMboSetRetainMboPositionData, useStoredQuery, validate, validateTransaction, verifyESig

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface psdi.mbo.MboSetRemote

abortSql, add, add, addAtEnd, addAtEnd, addAtIndex, addAtIndex, addFakeAtEnd, addSubQbe, addSubQbe, addSubQbe, addSubQbe, addWarning, addWarnings, checkMethodAccess, cleanup, clear, clearLongOpPipe, close, commit, copy, copy, copyForDM, count, count, deleteAll, deleteAll, deleteAndRemove, deleteAndRemove, deleteAndRemove, deleteAndRemove, deleteAndRemove, deleteAndRemoveAll, deleteAndRemoveAll, determineRequiredFieldsFromERM, earliestDate, fetchNext, findAllNullRequiredFields, findByIntegrationKey, findKey, getApp, getAppAlwaysFieldFlags, getAppWhere, getCompleteWhere, getCurrentPosition, getDBFetchMaxRows, getDefaultValue, getERMEntity, getESigTransactionId, getExcludeMeFromPropagation, getFlags, getKeyAttributes, getList, getList, getMaxMessage, getMbo, getMbo, getMboForUniqueId, getMboSetData, getMboSetData, getMboSetInfo, getMboSetRetainMboPositionData, getMboSetRetainMboPositionInfo, getMboSetValueData, getMboValueData, getMboValueData, getMboValueData, getMboValueInfoStatic, getMboValueInfoStatic, getMessage, getMessage, getMessage, getMessage, getMLFromClause, getMXTransaction, getName, getOrderBy, getOwner, getParentApp, getProfile, getQbe, getQbe, getQbe, getQbeWhere, getQueryTimeout, getRelationName, getRelationship, getSelection, getSelectionWhere, getSetOrderByForUI, getSize, getSQLOptions, getTxnPropertyMap, getUserAndQbeWhere, getUserInfo, getUserName, getUserWhere, getWarnings, getWhere, getZombie, hasMLQbe, hasQbe, hasWarnings, ignoreQbeExactMatchSet, incrementDeletedCount, init, isBasedOn, isDMDeploySet, isDMSkipFieldValidation, isDownloadSet, isEmpty, isESigNeeded, isFlagSet, isQbeCaseSensitive, isQbeExactMatch, isRetainMboPosition, latestDate, locateMbo, logESigVerification, max, min, moveFirst, moveLast, moveNext, movePrev, moveTo, newMboIndex, notExist, positionState, processML, remove, remove, remove, reset, resetQbe, resetWithSelection, rollback, rollbackToCheckpoint, rollbackToCheckpoint, save, select, select, select, selectAll, setAllowQualifiedRestriction, setApp, setAppAlwaysFieldFlag, setAppWhere, setAutoKeyFlag, setDBFetchMaxRows, setDefaultOrderBy, setDefaultValue, setDefaultValue, setDefaultValues, setDMDeploySet, setDMSkipFieldValidation, setDownloadSet, setERMEntity, setESigFieldModified, setExcludeMeFromPropagation, setFlag, setFlag, setFlags, setInsertCompanySet, setInsertItemSet, setInsertOrg, setInsertSite, setLastESigTransId, setLogLargFetchResultDisabled, setMboSetInfo, setMXTransaction, setNoNeedtoFetchFromDB, setOrderBy, setOwner, setQbe, setQbe, setQbe, setQbe, setQbe, setQbeCaseSensitive, setQbeCaseSensitive, setQbeExactMatch, setQbeExactMatch, setQbeOperatorOr, setQueryBySiteQbe, setQueryTimeout, setRelationName, setRelationship, setRequiedFlagsFromERM, setRetainMboPosition, setSetOrderByForUI, setSQLOptions, setTableDomainLookup, setTxnPropertyMap, setupLongOpPipe, setUserWhere, setUserWhereAfterParse, setWhere, setWhereQbe, smartFill, smartFill, smartFind, smartFind, startCheckpoint, startCheckpoint, sum, toBeSaved, undeleteAll, unselect, unselect, unselect, unselectAll, useStoredQuery, validate, verifyESig

Methods inherited from interface psdi.mbo.MboAccessInterface

getBoolean, getByte, getBytes, getDate, getDouble, getFloat, getInt, getLong, getString, isNull, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValueNull, setValueNull

Methods inherited from interface psdi.txn.Transactable

commitTransaction, fireEventsAfterDB, fireEventsAfterDBCommit, fireEventsBeforeDB, rollbackTransaction, undoTransaction, validateTransaction

Constructor Detail

LocHierarchySet

public LocHierarchySet(MboServerInterface ms)
                throws MXException,
                       java.rmi.RemoteException

Construct the set

Throws:

MXException

java.rmi.RemoteException

Method Detail

getMboInstance

protected Mbo getMboInstance(MboSet ms)
                      throws MXException,
                             java.rmi.RemoteException

Generate a new LocHierarchy object

Specified by:

getMboInstance in class MboSet

Parameters:

ms - mboset

Returns:

Mbo object

Throws:

MXException

java.rmi.RemoteException

isChildOfThisLocHierarchyProcessedForDeletion

public boolean isChildOfThisLocHierarchyProcessedForDeletion(java.lang.String lochierarchyid)
                                                      throws MXException,
                                                             java.rmi.RemoteException

used for networked systems only. Checks to see if the LocHierarchy identified by 'lochierarchyid' has already been processed for deletion. That is, have the children of the LocHierarchy (and their associated LocAncestor records) been considered for deletion?

Parameters:

lochierarchyid - unique identifier of the LocHierarchy of interest used to track whether the LocHierarchy has been processed.

Throws:

MXException

java.rmi.RemoteException

isLocAncestorAlreadyMarkedForDeletion

public boolean isLocAncestorAlreadyMarkedForDeletion(java.lang.String locancestorid)
                                              throws MXException,
                                                     java.rmi.RemoteException

used for networked systems only. Checks to see if the LocAncestor identified by 'locancestorid' has already been marked for deletion. The same LocAncestor could be processed multiple times in a networked system because a node may have more than one parent, and a node can also be an ancestor and descendant to the same node.

Parameters:

locancestorid - unique identifier of the LocAncestor that will be marked for deletion if it has not already been marked for deletion earlier in the process.

Throws:

MXException

java.rmi.RemoteException

getDeletionsProcessed

public java.util.Vector getDeletionsProcessed()
                                       throws MXException,
                                              java.rmi.RemoteException

used for networked systems only. This method passes the vector of LocHierarchy records already processed from LocHierarchy set to LocHierarchy set during this recursive process. This occurs during a modification to the LocHierarchy's system. A system modification is the removal of a parent or child within a system.

Throws:

MXException

java.rmi.RemoteException

getDeletedLocAncestors

public java.util.Vector getDeletedLocAncestors()
                                        throws MXException,
                                               java.rmi.RemoteException

used for networked systems only. This method passes the vector of LocAncestor records already marked for deletion from LocHierarchy set to LocHierarchy set during this recursive process. This occurs during a modification to the LocHierarchy's system. A system modification is the removal of a parent or child within a system.

Throws:

MXException

java.rmi.RemoteException

setDeletionsProcessed

public void setDeletionsProcessed(java.util.Vector deletionsProcessed)
                           throws MXException,
                                  java.rmi.RemoteException

used for networked systems only. This method sets the vector of LocHierarchy records already processed in this LocHierarchySet's ancestor and owning LocHierarchy sets during this recursive process. This occurs during a modification to the LocHierarchy's system. A system modification is the removal of a parent or child within a system.

Throws:

MXException

java.rmi.RemoteException

setDeletedLocAncestors

public void setDeletedLocAncestors(java.util.Vector deletedLocAncestors)
                            throws MXException,
                                   java.rmi.RemoteException

used for networked systems only. This method sets the vector of LocAncestor records already marked for deletion in this LocHierarchySet's ancestor and owning LocHierarchy sets during this recursive process. This occurs during a modification to the LocHierarchy's system. A system modification is the removal of a parent or child within a system.

Throws:

MXException

java.rmi.RemoteException

recordChildrenOfThisLocHierarchyProcessedForDeletion

public void recordChildrenOfThisLocHierarchyProcessedForDeletion(java.lang.String lochierarchyid)
                                                          throws MXException,
                                                                 java.rmi.RemoteException

used for networked systems only. This method records the LocHierarchy identified by 'lochierarchyid' as already processed for deletion, that is, the children of the LocHierarchy (and their associated LocAncestor records) been considered for deletion.

Throws:

MXException

java.rmi.RemoteException

recordLocAncestorAsMarkedForDeletion

public void recordLocAncestorAsMarkedForDeletion(java.lang.String locancestorid)
                                          throws MXException,
                                                 java.rmi.RemoteException

used for networked systems only. This method records the LocAncestor identified by 'locancestorid' as already marked for deletion.

Throws:

MXException

java.rmi.RemoteException

recordNewTopLevelLocHierForNetworkedLocHier

public void recordNewTopLevelLocHierForNetworkedLocHier(java.lang.String newTopLevelLocHier)
                                                 throws MXException,
                                                        java.rmi.RemoteException

used for networked systems only. This method records is used to record the creation of a new top-level LocHierarchy record. This occurs when a LocHierarchy's parent(s) is/are deleted. Only networked hierarchies can have multiple parents. This record of the top-level addition is necessary because more than one parent can be deleted from a child in one transaction, but only one new top-level LocHierarchy should be added.

Parameters:

newTopLevelLocHier - concatenated String of LocHierarchy.Location + LocHierarchy.SystemId +LocHierarchy.SiteId

Throws:

MXException

java.rmi.RemoteException

isTopLevelForNetworkedLocHierAdded

public boolean isTopLevelForNetworkedLocHierAdded(java.lang.String newTopLevelLocHier)
                                           throws MXException,
                                                  java.rmi.RemoteException

used for networked systems only. This method records is used to record the creation of a new top-level LocHierarchy record. This occurs when a LocHierarchy's parent(s) is/are deleted. Only networked hierarchies can have multiple parents. This record of the top-level addition is necessary because more than one parent can be deleted from a child in one transaction, but only one new top-level LocHierarchy should be added.

Parameters:

newTopLevelLocHier - concatenated String of LocHierarchy.Location + LocHierarchy.SystemId +LocHierarchy.SiteId

Throws:

MXException

java.rmi.RemoteException

canAdd

public void canAdd()
            throws MXException

Can an object be added to the collection ? //hierarchical system cannot add more than one parent

Overrides:

canAdd in class MboSet

Throws:

MXException

isLocLocAncCreated

public boolean isLocLocAncCreated()

setLocLocAncCreated

public void setLocLocAncCreated(boolean locLocAncCreated)

save

public void save(long flags)
          throws MXException,
                 java.rmi.RemoteException

Description copied from class: MboSet

Save the object with the specified flags. Possible flags are :- REBUILD - Maintains the result set after the save. This is more expensive than the default save() option.

Specified by:

save in interface MboSetRemote

Overrides:

save in class MboSet

Throws:

MXException

java.rmi.RemoteException

saveTransaction

public void saveTransaction(MXTransaction txn)
                     throws MXException,
                            java.rmi.RemoteException

12-14257/IV27403: override saveTransaction to clear the static vector parentsVector

Specified by:

saveTransaction in interface Transactable

Overrides:

saveTransaction in class MboSet

Parameters:

txn - Transaction that cuased the save

Throws:

MXException - Error while saving

java.rmi.RemoteException - Network error

See Also:

Mbo.checkSiteOrgAccessForSave()