mondrian.olap.fun
Class ParameterFunDef

java.lang.Object
  org.eigenbase.xom.XMLUtil
      org.eigenbase.xom.XOMUtil
          mondrian.olap.Util
              mondrian.olap.fun.FunUtil
                  mondrian.olap.fun.FunDefBase
                      mondrian.olap.fun.ParameterFunDef

All Implemented Interfaces:

FunDef

public class ParameterFunDef
extends FunDefBase

A ParameterFunDef is a pseudo-function describing calls to Parameter and ParamRef functions. It exists only fleetingly, and is then converted into a Parameter. For internal use only.

Since:

Feb 14, 2003

Author:

jhyde

Nested Class Summary

static class	ParameterFunDef.ParameterResolver Resolves calls to the Parameter MDX function.
static class	ParameterFunDef.ParamRefResolver Resolves calls to the ParamRef MDX function.

Nested classes/interfaces inherited from class mondrian.olap.fun.FunUtil

FunUtil.DescendingValueComparator, FunUtil.Flag, FunUtil.ObjIntPair<T>, FunUtil.OrderKey, FunUtil.Quicksorter<T>, FunUtil.SetWrapper, FunUtil.SortKeySpec, FunUtil.TupleExpMemoComparator

Nested classes/interfaces inherited from class mondrian.olap.Util

Util.AbstractFlatList<T>, Util.ErrorCellValue, Util.Flat2List<T>, Util.Flat3List<T>, Util.Functor1<RT,PT>, Util.GcIterator<T>, Util.MemoryInfo, Util.PropertyList, Util.SqlNullSafeComparator

Field Summary

Exp	exp
String	parameterDescription
String	parameterName

Fields inherited from class mondrian.olap.fun.FunDefBase

flags, parameterCategories, returnCategory, signature

Fields inherited from class mondrian.olap.fun.FunUtil

BooleanNull, DoubleEmpty, DoubleNull, emptyStringArray, IntegerNull, NullMember

Fields inherited from class mondrian.olap.Util

DEBUG, EmptyValue, IBM_JVM, JdbcVersion, nl, nullValue, PreJdk15, PreJdk16, Retrowoven

Constructor Summary

ParameterFunDef(FunDef funDef, String parameterName, Type type, int returnCategory, Exp exp, String description)

Method Summary

Exp	createCall(Validator validator, Exp[] args) Creates an expression which represents a call to this function with a given set of arguments.
static String	getParameterName(Exp[] args)
static Type	getParameterType(Exp[] args) Returns an approximate type for a parameter, based upon the 1'th argument.
Type	getResultType(Validator validator, Exp[] args) Returns the type of a call to this function with a given set of arguments. The default implementation makes the coarse assumption that the return type is in some way related to the type of the first argument.

Methods inherited from class mondrian.olap.fun.FunDefBase

castType, compileCall, getDescription, getName, getParameterCategories, getReturnCategory, getSignature, getSyntax, unparse, validateArg

Methods inherited from class mondrian.olap.fun.FunUtil

addMembers, addMembers, addUnique, ancestor, appendTuple, avg, box, box, checkCompatible, checkIterListResultStyles, checkListResultStyles, compareHierarchically, compareSiblingMembers, compareValues, compareValues, correlation, count, cousin, covariance, createDummyFunDef, decodeCategory, decodeParameterCategories, decodeReturnCategory, decodeSyntacticType, equalTuple, evaluateMembers, evaluateSet, evaluateSet, evaluateTuples, getDimensionDefaultHierarchy, getLiteralArg, getLiteralArg, getNonEmptyLevelMembers, getNonEmptyMemberChildren, hierarchizeMemberList, hierarchizeTupleList, hierarchyMembers, isAncestorOf, levelMembers, makeNullMember, makeNullTuple, max, memberRange, min, newEvalException, newEvalException, newEvalException, parseMember, parseMemberList, parseTuple, parseTupleList, partiallySortMembers, partiallySortTuples, partialSort, percentile, periodsToDate, quartile, removeCalculatedMembers, removeCalculatedMembers, resolveFunArgs, sortMembers, sortMembers, sortTuples, sortTuples, stablePartialSort, stdev, sum, sumDouble, sumDouble, toPercent, tupleContainsNullMember, tupleContainsNullMember, var, worthCaching

Methods inherited from class mondrian.olap.Util

addDatabaseTime, addLevelCalculatedMembers, append, appendArrays, areOccurencesEqual, assertPostcondition, assertPostcondition, assertPrecondition, assertPrecondition, assertTrue, assertTrue, badValue, binarySearch, camelToUpper, canCast, cancelAndCloseStatement, caseSensitiveCompareName, cast, cast, castToIterable, checkCJResultLimit, commaList, compare, compareKey, compareName, compileScript, convert, convert, convertOlap4jConnectStringToNativeMondrian, convertStackToString, copyOf, copyOf, copyOf, copyOf, copyOf, createExpr, createRandom, createRootRole, createSimpleValidator, createUdf, dbTimeMillis, deprecated, deprecated, digestMd5, digestSha256, equal, equalName, equals, equals, executeDistributedTasks, filter, flatList, flatList, flatListCopy, generateUuidString, genericArray, getAnnotation, getDimensionCube, getErrorMessage, getErrorMessage, getExecutorService, getExecutorService, getExecutorService, getFirstDescendantOnLevel, getMatchingCause, getMemberOrdinalInParent, getMemoryInfo, getScheduledExecutorService, hash, hash, hashArray, identityFunctor, implode, intersect, isBlank, isEmpty, isNull, isSorted, isValidProperty, lookup, lookup, lookup, lookup, lookup, lookupCompound, lookupCompound, lookupHierarchyLevel, lookupHierarchyRootMember, lookupHierarchyRootMember, lookupProperty, makeBigDecimalFromDouble, makeFqName, makeFqName, makeFqName, maskVersion, matches, mdxEncodeString, needToImplement, newElementNotFoundException, newError, newError, newIdentityHashSet, newIdentityHashSetFake, newInternal, newInternal, newTimer, nonDbTimeMillis, normalizeName, parseCommaList, parseConnectString, parseIdentifier, parseLocale, printMemory, printMemory, quoteForMdx, quoteForMdx, quoteJavaString, quoteMdxIdentifier, quoteMdxIdentifier, quoteMdxIdentifier, quoteMdxIdentifier, quotePattern, readFully, readFully, readURL, readURL, readURL, readVirtualFile, readVirtualFileAsString, replace, replace, replaceProperties, safeGet, singleQuoteString, singleQuoteString, sort, sort, threadLocalRemove, toMap, toOlap4j, toOlap4j, toOlap4j, toURL, trueFunctor, unexpected, uniquify, unparse, unparse, wildcardToRegexp

Methods inherited from class org.eigenbase.xom.XOMUtil

addChild, addChild, addChildren, addElement, concatenate, createDefaultParser, discard, discard, discard, discard, discard, discard, discard, discard, discard, getFirstInstance, wrapperToXml

Methods inherited from class org.eigenbase.xom.XMLUtil

getFirstTagName, printAtt, printAtt, printAtt, printAtt, printPCDATA, printPCDATA, printPCDATA, quoteAtt, quoteAtt, quoteAtt, quoteAtt, quotePCDATA, stringEncodeXML, stringHasXMLSpecials

Methods inherited from class java.lang.Object

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

Field Detail

parameterName

public final String parameterName

exp

public final Exp exp

parameterDescription

public final String parameterDescription

Constructor Detail

ParameterFunDef

ParameterFunDef(FunDef funDef,
                String parameterName,
                Type type,
                int returnCategory,
                Exp exp,
                String description)

Method Detail

createCall

public Exp createCall(Validator validator,
                      Exp[] args)

Description copied from interface: FunDef

Creates an expression which represents a call to this function with a given set of arguments. The result is usually a ResolvedFunCall but not always.

Specified by:

createCall in interface FunDef

Overrides:

createCall in class FunDefBase

getResultType

public Type getResultType(Validator validator,
                          Exp[] args)

Description copied from class: FunDefBase

Returns the type of a call to this function with a given set of arguments.

The default implementation makes the coarse assumption that the return type is in some way related to the type of the first argument. Operators whose arguments don't follow the requirements of this implementation should override this method.

If the function definition says it returns a literal type (numeric, string, symbol) then it's a fair guess that the function call returns the same kind of value.

If the function definition says it returns an object type (cube, dimension, hierarchy, level, member) then we check the first argument of the function. Suppose that the function definition says that it returns a hierarchy, and the first argument of the function happens to be a member. Then it's reasonable to assume that this function returns a member.

Overrides:

getResultType in class FunDefBase

Parameters:

validator - Validator

args - Arguments to the call to this operator

Returns:

result type of a call this function

getParameterName

public static String getParameterName(Exp[] args)

getParameterType

public static Type getParameterType(Exp[] args)

Returns an approximate type for a parameter, based upon the 1'th argument. Does not use the default value expression, so this method can safely be used before the expression has been validated.