Package com.jedox.palojlib.main

Class Dimension

java.lang.Object

com.jedox.palojlib.main.CachedComponent

com.jedox.palojlib.main.Dimension

All Implemented Interfaces:

IDimension

public class Dimension
extends CachedComponent
implements IDimension

Nested Class Summary

Nested classes/interfaces inherited from interface com.jedox.palojlib.interfaces.IDimension

IDimension.DimensionType

Field Summary

Fields

Modifier and Type	Field	Description
protected LinkedHashMap<Integer,Element>	attributesIdMap
protected HashMap<String,Element>	attributesNameMap
protected LinkedHashMap<String,Attribute>	attributesObjectNameMap
static final int	defaultExpiryDuration
protected LinkedHashMap<Integer,Element>	elementsIdMap
protected HashMap<String,Element>	elementsNameMap
protected boolean	hasConsolidatedElements
protected DimensionInfo	info
protected boolean	withAttributeCacheExists
protected boolean	withoutAttributeCacheExists

Fields inherited from class com.jedox.palojlib.main.CachedComponent

cacheTrustExpiry

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Dimension(int contextId, int id, String name, Database database, IDimension.DimensionType type, String attributeDimensionId, String attributeCubeId, String maximumLevel, String maximumIndent, String maximumDepth, String token, String numberOfElements, String defaultRead, String defaultWrite, String defaultNA, String defaultTotal, String defaultParent)

Method Summary

Modifier and Type	Method	Description
IAttribute	addAttribute(String name, IElement.ElementType type)	Create one attribute, this method does not invalidate the cache.
void	addAttributeConsolidation(IAttribute parent, IAttribute child)	add a child for this attribute
void	addAttributes(String[] names, IElement.ElementType[] types)	Create new attributes in this dimension
void	addAttributeValues(IAttribute attribute, IElement[] elements, Object[] values)	Writes the attribute values for these elements
IElement	addBaseElement(String name, IElement.ElementType type)	Create one element, this method does not invalidate the cache.
void	addConsolidations(IConsolidation[] consolidations)	add the consolidations for the elements mentioned as parents in the consolidations set, the children will be added to the existing children list.
void	addElements(String[] names, IElement.ElementType[] types)	Create a list of elements
void	appendElements(IElement[] elements)	Add new elements with the given type or simply change type of existing elements
protected void	buildCache(boolean withAttributes)
protected boolean	cacheExists(boolean withAttributes)
protected boolean	checkCacheStatus(boolean withAttributes)
void	createVirtualDimension(IAttribute attribute)	Creates a virtual dimension specified by a dimension attribute.
IElement[]	evaluateGlobalSubset(String subsetname, IVariable[] subsetVariables)	evaluate the given subset with the set of variables
String	generateScript(IDimensionScriptContext ds)
protected Attribute	getAttributeById(int id)
IAttribute	getAttributeByName(String name)	Get an attribute using its name
IAttribute	getAttributeByName(String name, String language)
ICube	getAttributeCube()	get the attribute cube if exists
protected int	getAttributeDimensionId()
IAttribute[]	getAttributes()	Get a list of attributes for this dimension
HashMap<String,HashMap<IAttribute,Object>>	getAttributesObjectMap()
IElement[]	getBasesElements(boolean withAttributes)	Get the list of the bases elements in the dimension
protected int	getContextId()
protected Database	getDatabase()
IElement	getDefaultNAElement(boolean withAttributes)
IElement	getDefaultParentElement(boolean withAttributes)
IElement	getDefaultReadElement(boolean withAttributes)
IElement	getDefaultTotalElement(boolean withAttributes)
IElement	getDefaultWriteElement(boolean withAttributes)
DimensionInfo	getDimensionInfo()	Get the dimension info object IDimensionInfo
protected Element	getElementById(int id)
IElement	getElementByName(String name, boolean withAttributes)	Get an element using its name
IElement[]	getElements(boolean withAttributes)	Get the list of elements in the dimension
IElement[]	getElementsByName(String[] names, boolean withAttributes)	Get an array of elements using their names, an exception will be thrown if at least one of them does not exist
String[]	getGlobalSubsets()	get the list of global subsets
String[]	getGlobalSubsetVariables(String subsetname)	get the list of variables for the given global subset
int	getId()	Get the ID of the Dimension
String	getName()	Get the name of the dimension
IElement[]	getRootElements(boolean withAttributes)	Get the list of the root elements in the dimension
IDimensionScriptContext	getScriptContext()
protected DimensionInfo	getServerDimensionInfo()
IElement	getSingleElement(String elementName, boolean withAttributes, boolean withPermission)
IDimension.DimensionType	getType()	Get the dimension type IDimension.DimensionType
IDimension[]	getVirtualDimensions()	Get a list of all virtual dimensions derived from attributes of this dimension
boolean	hasConsolidatedElements()	check if at least one C-Element exists
void	moveElements(IElement[] elements, Integer[] positions)	move a list of elements to new positions
Consolidation	newConsolidation(IElement parent, IElement child, double weight)	create a consolidation object, no change is yet done to the dimension
protected DimensionInfo	refreshDimensionInfo()
int	removeAllConsolidations()	clear all consolidations that exists in the dimension
void	removeAttributeConsolidations(IAttribute attribute)	remove the consolidations for this attribute i.e.
void	removeAttributes(IAttribute[] attributes)	Removes the attributes
void	removeAttributeValues(IAttribute attribute, IElement[] elements)	Removes the attribute values for these elements in this dimension, for the given language in the attribute.
void	removeConsolidations(IElement[] elements)	remove the consolidations for these elements i.e.
void	removeElements(IElement[] elements)	removes the elements
void	removeVirtualDimension(IAttribute attribute)	Removes a virtual dimension specified by a dimension attribute.
void	rename(String name)	rename a dimension
void	resetCache()	clear any cached information if exists, the expiry trust time will not be affected
void	setWithElementPermission(boolean withPermission)	decide whether elements should be read with permission or not
void	updateConsolidations(IConsolidation[] consolidations)	update the consolidation for the elements mentioned as parents in the consolidations set.
void	updateElementsType(IElement[] elements, IElement.ElementType type)	update the types of the elements, only ElementTypes type string and numeric can be used IElement.ElementType.

Methods inherited from class com.jedox.palojlib.main.CachedComponent

endTrustTime, inTrustTime, setCacheTrustExpiry

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.jedox.palojlib.interfaces.IDimension

getAttributesMap, getChildrenMap, getSingleElement, getWeightsMap, setCacheTrustExpiry

Field Details

defaultExpiryDuration

public static final int defaultExpiryDuration

See Also:

• Constant Field Values

info

protected DimensionInfo info

withAttributeCacheExists

protected boolean withAttributeCacheExists

withoutAttributeCacheExists

protected boolean withoutAttributeCacheExists

attributesIdMap

protected LinkedHashMap<Integer,Element> attributesIdMap

elementsIdMap

protected LinkedHashMap<Integer,Element> elementsIdMap

elementsNameMap

protected HashMap<String,Element> elementsNameMap

attributesNameMap

protected HashMap<String,Element> attributesNameMap

attributesObjectNameMap

protected LinkedHashMap<String,Attribute> attributesObjectNameMap

hasConsolidatedElements

protected boolean hasConsolidatedElements

Constructor Details

Dimension

protected Dimension(int contextId,
 int id,
 String name,
 Database database,
 IDimension.DimensionType type,
 String attributeDimensionId,
 String attributeCubeId,
 String maximumLevel,
 String maximumIndent,
 String maximumDepth,
 String token,
 String numberOfElements,
 String defaultRead,
 String defaultWrite,
 String defaultNA,
 String defaultTotal,
 String defaultParent)
             throws PaloException,
PaloJException

Throws:

PaloException

PaloJException

Method Details

getName

public String getName()

Description copied from interface: IDimension

Get the name of the dimension

Specified by:

getName in interface IDimension

Returns:

name of the dimension

getType

public IDimension.DimensionType getType()

Description copied from interface: IDimension

Get the dimension type IDimension.DimensionType

Specified by:

getType in interface IDimension

Returns:

type

getDimensionInfo

public DimensionInfo getDimensionInfo()

Description copied from interface: IDimension

Get the dimension info object IDimensionInfo

Specified by:

getDimensionInfo in interface IDimension

Returns:

dimension info object

getElements

public IElement[] getElements(boolean withAttributes)
                       throws PaloException,
PaloJException

Description copied from interface: IDimension

Get the list of elements in the dimension

Specified by:

getElements in interface IDimension

Parameters:

withAttributes - true get the element attribute information as well, false this information will be ignored.

Returns:

list of elements

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

getRootElements

public IElement[] getRootElements(boolean withAttributes)
                           throws PaloException,
PaloJException

Description copied from interface: IDimension

Get the list of the root elements in the dimension

Specified by:

getRootElements in interface IDimension

Parameters:

withAttributes - true get the element attributes information as well, false this information will be ignored.

Returns:

list of root elements

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

getBasesElements

public IElement[] getBasesElements(boolean withAttributes)
                            throws PaloException,
PaloJException

Description copied from interface: IDimension

Get the list of the bases elements in the dimension

Specified by:

getBasesElements in interface IDimension

Parameters:

withAttributes - true get the element attributes information as well, false this information will be ignored.

Returns:

list of root elements

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

getAttributesObjectMap

public HashMap<String,HashMap<IAttribute,Object>> getAttributesObjectMap()

getElementByName

public IElement getElementByName(String name,
 boolean withAttributes)
                          throws PaloException,
PaloJException

Description copied from interface: IDimension

Get an element using its name

Specified by:

getElementByName in interface IDimension

Parameters:

name - name of the element

withAttributes - true get the element attributes information as well, false this information will be ignored.

Returns:

element object

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

getDefaultReadElement

public IElement getDefaultReadElement(boolean withAttributes)

Specified by:

getDefaultReadElement in interface IDimension

getDefaultParentElement

public IElement getDefaultParentElement(boolean withAttributes)

Specified by:

getDefaultParentElement in interface IDimension

getDefaultNAElement

public IElement getDefaultNAElement(boolean withAttributes)

Specified by:

getDefaultNAElement in interface IDimension

getDefaultTotalElement

public IElement getDefaultTotalElement(boolean withAttributes)

Specified by:

getDefaultTotalElement in interface IDimension

getDefaultWriteElement

public IElement getDefaultWriteElement(boolean withAttributes)

Specified by:

getDefaultWriteElement in interface IDimension

getElementsByName

public IElement[] getElementsByName(String[] names,
 boolean withAttributes)
                             throws PaloException,
PaloJException

Description copied from interface: IDimension

Get an array of elements using their names, an exception will be thrown if at least one of them does not exist

Specified by:

getElementsByName in interface IDimension

Parameters:

names - names array of the elements

withAttributes - true get the element attributes information as well, false this information will be ignored.

Returns:

element array object

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

hasConsolidatedElements

public boolean hasConsolidatedElements()

Description copied from interface: IDimension

check if at least one C-Element exists

Specified by:

hasConsolidatedElements in interface IDimension

Returns:

true, if at least one C-element exists

getAttributes

public IAttribute[] getAttributes()
                           throws PaloException,
PaloJException

Description copied from interface: IDimension

Get a list of attributes for this dimension

Specified by:

getAttributes in interface IDimension

Returns:

attributes dimension attributes

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

getAttributeByName

public IAttribute getAttributeByName(String name)
                              throws PaloException,
PaloJException

Description copied from interface: IDimension

Get an attribute using its name

Specified by:

getAttributeByName in interface IDimension

Parameters:

name - name of the attribute

Returns:

attribute object

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

getAttributeByName

public IAttribute getAttributeByName(String name,
 String language)
                              throws PaloException,
PaloJException

Specified by:

getAttributeByName in interface IDimension

Throws:

PaloException

PaloJException

addElements

public void addElements(String[] names,
 IElement.ElementType[] types)
                 throws PaloException,
PaloJException

Description copied from interface: IDimension

Create a list of elements

Specified by:

addElements in interface IDimension

Parameters:

names - the names of the new elements

types - the types of the new elements

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

appendElements

public void appendElements(IElement[] elements)
                    throws PaloException,
PaloJException

Description copied from interface: IDimension

Add new elements with the given type or simply change type of existing elements

Specified by:

appendElements in interface IDimension

Parameters:

elements - element to append

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

moveElements

public void moveElements(IElement[] elements,
 Integer[] positions)
                  throws PaloException,
PaloJException

Description copied from interface: IDimension

move a list of elements to new positions

Specified by:

moveElements in interface IDimension

Parameters:

elements - elements to move

positions - new positions

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

addBaseElement

public IElement addBaseElement(String name,
 IElement.ElementType type)
                        throws PaloJException,
PaloException

Description copied from interface: IDimension

Create one element, this method does not invalidate the cache.

Specified by:

addBaseElement in interface IDimension

Parameters:

name - the name of the new element

type - the type of the new element

Returns:

the newly created Element

Throws:

PaloJException - exception from the library itself

PaloException - exception from OLAP server

addAttribute

public IAttribute addAttribute(String name,
 IElement.ElementType type)
                        throws PaloJException,
PaloException

Description copied from interface: IDimension

Create one attribute, this method does not invalidate the cache.

Specified by:

addAttribute in interface IDimension

Parameters:

name - the name of the new attribute

type - the type of the new attribute

Returns:

the newly created attribute

Throws:

PaloJException - exception from the library itself

PaloException - exception from OLAP server

addAttributes

public void addAttributes(String[] names,
 IElement.ElementType[] types)
                   throws PaloJException,
PaloException

Description copied from interface: IDimension

Create new attributes in this dimension

Specified by:

addAttributes in interface IDimension

Parameters:

names - names of the new attributes

types - types of the new attributes

Throws:

PaloJException - exception from the library itself

PaloException - exception from OLAP server

removeConsolidations

public void removeConsolidations(IElement[] elements)
                          throws PaloException,
PaloJException

Description copied from interface: IDimension

remove the consolidations for these elements i.e. their children

Specified by:

removeConsolidations in interface IDimension

Parameters:

elements - dimension elements

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

removeAllConsolidations

public int removeAllConsolidations()
                            throws PaloException,
PaloJException

Description copied from interface: IDimension

clear all consolidations that exists in the dimension

Specified by:

removeAllConsolidations in interface IDimension

Returns:

number of C-Elements that were converted to base element

Throws:

PaloException

PaloJException

updateConsolidations

public void updateConsolidations(IConsolidation[] consolidations)
                          throws PaloException,
PaloJException

Description copied from interface: IDimension

update the consolidation for the elements mentioned as parents in the consolidations set.

Specified by:

updateConsolidations in interface IDimension

Parameters:

consolidations - element parent-child relationships

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

addAttributeConsolidation

public void addAttributeConsolidation(IAttribute parent,
 IAttribute child)
                               throws PaloJException,
PaloException

Description copied from interface: IDimension

add a child for this attribute

Specified by:

addAttributeConsolidation in interface IDimension

Parameters:

parent - dimension attribute

child - attribute child attribute

Throws:

PaloJException - exception from the library itself

PaloException - exception from OLAP server

removeAttributeConsolidations

public void removeAttributeConsolidations(IAttribute attribute)
                                   throws PaloException,
PaloJException

Description copied from interface: IDimension

remove the consolidations for this attribute i.e. its children

Specified by:

removeAttributeConsolidations in interface IDimension

Parameters:

attribute - dimension attribute

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

newConsolidation

public Consolidation newConsolidation(IElement parent,
 IElement child,
 double weight)

Description copied from interface: IDimension

create a consolidation object, no change is yet done to the dimension

Specified by:

newConsolidation in interface IDimension

Parameters:

parent - parent element

child - child element

weight - child weight

Returns:

the consolidation object

removeAttributes

public void removeAttributes(IAttribute[] attributes)
                      throws PaloException,
PaloJException

Description copied from interface: IDimension

Removes the attributes

Specified by:

removeAttributes in interface IDimension

Parameters:

attributes - names of the attributes to be removed

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

removeElements

public void removeElements(IElement[] elements)
                    throws PaloException,
PaloJException

Description copied from interface: IDimension

removes the elements

Specified by:

removeElements in interface IDimension

Parameters:

elements - names of the elements to be removed

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

addAttributeValues

public void addAttributeValues(IAttribute attribute,
 IElement[] elements,
 Object[] values)
                        throws PaloJException,
PaloException

Description copied from interface: IDimension

Writes the attribute values for these elements

Specified by:

addAttributeValues in interface IDimension

Parameters:

attribute - dimension attribute

elements - dimension elements

values - attribute new values

Throws:

PaloJException - exception from the library itself

PaloException - exception from OLAP server

removeAttributeValues

public void removeAttributeValues(IAttribute attribute,
 IElement[] elements)
                           throws PaloJException,
PaloException

Description copied from interface: IDimension

Removes the attribute values for these elements in this dimension, for the given language in the attribute.

Specified by:

removeAttributeValues in interface IDimension

Parameters:

attribute - attribute

elements - list of elements, null value means all.

Throws:

PaloJException - exception from the library itself

PaloException - exception from OLAP server

addConsolidations

public void addConsolidations(IConsolidation[] consolidations)
                       throws PaloException,
PaloJException

Description copied from interface: IDimension

add the consolidations for the elements mentioned as parents in the consolidations set, the children will be added to the existing children list. This will send one separate request per Element.

Specified by:

addConsolidations in interface IDimension

Parameters:

consolidations - element parent-child relationships

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

getAttributeCube

public ICube getAttributeCube()

Description copied from interface: IDimension

get the attribute cube if exists

Specified by:

getAttributeCube in interface IDimension

Returns:

get the attribute cube if exists, null if it does not exist

generateScript

public String generateScript(IDimensionScriptContext ds)

Specified by:

generateScript in interface IDimension

getScriptContext

public IDimensionScriptContext getScriptContext()

Specified by:

getScriptContext in interface IDimension

buildCache

protected void buildCache(boolean withAttributes)
                   throws PaloException,
PaloJException

Throws:

PaloException

PaloJException

cacheExists

protected boolean cacheExists(boolean withAttributes)

checkCacheStatus

protected boolean checkCacheStatus(boolean withAttributes)
                            throws PaloException,
PaloJException

Throws:

PaloException

PaloJException

getId

public int getId()

Description copied from interface: IDimension

Get the ID of the Dimension

Specified by:

getId in interface IDimension

Returns:

Dimension ID

rename

public void rename(String name)
            throws PaloException,
PaloJException

Description copied from interface: IDimension

rename a dimension

Specified by:

rename in interface IDimension

Parameters:

name - new dimension name

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

updateElementsType

public void updateElementsType(IElement[] elements,
 IElement.ElementType type)
                        throws PaloException,
PaloJException

Description copied from interface: IDimension

update the types of the elements, only ElementTypes type string and numeric can be used IElement.ElementType. Consolidated elements can not be included in the given list of elements.

Specified by:

updateElementsType in interface IDimension

Parameters:

elements - the new elements

type - string or numeric

Throws:

PaloException - exception from OLAP server

PaloJException - exception from the library itself

getSingleElement

public IElement getSingleElement(String elementName,
 boolean withAttributes,
 boolean withPermission)
                          throws PaloException,
PaloJException

Specified by:

getSingleElement in interface IDimension

Throws:

PaloException

PaloJException

getGlobalSubsetVariables

public String[] getGlobalSubsetVariables(String subsetname)

Description copied from interface: IDimension

get the list of variables for the given global subset

Specified by:

getGlobalSubsetVariables in interface IDimension

Parameters:

subsetname - name of the subset

Returns:

list of variables

evaluateGlobalSubset

public IElement[] evaluateGlobalSubset(String subsetname,
 IVariable[] subsetVariables)

Description copied from interface: IDimension

evaluate the given subset with the set of variables

Specified by:

evaluateGlobalSubset in interface IDimension

Parameters:

subsetname - name of the subset

subsetVariables - subset variables (can be empty)

Returns:

the list of elements in the dimension that matches the subset

getGlobalSubsets

public String[] getGlobalSubsets()

Description copied from interface: IDimension

get the list of global subsets

Specified by:

getGlobalSubsets in interface IDimension

Returns:

list of global subsets

getElementById

protected Element getElementById(int id)
                          throws PaloException,
PaloJException

Throws:

PaloException

PaloJException

getServerDimensionInfo

protected DimensionInfo getServerDimensionInfo()
                                        throws PaloException,
PaloJException

Throws:

PaloException

PaloJException

refreshDimensionInfo

protected DimensionInfo refreshDimensionInfo()
                                      throws PaloException,
PaloJException

Throws:

PaloException

PaloJException

getAttributeById

protected Attribute getAttributeById(int id)
                              throws PaloException,
PaloJException

Throws:

PaloException

PaloJException

setWithElementPermission

public void setWithElementPermission(boolean withPermission)

Description copied from interface: IDimension

decide whether elements should be read with permission or not

Specified by:

setWithElementPermission in interface IDimension

Parameters:

withPermission - true means element permission will be read as well, default is false.

resetCache

public void resetCache()

Description copied from interface: IDimension

clear any cached information if exists, the expiry trust time will not be affected

Specified by:

resetCache in interface IDimension

getContextId

protected int getContextId()

getDatabase

protected Database getDatabase()

getAttributeDimensionId

protected int getAttributeDimensionId()

createVirtualDimension

public void createVirtualDimension(IAttribute attribute)

Description copied from interface: IDimension

Creates a virtual dimension specified by a dimension attribute.

Specified by:

createVirtualDimension in interface IDimension

Parameters:

attribute - a string attribute of the dimension

removeVirtualDimension

public void removeVirtualDimension(IAttribute attribute)

Description copied from interface: IDimension

Removes a virtual dimension specified by a dimension attribute.

Specified by:

removeVirtualDimension in interface IDimension

Parameters:

attribute - a string attribute of the dimension

getVirtualDimensions

public IDimension[] getVirtualDimensions()

Description copied from interface: IDimension

Get a list of all virtual dimensions derived from attributes of this dimension

Specified by:

getVirtualDimensions in interface IDimension

Returns:

a list of virtual dimensions