oracle.dss.util
Interface DependentID

All Known Implementing Classes:

HierarchicalQDR, QDR

public interface DependentID

Method Summary

java.util.Vector	getAllDependentIDs(java.lang.String measDim, NameConverter nc) Get all the metadata IDs this object depends on, including measures, dimensions, etc.
java.util.Vector	getDependentIDs(java.lang.String measDim) At save time, return an ordered list of runtime IDs that the caller should later, in a call to setDependentIDs, replace with persistable strings.
java.util.Vector	setDependentIDs(java.lang.String measDim, java.util.Vector newIDs) At save time, pass an ordered list of substituted IDs that the implementer should use to replace portions of its state.

Method Detail

getDependentIDs

java.util.Vector getDependentIDs(java.lang.String measDim)

At save time, return an ordered list of runtime IDs that the caller should later, in a call to setDependentIDs, replace with persistable strings. The same list is used by the caller at load time to put runtime IDs back in place of the substituted strings retrieved from the caller's XML.

Parameters:

measDim - Identifies the measure dimension string, which may be used by implementers to generate their list of dependent IDs.

Returns:

an ordered list of IDs requiring possible substitution. This number and order and origin of IDs should match the beginning of the list given back to the implementer via setDependentIDs.

getAllDependentIDs

java.util.Vector getAllDependentIDs(java.lang.String measDim,
                                    NameConverter nc)

Get all the metadata IDs this object depends on, including measures, dimensions, etc. This is a superset of getDependentIDs().

Parameters:

measDim -

Returns:

setDependentIDs

java.util.Vector setDependentIDs(java.lang.String measDim,
                                 java.util.Vector newIDs)

At save time, pass an ordered list of substituted IDs that the implementer should use to replace portions of its state. The same list is used by the caller at load time to put runtime IDs back in place of the substituted strings retrieved from the caller's XML.

Parameters:

measDim - Identifies the measure dimension string, which may be used by implementers to generate their list of dependent IDs.

newIDs - an ordered list of IDs a portion of which the implementer should use to replace IDs given out by a call to getDependentIDs. The implementer should start with the first element and continue down the list in the same order that the implementer walked giving out the IDs via getDependentIDs. Note that this list may very well contain many more IDs for other components that the caller will later pass in to those components: the implementer should know how many IDs it expects to "use" from the given list.

Returns:

the remaining ordered list of IDs after the implementer has used the newIDs IDs that it needs for its substitutions. This list will be a subset of the newIDs list, and must represent newIDs minus IDs initially handed out (and thus "consumed") by this implementer, if any.