mondrian.rolap

Class RolapResult

java.lang.Object

mondrian.olap.ResultBase

mondrian.rolap.RolapResult

All Implemented Interfaces:

Result

public class RolapResult
extends ResultBase

A RolapResult is the result of running a query.

Since:

10 August, 2001

Author:

jhyde

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	RolapResult.CellFormatterValueFormatter A CellFormatterValueFormatter uses a user-defined CellFormatter to format values.
(package private) static class	RolapResult.CellInfo A CellInfo contains all of the information that a Cell requires.
(package private) static interface	RolapResult.CellInfoContainer API for the creation and lookup of RolapResult.CellInfo objects.
(package private) static class	RolapResult.CellInfoMap Implementation of RolapResult.CellInfoContainer which uses a Map to store CellInfo Objects.
(package private) static class	RolapResult.CellInfoPool Implementation of RolapResult.CellInfoContainer which uses an ObjectPool to store RolapResult.CellInfo Objects.
(package private) static class	RolapResult.FormatValueFormatter A FormatValueFormatter takes a Locale as a parameter and uses it to get the Format to be used in formatting an Object value with a given format string.
protected static class	RolapResult.RolapResultEvaluatorRoot Extension to RolapEvaluatorRoot which is capable of evaluating sets and named sets. A given set is only evaluated once each time a query is executed; the result is added to the RolapResult.RolapResultEvaluatorRoot.namedSetEvaluators cache on first execution and re-used.
(package private) static interface	RolapResult.ValueFormatter Formatter to convert values into formatted strings.

Field Summary

Fields

Modifier and Type	Field and Description
protected static Map<Locale,RolapResult.ValueFormatter>	formatValueFormatters Synchronized Map from Locale to ValueFormatter.
(package private) static org.apache.log4j.Logger	LOGGER
(package private) RolapEvaluator	slicerEvaluator

Fields inherited from class mondrian.olap.ResultBase

axes, execution, query, slicerAxis, statement

Constructor Summary

Constructors

Constructor and Description
RolapResult(Execution execution, boolean execute) Creates a RolapResult.

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
(package private) TupleIterable	evalExecute(List<List<Member>> nonAllMembers, int cnt, RolapEvaluator evaluator, QueryAxis queryAxis, Calc calc)
(package private) void	evalLoad(List<List<Member>> nonAllMembers, int cnt, Evaluator evaluator, QueryAxis axis, Calc calc, mondrian.rolap.RolapResult.AxisMemberList axisMembers)
(package private) Object	evaluateExp(Calc calc, RolapEvaluator slicerEvaluator, Evaluator contextEvaluator) Evaluates an expression.
Axis[]	getAxes() Returns the non-slicer axes.
Cell	getCell(int[] pos) Get the Cell for the given Cell position.
(package private) RolapMember[]	getCellMembers(int[] pos) Called only by RolapCell.
(package private) int	getCellOrdinal(int[] pos) Converts a set of cell coordinates to a cell ordinal.
RolapCube	getCube()
(package private) Evaluator	getEvaluator(int[] pos)
Execution	getExecution()
protected org.apache.log4j.Logger	getLogger()
(package private) Evaluator	getRootEvaluator()
(package private) boolean	isDirty()
protected void	loadMembers(List<List<Member>> nonAllMembers, RolapEvaluator evaluator, QueryAxis axis, Calc calc, mondrian.rolap.RolapResult.AxisMemberList axisMembers)
protected void	loadSpecialMembers(List<Member> nonDefaultAllMembers, List<List<Member>> nonAllMembers, List<Member> measureMembers) Finds all root Members 1) whose Hierarchy does not have an ALL Member, 2) whose default Member is not the ALL Member and 3) all Measures.
protected void	makeModulos() Instantiates the calculator to convert cell coordinates to a cell ordinal and vice versa.
(package private) static TupleList	mergeAxes(TupleList axis1, TupleIterable axis2, boolean ordered)
(package private) void	populateEvaluator(Evaluator evaluator, int[] pos)
protected boolean	removeDimension(Dimension dimension, List<List<Member>> memberLists)
protected boolean	replaceNonAllMembers(List<List<Member>> nonAllMembers, mondrian.rolap.RolapResult.AxisMemberList axisMembers)

Methods inherited from class mondrian.olap.ResultBase

getMember, getQuery, getSlicerAxis, print

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

static final org.apache.log4j.Logger LOGGER

slicerEvaluator

RolapEvaluator slicerEvaluator

formatValueFormatters

protected static final Map<Locale,RolapResult.ValueFormatter> formatValueFormatters

Synchronized Map from Locale to ValueFormatter. It is expected that there will be only a small number of Locale's. Should these be a WeakHashMap?

Constructor Detail

RolapResult

RolapResult(Execution execution,
           boolean execute)

Creates a RolapResult.

Parameters:

execution - Execution of a statement

execute - Whether to execute the query

Method Detail

close

public void close()

Specified by:

close in interface Result

Overrides:

close in class ResultBase

removeDimension

protected boolean removeDimension(Dimension dimension,
                      List<List<Member>> memberLists)

getExecution

public final Execution getExecution()

replaceNonAllMembers

protected boolean replaceNonAllMembers(List<List<Member>> nonAllMembers,
                           mondrian.rolap.RolapResult.AxisMemberList axisMembers)

loadMembers

protected void loadMembers(List<List<Member>> nonAllMembers,
               RolapEvaluator evaluator,
               QueryAxis axis,
               Calc calc,
               mondrian.rolap.RolapResult.AxisMemberList axisMembers)

evalLoad

void evalLoad(List<List<Member>> nonAllMembers,
            int cnt,
            Evaluator evaluator,
            QueryAxis axis,
            Calc calc,
            mondrian.rolap.RolapResult.AxisMemberList axisMembers)

evalExecute

TupleIterable evalExecute(List<List<Member>> nonAllMembers,
                        int cnt,
                        RolapEvaluator evaluator,
                        QueryAxis queryAxis,
                        Calc calc)

loadSpecialMembers

protected void loadSpecialMembers(List<Member> nonDefaultAllMembers,
                      List<List<Member>> nonAllMembers,
                      List<Member> measureMembers)

Finds all root Members 1) whose Hierarchy does not have an ALL Member, 2) whose default Member is not the ALL Member and 3) all Measures.

Parameters:

nonDefaultAllMembers - List of all root Members for Hierarchies whose default Member is not the ALL Member.

nonAllMembers - List of root Members for Hierarchies that have no ALL Member.

measureMembers - List all Measures

getLogger

protected org.apache.log4j.Logger getLogger()

Specified by:

getLogger in class ResultBase

getCube

public final RolapCube getCube()

getAxes

public Axis[] getAxes()

Description copied from interface: Result

Returns the non-slicer axes.

Specified by:

getAxes in interface Result

Overrides:

getAxes in class ResultBase

getCell

public Cell getCell(int[] pos)

Get the Cell for the given Cell position.

Parameters:

pos - Cell position.

Returns:

the Cell associated with the Cell position.

isDirty

boolean isDirty()

evaluateExp

Object evaluateExp(Calc calc,
                 RolapEvaluator slicerEvaluator,
                 Evaluator contextEvaluator)

Evaluates an expression. Intended for evaluating named sets.

Does not modify the contents of the evaluator.

Parameters:

calc - Compiled expression

slicerEvaluator - Evaluation context for slicers

contextEvaluator - Evaluation context (optional)

Returns:

Result

getCellOrdinal

int getCellOrdinal(int[] pos)

Converts a set of cell coordinates to a cell ordinal.

This method can be expensive, because the ordinal is computed from the length of the axes, and therefore the axes need to be instantiated.

makeModulos

protected void makeModulos()

Instantiates the calculator to convert cell coordinates to a cell ordinal and vice versa.

To create the calculator, any axis that is based upon an Iterable is converted into a List - thus increasing memory usage.

getCellMembers

RolapMember[] getCellMembers(int[] pos)

Called only by RolapCell. Use this when creating an Evaluator is not required.

Parameters:

pos - Coordinates of cell

Returns:

Members which form the context of the given cell

getRootEvaluator

Evaluator getRootEvaluator()

getEvaluator

Evaluator getEvaluator(int[] pos)

populateEvaluator

void populateEvaluator(Evaluator evaluator,
                     int[] pos)

mergeAxes

static TupleList mergeAxes(TupleList axis1,
                  TupleIterable axis2,
                  boolean ordered)