oracle.olapi.metadata.mdm
Class MdmDimension

java.lang.Object
  |
  +--oracle.olapi.metadata.BaseMetadataObject
        |
        +--oracle.olapi.metadata.mdm.MdmObject
              |
              +--oracle.olapi.metadata.mdm.MdmSource
                    |
                    +--oracle.olapi.metadata.mdm.MdmDimension

Direct Known Subclasses:

MdmPrimaryDimension, MdmSubDimension

public abstract class MdmDimension

extends MdmSource

An MdmSource that represents an OLAP dimension. A dimension organizes and specifies the data in an OLAP measure. This abstract class has two subclasses, MdmPrimaryDimension and MdmSubDimension.

An MdmPrimaryDimension has information about the type of data that its components represent. The components of an MdmPrimaryDimension are MdmSubDimension objects, which represent organizations of the elements of the dimension. Concrete subclasses of MdmSubDimension represent dimensions organized hierarchically or nonhierarchically.

You initially get MdmPrimaryDimension objects from an instance of an MdmSchema or an MdmMeasure. The getDimensions methods of those objects return lists of MdmPrimaryDimension objects.

getAttributes

public java.util.List getAttributes()

Gets a List of MdmAttribute objects for this MdmDimension.

Returns:

A List of the MdmAttribute objects for this MdmDimension.

See Also:

MdmAttribute

getPrimaryDimension

public abstract MdmPrimaryDimension getPrimaryDimension()

Gets the MdmPrimaryDimension for a concrete subclass of this MdmDimension. For an MdmSubDimension, this method returns the MdmPrimaryDimension of which the MdmSubDimension is a component. For an MdmPrimaryDimension, this method returns the same MdmPrimaryDimension object.

Returns:

The MdmPrimaryDimension for an MdmSubDimension or itself for an MdmPrimaryDimension.

getPluralDescription

public java.lang.String getPluralDescription()
                                      throws MetadataNotFoundException

Gets the long plural description of this MdmDimension. You can use this description for display in a graphical user interface when the plural of the name is required.

Returns:

A String containing the long plural description of this MdmDimension.

getShortPluralDescription

public java.lang.String getShortPluralDescription()
                                           throws MetadataNotFoundException

Gets the short plural description of this MdmDimension. You can use this description for display in a graphical user interface when the plural of the name is required.

Returns:

A String containing the short plural description of this MdmDimension.

getCardinality

public int getCardinality()
                   throws MetadataNotFoundException

Gets the cardinality (estimated number of elements) of this MdmDimension. You can use this number as a guideline for how many elements each level, hierarchy, or primary dimension is expected to contain; this information should not be presented to the user but can be used to choose between display algorithms or other potentially performance-intensive operations, or as a factor in estimating how long an operation will take. If there is no cardinality specified for this MdmDimension, this function returns -1 to indicate that no assumptions can be made about the number of elements in the MdmDimension.

Returns:

The estimated number of elements in this MdmDimension.

setPluralDescription

public void setPluralDescription(java.lang.String value)

Sets the long plural description for this MdmDimension.

Parameters:

value - A String containing the long plural description that you want this MdmDimension to have.

setShortPluralDescription

public void setShortPluralDescription(java.lang.String value)

Sets the short plural description for this MdmDimension.

Parameters:

value - A String containing the short plural description that you want this MdmDimension to have.

setCardinality

public void setCardinality(int newCardinality)

Sets the cardinality (estimated number of elements) of this MdmDimension. Specify a cardinality of -1 to indicate that no assumptions can be made about the number of elements in this MdmDimension.

Parameters:

newCardinality - The estimated number of elements in this MdmDimension.

removeAttribute

public void removeAttribute(MdmAttribute attr)

Removes the specified MdmAttribute from the attributes of this MdmDimension.

Parameters:

attr - The MdmAttribute to remove from this MdmDimension.