Package org.ow2.authzforce.core.pdp.api.func

Class BaseFirstOrderFunctionCall.EagerSinglePrimitiveTypeEval<RETURN_T extends Value,PARAM_T extends AttributeValue>

java.lang.Object

org.ow2.authzforce.core.pdp.api.func.BaseFirstOrderFunctionCall<RETURN_T>

org.ow2.authzforce.core.pdp.api.func.BaseFirstOrderFunctionCall.EagerEval<RETURN_T>

org.ow2.authzforce.core.pdp.api.func.BaseFirstOrderFunctionCall.EagerSinglePrimitiveTypeEval<RETURN_T,PARAM_T>

Type Parameters:

RETURN_T - function return type

PARAM_T - arg values' common (super)type. If argument expressions return different data-types, the common concrete supertype of all may be specified.

All Implemented Interfaces:

FirstOrderFunctionCall<RETURN_T>, FunctionCall<RETURN_T>

Enclosing class:

BaseFirstOrderFunctionCall<RETURN extends Value>

public abstract static class BaseFirstOrderFunctionCall.EagerSinglePrimitiveTypeEval<RETURN_T extends Value,PARAM_T extends AttributeValue>
extends BaseFirstOrderFunctionCall.EagerEval<RETURN_T>

Function call, for functions requiring eager (a.k.a. greedy) evaluation of ALL their arguments' expressions to actual values, before the function can be evaluated. All arguments must be primitive values and have the same primitive datatype.

Nested Class Summary

Nested classes/interfaces inherited from class org.ow2.authzforce.core.pdp.api.func.BaseFirstOrderFunctionCall

BaseFirstOrderFunctionCall.EagerBagEval<RETURN_T extends Value,PARAM_BAG_ELEMENT_T extends AttributeValue>, BaseFirstOrderFunctionCall.EagerEval<RETURN_T extends Value>, BaseFirstOrderFunctionCall.EagerMultiPrimitiveTypeEval<RETURN_T extends Value>, BaseFirstOrderFunctionCall.EagerPartlyBagEval<RETURN_T extends Value,PRIMITIVE_PARAM_T extends AttributeValue>, BaseFirstOrderFunctionCall.EagerSinglePrimitiveTypeEval<RETURN_T extends Value,PARAM_T extends AttributeValue>

Field Summary

Fields inherited from class org.ow2.authzforce.core.pdp.api.func.BaseFirstOrderFunctionCall.EagerEval

argExpressions, indeterminateArgMessage, numOfSameTypePrimitiveParamsBeforeBag, totalArgCount

Fields inherited from class org.ow2.authzforce.core.pdp.api.func.BaseFirstOrderFunctionCall

funcId

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	EagerSinglePrimitiveTypeEval(SingleParameterTypedFirstOrderFunctionSignature<RETURN_T,PARAM_T> functionSig, List<Expression<?>> args, Datatype<?>... remainingArgTypes)	Instantiates Function call

Method Summary

Modifier and Type	Method	Description
protected abstract RETURN_T	evaluate(Deque<PARAM_T> argStack)	Make the call with attribute values as arguments.
RETURN_T	evaluate(EvaluationContext context, Optional<EvaluationContext> mdpContext, AttributeValue... remainingArgs)	Make the call in a given evaluation context and argument values resolved at evaluation time.

Methods inherited from class org.ow2.authzforce.core.pdp.api.func.BaseFirstOrderFunctionCall

evaluate, evaluate, getReturnType

Methods inherited from class java.lang.Object

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

Constructor Detail

EagerSinglePrimitiveTypeEval

protected EagerSinglePrimitiveTypeEval(SingleParameterTypedFirstOrderFunctionSignature<RETURN_T,PARAM_T> functionSig,
                                       List<Expression<?>> args,
                                       Datatype<?>... remainingArgTypes)
                                throws IllegalArgumentException

Instantiates Function call

Parameters:

functionSig - function signature

args - arguments' Expressions

remainingArgTypes - types of arguments following args, and of which the actual Expression is unknown at this point, but will be known and passed at evaluation time as remainingArgs parameter to BaseFirstOrderFunctionCall.evaluate(EvaluationContext, Optional, boolean, AttributeValue...), then evaluate(EvaluationContext, Optional, AttributeValue...).

Throws:

IllegalArgumentException - if one of remainingArgTypes is a bag type.

Method Detail

evaluate

protected abstract RETURN_T evaluate(Deque<PARAM_T> argStack)
                              throws IndeterminateEvaluationException

Make the call with attribute values as arguments. (The pre-evaluation of argument expressions in the evaluation context is already handled internally by this class.)

Parameters:

argStack - function arguments

Returns:

result of the call

Throws:

IndeterminateEvaluationException - if any error evaluating the function

evaluate

public final RETURN_T evaluate(EvaluationContext context,
                               Optional<EvaluationContext> mdpContext,
                               AttributeValue... remainingArgs)
                        throws IndeterminateEvaluationException

Description copied from interface: FirstOrderFunctionCall

Make the call in a given evaluation context and argument values resolved at evaluation time. This method is called by FirstOrderFunctionCall.evaluate(EvaluationContext, Optional, boolean, AttributeValue...) after checking evaluation-time args.

Parameters:

context - Individual Decision evaluation context

mdpContext - the context of the Multiple Decision request that the context belongs to if the Multiple Decision Profile is used

remainingArgs - remaining args (not yet known at initialization time). Null if none. Only non-bag/primitive values are valid remainingArgs to prevent varargs warning (potential heap pollution via varargs parameter) that would be caused by using a parameterized type such as Value/Collection to represent both bags and primitives.

Returns:

result of the call

Throws:

IndeterminateEvaluationException - if any error evaluating the function